gitter-badger/cloudremoting

CloudRemoting PowerShell module

CloudRemoting PowerShell module

CloudRemoting module provides an easy and scriptable way to connect to EC2, Azure or to other machines via RDP or PSRemoting sessions on top of the standard cmdlets by:

• Seamless EC2 Administrator Credential decryption for RDP and PSRemoting
• Credential pass-through for RDP Sessions

Installation

CloudRemoting is available via PowerShellGallery and via PsGet, so you can simply install it with the following command:

# Install it from PowerShellGallery / PsGet repos
Install-Module CloudRemoting

# Or install it from this repository
Install-Module -ModuleUrl https://github.com/murati-hu/CloudRemoting/archive/latest.zip

Of course you can download and install the module manually too from Downloads

Usage

Import-Module CloudRemoting

Few Examples

Enter an EC2 Admin RDP Session with Private-Key file

You can use the Enter-EC2RdpSession cmdlet or its ec2rdp alias to connect to any EC2 instance as an administrator via RDP.

Get-Ec2Instance i-2492acfc | Enter-EC2RdpSession -PemFile '~/.ssh/myprivatekey.pem'

Open EC2 Admin PSSessions with Private-Key

Similarly to the native PSSession cmdlets, you can use the New-EC2PSSession and Enter-EC2RdpSession commands to create or enter to any EC2 PSSession as an administrator:

# Enter to a single EC2 PSSession
Get-Ec2Instance i-2492acfc | Enter-EC2PSSession -PemFile '~/.ssh/myprivatekey.pem'

# Create multiple EC2 PSSessions for further operations
Get-Ec2Instance -Filter @{name='tag:env'; value='demo'} | New-EC2PSSession -PemFile '~/.ssh/myprivatekey.pem'

Please note that all EC2 cmdlets rely on the official AWSPowershell module. It expects the module to be installed with valid AWS credentials setup.

RemoteDesktop to any machine

In order to connect to any machine via RDP, you can simply call Enter-RdpSession cmdlet or its rdp alias.

# Connect an RDP Session to any machine
$c = Get-EC2Credential # Or retrieve from a persisted creds
Enter-RdpSession -ComputerName '207.47.222.251' -Credential $c

Documentation

Cmdlets and functions for CloudRemoting have their own help PowerShell help, which you can read with help <cmdlet-name>.

Versioning

CloudRemoting aims to adhere to Semantic Versioning 2.0.0.

Issues

In case of any issues, raise an issue ticket in this repository and/or feel free to contribute to this project if you have a possible fix for it.

Development

• Source hosted at Github.com
• Report issues/questions/feature requests on Github Issues

Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:

1. Fork the repo
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Authors

Created and maintained by Akos Murati ([email protected]).

License

Apache License, Version 2.0 (see LICENSE)