Add-EC2.ps1
|
function Add-EC2 { <# .Synopsis Adds an EC2 instance to Amazon Web Services .Description Adds EC2 instances to Amazon Web Services. .Example Add-EC2 -ImageId ami-e31ccb8a #2k8R2 .Example Add-EC2 -ImageId ami-41a37528 #2k8 .Example Add-EC2 -ImageId ami-ddad7bb4 # Server Core .Example Add-Ec2 -ImageId ami-ddad7bb4 -InstanceType m1.medium .Link Get-Ami .Link Get-EC2 #> param( # The AMI ImageID [Parameter(Mandatory=$true,Position=0,ValueFromPipelineByPropertyName=$true)] [string]$ImageId, # The name of the instance [Parameter(ValueFromPipelineByPropertyName=$true,Position=1)] [string]$Name, # The Instance Type (or size) to create. The default is t1.micro [Parameter(ValueFromPipelineByPropertyName=$true)] [ValidateSet("m1.small", "m1.medium", "m1.large", "m1.xlarge", "t1.micro", "m2.xlarge", "m2.2xlarge", "m2.4xlarge", "c1.medium", "c1.xlarge", "cc1.4xlarge", "cc2.8xlarge", "cg1.4xlarge")] [string]$InstanceType = "t1.micro", # The minimum CPU Count [Parameter(ValueFromPipelineByPropertyName=$true)] [Uint32]$MinCPUCount = 1, # The maximum CPU Count [Parameter(ValueFromPipelineByPropertyName=$true)] [Uint32]$MaxCPUCount = 1, # The securityGroup that will contain the EC2 image [Parameter(ValueFromPipelineByPropertyName=$true)] [string]$SecurityGroup = "RemoteDesktop", # If set, returns the created item [Switch]$PassThru ) begin { # Look up the existing instances $existingInstances = Get-EC2 } process { # Look up the existing instances $instanceCountWithThisAMI = @($existingInstances | Where-Object { $_.ImageId -eq $imageId }).Count $instanceCountWithThisAMI = "{0:x}" -f (Get-Random) $riq = (New-Object Amazon.EC2.Model.RunInstancesRequest) if (-not $?) { Write-Error "EC2 c# SDK is not installed" return } if (-not $psBoundParameters.Name) { $name = "EC2_${ImageId}_${instanceCountWithThisAMI}" } if ($psBoundParameters.SecurityGroup) { # They've selected an existing security group, so find it $securityGroupId = Get-EC2SecurityGroup| Where-Object { $_.GroupName -eq $SecurityGroup } | Select-Object -ExpandProperty GroupId } else { # Create a security group on their behalf $securityGroup = "EC2_${ImageId}_${instanceCountWithThisAMI}_SecurityGroup" $securityGroupRequest = (New-Object Amazon.EC2.Model.CreateSecurityGroupRequest).WithGroupName($SecurityGroup) $securityGroupRequest = $securityGroupRequest.WithGroupDescription("SecurityGroup for EC2 ${ImageId}_${instanceCountWithThisAMI}") $securityGroupResult = $AwsConnections.EC2.CreateSecurityGroup($securityGroupRequest) $securityGroupId = $securityGroupResult.CreateSecurityGroupResult.GroupId } $keyPairRequest = (New-Object Amazon.EC2.Model.CreateKeyPairRequest).WithKeyName($name) $keyPairOutput = $AwsConnections.EC2.CreateKeyPair($keyPairRequest) # Store the key material encrypted in the registry, so we can decrypt the password later. Add-SecureSetting -Name $keyPairOutput.CreateKeyPairResult.KeyPair.KeyName -String $keyPairOutput.CreateKeyPairResult.KeyPair.KeyMaterial $riq = $riq.WithInstanceType($InstanceType).WithMaxCount($MaxCPUCount).WithMinCount($MinCPUCount).WithImageId("$ImageId").WithKeyName($name).WithSecurityGroupId($SecurityGroupId) $null = $AwsConnections.EC2.RunInstances($riq) if ($PassThru) { Get-EC2 -Name $name } } } |