Ejemplos de Amazon EC2 con Herramientas para PowerShell V4 - Ejemplos de código de AWS SDK

Hay más ejemplos de AWS SDK disponibles en el repositorio de GitHub de ejemplos de AWS SDK de documentos.

Ejemplos de Amazon EC2 con Herramientas para PowerShell V4

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes usando Herramientas de AWS para PowerShell V4 con Amazon EC2.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2CapacityReservation.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una nueva reserva de capacidad con los atributos especificados.

Add-EC2CapacityReservation -InstanceType m4.xlarge -InstanceCount 2 -AvailabilityZone eu-west-1b -EbsOptimized True -InstancePlatform Windows

Salida:

AvailabilityZone : eu-west-1b AvailableInstanceCount : 2 CapacityReservationId : cr-0c1f2345db6f7cdba CreateDate : 3/28/2019 9:29:41 AM EbsOptimized : True EndDate : 1/1/0001 12:00:00 AM EndDateType : unlimited EphemeralStorage : False InstanceMatchCriteria : open InstancePlatform : Windows InstanceType : m4.xlarge State : active Tags : {} Tenancy : default TotalInstanceCount : 2
  • Para obtener información sobre la API, consulte CreateCapacityReservation en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2InternetGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia la puerta de enlace de Internet especificada a la VPC especificada.

Add-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d -VpcId vpc-12345678

Ejemplo 2: En este ejemplo se crean una VPC y una puerta de enlace de Internet y, a continuación, se asocia la puerta de enlace de Internet a la VPC.

$vpc = New-EC2Vpc -CidrBlock 10.0.0.0/16 New-EC2InternetGateway | Add-EC2InternetGateway -VpcId $vpc.VpcId
  • Para obtener información sobre la API, consulte AttachInternetGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2NetworkInterface.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia la interfaz de red especificada a la instancia especificada.

Add-EC2NetworkInterface -NetworkInterfaceId eni-12345678 -InstanceId i-1a2b3c4d -DeviceIndex 1

Salida:

eni-attach-1a2b3c4d
  • Para obtener información sobre la API, consulte AttachNetworkInterface en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2Volume.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia el volumen especificado a la instancia especificada y se expone con el nombre de dispositivo especificado.

Add-EC2Volume -VolumeId vol-12345678 -InstanceId i-1a2b3c4d -Device /dev/sdh

Salida:

AttachTime : 12/22/2015 1:53:58 AM DeleteOnTermination : False Device : /dev/sdh InstanceId : i-1a2b3c4d State : attaching VolumeId : vol-12345678
  • Para obtener información sobre la API, consulte AttachVolume en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2VpnGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia la puerta de enlace privada virtual especificada a la VPC especificada.

Add-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d -VpcId vpc-12345678

Salida:

State VpcId ----- ----- attaching vpc-12345678
  • Para obtener información sobre la API, consulte AttachVpnGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Approve-EC2VpcPeeringConnection.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se aprueba la solicitud con el VpcPeeringConnectionId pcx-1dfad234b56ff78be

Approve-EC2VpcPeeringConnection -VpcPeeringConnectionId pcx-1dfad234b56ff78be

Salida:

AccepterVpcInfo : Amazon.EC2.Model.VpcPeeringConnectionVpcInfo ExpirationTime : 1/1/0001 12:00:00 AM RequesterVpcInfo : Amazon.EC2.Model.VpcPeeringConnectionVpcInfo Status : Amazon.EC2.Model.VpcPeeringConnectionStateReason Tags : {} VpcPeeringConnectionId : pcx-1dfad234b56ff78be
  • Para obtener información sobre la API, consulte AcceptVpcPeeringConnection en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Confirm-EC2ProductInstance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se determina si el código de producto especificado está asociado a la instancia especificada.

Confirm-EC2ProductInstance -ProductCode 774F4FF8 -InstanceId i-12345678
  • Para obtener información sobre la API, consulte ConfirmProductInstance en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Copy-EC2Image.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se copia la AMI especificada de la región “UE (Irlanda)” en la región “Oeste de EE. UU. (Oregón)”. Si no se especifica -Region, la región predeterminada actual se utiliza como región de destino.

Copy-EC2Image -SourceRegion eu-west-1 -SourceImageId ami-12345678 -Region us-west-2 -Name "Copy of ami-12345678"

Salida:

ami-87654321
  • Para obtener información sobre la API, consulte CopyImage en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Copy-EC2Snapshot.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se copia la instantánea especificada de la región “UE (Irlanda)” en la región “Oeste de EE. UU. (Oregón)”.

Copy-EC2Snapshot -SourceRegion eu-west-1 -SourceSnapshotId snap-12345678 -Region us-west-2

Ejemplo 2: Si establece una región predeterminada y omite el parámetro Region, la región de destino predeterminada será la región predeterminada.

Set-DefaultAWSRegion us-west-2 Copy-EC2Snapshot -SourceRegion eu-west-1 -SourceSnapshotId snap-12345678
  • Para obtener información sobre la API, consulte CopySnapshot en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Deny-EC2VpcPeeringConnection.

Herramientas para PowerShell V4

Ejemplo 1: En el ejemplo anterior se deniega la solicitud del identificador de solicitud de VpcPeering pcx-01a2b3ce45fe67eb8.

Deny-EC2VpcPeeringConnection -VpcPeeringConnectionId pcx-01a2b3ce45fe67eb8
  • Para obtener información sobre la API, consulte RejectVpcPeeringConnection en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Disable-EC2VgwRoutePropagation.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo impide que el VGW propague automáticamente las rutas a la tabla de enrutamiento especificada.

Disable-EC2VgwRoutePropagation -RouteTableId rtb-12345678 -GatewayId vgw-1a2b3c4d
  • Para obtener información sobre la API, consulte DisableVgwRoutePropagation en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Disable-EC2VpcClassicLink.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se deshabilita EC2VpcClassicLink para vpc-01e23c4a5d6db78e9. Devuelve True o False.

Disable-EC2VpcClassicLink -VpcId vpc-01e23c4a5d6db78e9
  • Para obtener información sobre la API, consulte DisableVpcClassicLink en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Disable-EC2VpcClassicLinkDnsSupport.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se deshabilita la compatibilidad con DNS de ClassicLink para vpc-0b12d3456a7e8910d.

Disable-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d
  • Para obtener información sobre la API, consulte DisableVpcClassicLinkDnsSupport en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Dismount-EC2InternetGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se desvincula la puerta de enlace de Internet especificada a la VPC específica.

Dismount-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d -VpcId vpc-12345678
  • Para obtener información sobre la API, consulte DetachInternetGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Dismount-EC2NetworkInterface.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la conexión especificada entre una interfaz de red y una instancia.

Dismount-EC2NetworkInterface -AttachmentId eni-attach-1a2b3c4d -Force
  • Para obtener información sobre la API, consulte DetachNetworkInterface en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Dismount-EC2Volume.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se desconecta el volumen especificado.

Dismount-EC2Volume -VolumeId vol-12345678

Salida:

AttachTime : 12/22/2015 1:53:58 AM DeleteOnTermination : False Device : /dev/sdh InstanceId : i-1a2b3c4d State : detaching VolumeId : vol-12345678

Ejemplo 2: También puede especificar el ID de la instancia y el nombre del dispositivo para asegurarse de que está desconectando el volumen correcto.

Dismount-EC2Volume -VolumeId vol-12345678 -InstanceId i-1a2b3c4d -Device /dev/sdh
  • Para obtener información sobre la API, consulte DetachVolume en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Dismount-EC2VpnGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se desvincula la puerta de enlace privada virtual especificada de la VPC especificada.

Dismount-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d -VpcId vpc-12345678
  • Para obtener información sobre la API, consulte DetachVpnGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2CapacityReservation.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se modifica el valor de CapacityReservationId cr-0c1f2345db6f7cdba cambiando el número de instancias a 1.

Edit-EC2CapacityReservation -CapacityReservationId cr-0c1f2345db6f7cdba -InstanceCount 1

Salida:

True
  • Para obtener información sobre la API, consulte ModifyCapacityReservation en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2Host.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se modifica la configuración de AutoPlacement a desactivada para el host dedicado h-01e23f4cd567890f3.

Edit-EC2Host -HostId h-03e09f8cd681609f3 -AutoPlacement off

Salida:

Successful Unsuccessful ---------- ------------ {h-01e23f4cd567890f3} {}
  • Para obtener información sobre la API, consulte ModifyHosts en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2IdFormat.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se habilita el formato de ID largo para el recurso especificado.

Edit-EC2IdFormat -Resource instance -UseLongId $true

Ejemplo 2: En este ejemplo se deshabilita el formato de ID largo para el recurso especificado.

Edit-EC2IdFormat -Resource instance -UseLongId $false
  • Para obtener información sobre la API, consulte ModifyIdFormat en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2ImageAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se actualiza la descripción de la AMI especificada.

Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"

Ejemplo 2: En este ejemplo se hace pública la AMI (por ejemplo, para que cualquier Cuenta de AWS pueda utilizarla).

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all

Ejemplo 3: En este ejemplo se hace privada la AMI (por ejemplo, para que solo usted, como propietario, pueda utilizarla).

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all

Ejemplo 4: En este ejemplo se conceden permisos de lanzamiento a la Cuenta de AWS especificada.

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333

Ejemplo 5: En este ejemplo se elimina el permiso de lanzamiento de la Cuenta de AWS especificada.

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333
  • Para obtener información sobre la API, consulte ModifyImageAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2InstanceAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se modifica el tipo de instancia de la instancia especificada.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.medium

Ejemplo 2: Este ejemplo permite usar la conexión en red mejorada para la instancia especificada, especificando “simple” como el valor del parámetro de compatibilidad de red de virtualización de E/S de raíz única (SR-IOV), -SriovNetSupport.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple"

Ejemplo 3: En este ejemplo se modifican los grupos de seguridad para la instancia especificada. La instancia debe encontrarse en una VPC. Debe especificar el ID de cada grupo de seguridad, no su nombre.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" )

Ejemplo 4: En este ejemplo se permite la optimización de E/S de EBS para la instancia especificada. Esta característica no está disponible con todos los tipos de instancia. Se aplicarán cargos por uso adicionales al utilizar una instancia optimizada para EBS.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $true

Ejemplo 5: En este ejemplo se habilita la comprobación de origen/destino de la instancia especificada. Para que una instancia de NAT se ejecute, el valor debe ser “false”.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $true

Ejemplo 6: En este ejemplo se deshabilita la terminación de la instancia especificada.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $true

Ejemplo 7: En este ejemplo se cambia la instancia especificada para que termine cuando se inicie el cierre desde la instancia.

Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate
  • Para obtener información sobre la API, consulte ModifyInstanceAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2InstanceCreditSpecification.

Herramientas para PowerShell V4

Ejemplo 1: Esto habilita créditos ilimitados de T2, por ejemplo, i-01234567890abcdef.

$Credit = New-Object -TypeName Amazon.EC2.Model.InstanceCreditSpecificationRequest $Credit.InstanceId = "i-01234567890abcdef" $Credit.CpuCredits = "unlimited" Edit-EC2InstanceCreditSpecification -InstanceCreditSpecification $Credit

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2NetworkInterfaceAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se modifica la interfaz de red especificada para que la conexión especificada se elimine al terminar.

Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -Attachment_AttachmentId eni-attach-1a2b3c4d -Attachment_DeleteOnTermination $true

Ejemplo 2: En este ejemplo se modifica la descripción de la interfaz de red especificada.

Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -Description "my description"

Ejemplo 3: En este ejemplo se modifica el grupo de seguridad de la interfaz de red especificada.

Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -Groups sg-1a2b3c4d

Ejemplo 4: En este ejemplo se deshabilita la comprobación de origen/destino de la interfaz de red especificada.

Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -SourceDestCheck $false
  • Para obtener información sobre la API, consulte ModifyNetworkInterfaceAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2ReservedInstance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se modifica la zona de disponibilidad, el número de instancias y la plataforma de las instancias reservadas especificadas.

$config = New-Object Amazon.EC2.Model.ReservedInstancesConfiguration $config.AvailabilityZone = "us-west-2a" $config.InstanceCount = 1 $config.Platform = "EC2-VPC" Edit-EC2ReservedInstance ` -ReservedInstancesId @("FE32132D-70D5-4795-B400-AE435EXAMPLE", "0CC556F3-7AB8-4C00-B0E5-98666EXAMPLE") ` -TargetConfiguration $config
  • Para obtener información sobre la API, consulte ModifyReservedInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2SnapshotAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se hace pública la instantánea especificada estableciendo su atributo CreateVolumePermission.

Edit-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission -OperationType Add -GroupName all
  • Para obtener información sobre la API, consulte ModifySnapshotAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2SpotFleetRequest.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se actualiza la capacidad de destino de la solicitud de flota de spot especificada.

Edit-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -TargetCapacity 10

Salida:

True
  • Para obtener información sobre la API, consulte ModifySpotFleetRequest en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2SubnetAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se habilita el direccionamiento IP público para la subred especificada.

Edit-EC2SubnetAttribute -SubnetId subnet-1a2b3c4d -MapPublicIpOnLaunch $true

Ejemplo 2: En este ejemplo se deshabilita el direccionamiento IP público para la subred especificada.

Edit-EC2SubnetAttribute -SubnetId subnet-1a2b3c4d -MapPublicIpOnLaunch $false
  • Para obtener información sobre la API, consulte ModifySubnetAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2VolumeAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se modifica el atributo especificado del volumen especificado. Las operaciones de E/S del volumen se reanudan automáticamente tras la suspensión debido a la posible incoherencia de los datos.

Edit-EC2VolumeAttribute -VolumeId vol-12345678 -AutoEnableIO $true
  • Para obtener información sobre la API, consulte ModifyVolumeAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2VpcAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se habilita la compatibilidad con los nombres de host DNS para la VPC especificada.

Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsHostnames $true

Ejemplo 2: En este ejemplo se deshabilita la compatibilidad con los nombres de host DNS para la VPC especificada.

Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsHostnames $false

Ejemplo 3: En este ejemplo se habilita la compatibilidad con la resolución DNS para la VPC especificada.

Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsSupport $true

Ejemplo 4: En este ejemplo se deshabilita la compatibilidad con la resolución DNS para la VPC especificada.

Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsSupport $false
  • Para obtener información sobre la API, consulte ModifyVpcAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Enable-EC2VgwRoutePropagation.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo impide que el VGW especificado propague automáticamente las rutas a la tabla de enrutamiento especificada.

Enable-EC2VgwRoutePropagation -RouteTableId rtb-12345678 -GatewayId vgw-1a2b3c4d
  • Para obtener información sobre la API, consulte EnableVgwRoutePropagation en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Enable-EC2VolumeIO.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo habilita las operaciones de E/S para el volumen especificado, si las operaciones de E/S estaban deshabilitadas.

Enable-EC2VolumeIO -VolumeId vol-12345678
  • Para obtener información sobre la API, consulte EnableVolumeIo en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Enable-EC2VpcClassicLink.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo habilita la VPC vpc-0123456b789b0d12f para ClassicLink.

Enable-EC2VpcClassicLink -VpcId vpc-0123456b789b0d12f

Salida:

True
  • Para obtener información sobre la API, consulte EnableVpcClassicLink en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Enable-EC2VpcClassicLinkDnsSupport.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo permite que vpc-0b12d3456a7e8910d admita la resolución de nombres de host DNS para ClassicLink.

Enable-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d -Region eu-west-1
  • Para obtener información sobre la API, consulte EnableVpcClassicLinkDnsSupport en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2AccountAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe si se pueden lanzar instancias en EC2-Classic y EC2-VPC en la región o solo en EC2-VPC.

(Get-EC2AccountAttribute -AttributeName supported-platforms).AttributeValues

Salida:

AttributeValue -------------- EC2 VPC

Ejemplo 2: En este ejemplo se describe la VPC predeterminada; es “none” si no tiene una VPC predeterminada en la región.

(Get-EC2AccountAttribute -AttributeName default-vpc).AttributeValues

Salida:

AttributeValue -------------- vpc-12345678

Ejemplo 3: En este ejemplo se describe el número máximo de instancias bajo demanda que puede ejecutar.

(Get-EC2AccountAttribute -AttributeName max-instances).AttributeValues

Salida:

AttributeValue -------------- 20
  • Para obtener información sobre la API, consulte DescribeAccountAttributes en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Address.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la dirección IP elástica especificada para las instancias de EC2-Classic.

Get-EC2Address -AllocationId eipalloc-12345678

Salida:

AllocationId : eipalloc-12345678 AssociationId : eipassoc-12345678 Domain : vpc InstanceId : i-87654321 NetworkInterfaceId : eni-12345678 NetworkInterfaceOwnerId : 12345678 PrivateIpAddress : 10.0.2.172 PublicIp : 198.51.100.2

Ejemplo 2: En este ejemplo se describen las direcciones IP elásticas para las instancias de una VPC. La sintaxis requiere la versión 3 o posterior de PowerShell.

Get-EC2Address -Filter @{ Name="domain";Values="vpc" }

Ejemplo 3: En este ejemplo se describe la dirección IP elástica especificada para las instancias de EC2-Classic.

Get-EC2Address -PublicIp 203.0.113.17

Salida:

AllocationId : AssociationId : Domain : standard InstanceId : i-12345678 NetworkInterfaceId : NetworkInterfaceOwnerId : PrivateIpAddress : PublicIp : 203.0.113.17

Ejemplo 4: En este ejemplo se describen las direcciones IP elásticas para las instancias de EC2-Classic. La sintaxis requiere la versión 3 o posterior de PowerShell.

Get-EC2Address -Filter @{ Name="domain";Values="standard" }

Ejemplo 5: En este ejemplo se describen todas las direcciones IP elásticas.

Get-EC2Address

Ejemplo 6: En este ejemplo se devuelve la IP pública y privada del identificador de instancia proporcionado en el filtro.

Get-EC2Address -Region eu-west-1 -Filter @{Name="instance-id";Values="i-0c12d3f4f567ffb89"} | Select-Object PrivateIpAddress, PublicIp

Salida:

PrivateIpAddress PublicIp ---------------- -------- 10.0.0.99 63.36.5.227

Ejemplo 7: En este ejemplo se recuperan todas las IP elásticas con su identificador de asignación, identificador de asociación e identificador de instancia.

Get-EC2Address -Region eu-west-1 | Select-Object InstanceId, AssociationId, AllocationId, PublicIp

Salida:

InstanceId AssociationId AllocationId PublicIp ---------- ------------- ------------ -------- eipalloc-012e3b456789e1fad 17.212.120.178 i-0c123dfd3415bac67 eipassoc-0e123456bb7890bdb eipalloc-01cd23ebf45f7890c 17.212.124.77 eipalloc-012345678eeabcfad 17.212.225.7 i-0123d405c67e89a0c eipassoc-0c123b456783966ba eipalloc-0123cdd456a8f7892 37.216.52.173 i-0f1bf2f34c5678d09 eipassoc-0e12934568a952d96 eipalloc-0e1c23e4d5e6789e4 37.218.222.278 i-012e3cb4df567e8aa eipassoc-0d1b2fa4d67d03810 eipalloc-0123f456f78a01b58 37.210.82.27 i-0123bcf4b567890e1 eipassoc-01d2345f678903fb1 eipalloc-0e1db23cfef5c45c7 37.215.222.270

Ejemplo 8: En este ejemplo se obtiene la lista de direcciones IP de EC2 que coinciden con la clave de etiqueta “Category” con el valor “Prod”.

Get-EC2Address -Filter @{Name="tag:Category";Values="Prod"}

Salida:

AllocationId : eipalloc-0123f456f81a01b58 AssociationId : eipassoc-0d1b23a456d103810 CustomerOwnedIp : CustomerOwnedIpv4Pool : Domain : vpc InstanceId : i-012e3cb4df567e1aa NetworkBorderGroup : eu-west-1 NetworkInterfaceId : eni-0123f41d5a60d5f40 NetworkInterfaceOwnerId : 123456789012 PrivateIpAddress : 192.168.1.84 PublicIp : 34.250.81.29 PublicIpv4Pool : amazon Tags : {Category, Name}
  • Para obtener información sobre la API, consulte DescribeAddresses en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2AvailabilityZone.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describen las zonas de disponibilidad de la región actual que están disponibles.

Get-EC2AvailabilityZone

Salida:

Messages RegionName State ZoneName -------- ---------- ----- -------- {} us-west-2 available us-west-2a {} us-west-2 available us-west-2b {} us-west-2 available us-west-2c

Ejemplo 2: En este ejemplo se describe cualquier zona de disponibilidad que se encuentre en un estado dañado. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

Get-EC2AvailabilityZone -Filter @{ Name="state";Values="impaired" }

Ejemplo 3: Con la versión 2 de PowerShell, debe usar New-Object para crear cada filtro.

$filter = New-Object Amazon.EC2.Model.Filter $filter.Name = "state" $filter.Values = "impaired" Get-EC2AvailabilityZone -Filter $filter
  • Para obtener información sobre la API, consulte DescribeAvailabilityZones en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2BundleTask.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la tarea de agrupación especificada.

Get-EC2BundleTask -BundleId bun-12345678

Ejemplo 2: En este ejemplo se describen las tareas del agrupación cuyo estado es “completado” o “con error”.

$filter = New-Object Amazon.EC2.Model.Filter $filter.Name = "state" $filter.Values = @( "complete", "failed" ) Get-EC2BundleTask -Filter $filter
  • Para obtener información sobre la API, consulte DescribeBundleTasks en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2CapacityReservation.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe una o varias de sus reservas de capacidad para la región.

Get-EC2CapacityReservation -Region eu-west-1

Salida:

AvailabilityZone : eu-west-1b AvailableInstanceCount : 2 CapacityReservationId : cr-0c1f2345db6f7cdba CreateDate : 3/28/2019 9:29:41 AM EbsOptimized : True EndDate : 1/1/0001 12:00:00 AM EndDateType : unlimited EphemeralStorage : False InstanceMatchCriteria : open InstancePlatform : Windows InstanceType : m4.xlarge State : active Tags : {} Tenancy : default TotalInstanceCount : 2
  • Para obtener información sobre la API, consulte DescribeCapacityReservations en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ConsoleOutput.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtiene la salida de la consola para la instancia de Linux especificada. La salida de la consola está codificada.

Get-EC2ConsoleOutput -InstanceId i-0e19abcd47c123456

Salida:

InstanceId Output ---------- ------ i-0e194d3c47c123637 WyAgICAwLjAwMDAwMF0gQ29tbW...bGU9dHR5UzAgc2Vs

Ejemplo 2: Este ejemplo almacena la salida de la consola codificada en una variable y, a continuación, la descodifica.

$Output_encoded = (Get-EC2ConsoleOutput -InstanceId i-0e19abcd47c123456).Output [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($Output_encoded))
  • Para obtener información sobre la API, consulte GetConsoleOutput en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2CustomerGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la puerta de enlace de cliente especificada.

Get-EC2CustomerGateway -CustomerGatewayId cgw-1a2b3c4d

Salida:

BgpAsn : 65534 CustomerGatewayId : cgw-1a2b3c4d IpAddress : 203.0.113.12 State : available Tags : {} Type : ipsec.1

Ejemplo 2: En este ejemplo se describen todas las puertas de enlace de cliente cuyo estado sea pendiente o disponible.

$filter = New-Object Amazon.EC2.Model.Filter $filter.Name = "state" $filter.Values = @( "pending", "available" ) Get-EC2CustomerGateway -Filter $filter

Ejemplo 3: En este ejemplo se describen sus puertas de enlace de cliente.

Get-EC2CustomerGateway
  • Para obtener información sobre la API, consulte DescribeCustomerGateways en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2DhcpOption.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se muestran los conjuntos de opciones de DHCP.

Get-EC2DhcpOption

Salida:

DhcpConfigurations DhcpOptionsId Tag ------------------ ------------- --- {domain-name, domain-name-servers} dopt-1a2b3c4d {} {domain-name, domain-name-servers} dopt-2a3b4c5d {} {domain-name-servers} dopt-3a4b5c6d {}

Ejemplo 2: En este ejemplo se obtienen los detalles de configuración del conjunto de opciones de DHCP especificado.

(Get-EC2DhcpOption -DhcpOptionsId dopt-1a2b3c4d).DhcpConfigurations

Salida:

Key Values --- ------ domain-name {abc.local} domain-name-servers {10.0.0.101, 10.0.0.102}
  • Para obtener información sobre la API, consulte DescribeDhcpOptions en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2FlowLog.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describen uno o más registros de flujo con el tipo de destino de registro “s3”.

Get-EC2FlowLog -Filter @{Name="log-destination-type";Values="s3"}

Salida:

CreationTime : 2/25/2019 9:07:36 PM DeliverLogsErrorMessage : DeliverLogsPermissionArn : DeliverLogsStatus : SUCCESS FlowLogId : fl-01b2e3d45f67f8901 FlowLogStatus : ACTIVE LogDestination : arn:aws:s3:::amzn-s3-demo-bucket-dd-tata LogDestinationType : s3 LogGroupName : ResourceId : eni-01d2dda3456b7e890 TrafficType : ALL
  • Para obtener información sobre la API, consulte DescribeFlowLogs en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Host.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se devuelven los detalles del host de EC2.

Get-EC2Host

Salida:

AllocationTime : 3/23/2019 4:55:22 PM AutoPlacement : off AvailabilityZone : eu-west-1b AvailableCapacity : Amazon.EC2.Model.AvailableCapacity ClientToken : HostId : h-01e23f4cd567890f1 HostProperties : Amazon.EC2.Model.HostProperties HostReservationId : Instances : {} ReleaseTime : 1/1/0001 12:00:00 AM State : available Tags : {}

Ejemplo 2: En este ejemplo se consulta el valor de AvailableInstanceCapacity para el host h-01e23f4cd567899f1.

Get-EC2Host -HostId h-01e23f4cd567899f1 | Select-Object -ExpandProperty AvailableCapacity | Select-Object -expand AvailableInstanceCapacity

Salida:

AvailableCapacity InstanceType TotalCapacity ----------------- ------------ ------------- 11 m4.xlarge 11
  • Para obtener información sobre la API, consulte DescribeHosts en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2HostReservationOffering.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describen las reservas de hosts dedicados que se pueden adquirir para el filtro “instance-family'” especificado, donde PaymentOption es “NoUpfront”.

Get-EC2HostReservationOffering -Filter @{Name="instance-family";Values="m4"} | Where-Object PaymentOption -eq NoUpfront

Salida:

CurrencyCode : Duration : 94608000 HourlyPrice : 1.307 InstanceFamily : m4 OfferingId : hro-0c1f234567890d9ab PaymentOption : NoUpfront UpfrontPrice : 0.000 CurrencyCode : Duration : 31536000 HourlyPrice : 1.830 InstanceFamily : m4 OfferingId : hro-04ad12aaaf34b5a67 PaymentOption : NoUpfront UpfrontPrice : 0.000

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2HostReservationPurchasePreview.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtiene una vista previa de una compra de reserva con configuraciones que coinciden con las de su host dedicado h-01e23f4cd567890f1.

Get-EC2HostReservationPurchasePreview -OfferingId hro-0c1f23456789d0ab -HostIdSet h-01e23f4cd567890f1

Salida:

CurrencyCode Purchase TotalHourlyPrice TotalUpfrontPrice ------------ -------- ---------------- ----------------- {} 1.307 0.000

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2IdFormat.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el formato de ID del tipo de recurso especificado.

Get-EC2IdFormat -Resource instance

Salida:

Resource UseLongIds -------- ---------- instance False

Ejemplo 2: En este ejemplo se describen los formatos de ID de todos los tipos de recursos que admiten ID más largos.

Get-EC2IdFormat

Salida:

Resource UseLongIds -------- ---------- reservation False instance False
  • Para obtener información sobre la API, consulte DescribeIdFormat en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2IdentityIdFormat.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se devuelve el formato de ID del recurso “image” para el rol especificado.

Get-EC2IdentityIdFormat -PrincipalArn arn:aws:iam::123456789511:role/JDBC -Resource image

Salida:

Deadline Resource UseLongIds -------- -------- ---------- 8/2/2018 11:30:00 PM image True
  • Para obtener información sobre la API, consulte DescribeIdentityIdFormat en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Image.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la AMI especificada.

Get-EC2Image -ImageId ami-12345678

Salida:

Architecture : x86_64 BlockDeviceMappings : {/dev/xvda} CreationDate : 2014-10-20T00:56:28.000Z Description : My image Hypervisor : xen ImageId : ami-12345678 ImageLocation : 123456789012/my-image ImageOwnerAlias : ImageType : machine KernelId : Name : my-image OwnerId : 123456789012 Platform : ProductCodes : {} Public : False RamdiskId : RootDeviceName : /dev/xvda RootDeviceType : ebs SriovNetSupport : simple State : available StateReason : Tags : {Name} VirtualizationType : hvm

Ejemplo 2: En este ejemplo se describen las AMI de su propiedad.

Get-EC2Image -owner self

Ejemplo 3: En este ejemplo se describen las AMI públicas que ejecutan Microsoft Windows Server.

Get-EC2Image -Filter @{ Name="platform"; Values="windows" }

Ejemplo 4: En este ejemplo se describen todas las AMI públicas de la región “us-west-2”.

Get-EC2Image -Region us-west-2
  • Para obtener información sobre la API, consulte DescribeImages en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ImageAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtiene la descripción de la AMI especificada.

Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute description

Salida:

BlockDeviceMappings : {} Description : My image description ImageId : ami-12345678 KernelId : LaunchPermissions : {} ProductCodes : {} RamdiskId : SriovNetSupport :

Ejemplo 2: En este ejemplo se describen los permisos de lanzamiento de la AMI especificada.

Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission

Salida:

BlockDeviceMappings : {} Description : ImageId : ami-12345678 KernelId : LaunchPermissions : {all} ProductCodes : {} RamdiskId : SriovNetSupport :

Ejemplo 3: En este ejemplo se comprueba si las redes mejoradas están habilitadas.

Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute sriovNetSupport

Salida:

BlockDeviceMappings : {} Description : ImageId : ami-12345678 KernelId : LaunchPermissions : {} ProductCodes : {} RamdiskId : SriovNetSupport : simple
  • Para obtener información sobre la API, consulte DescribeImageAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ImageByName.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el conjunto completo de nombres de filtros que se admiten actualmente.

Get-EC2ImageByName

Salida:

WINDOWS_2016_BASE WINDOWS_2016_NANO WINDOWS_2016_CORE WINDOWS_2016_CONTAINER WINDOWS_2016_SQL_SERVER_ENTERPRISE_2016 WINDOWS_2016_SQL_SERVER_STANDARD_2016 WINDOWS_2016_SQL_SERVER_WEB_2016 WINDOWS_2016_SQL_SERVER_EXPRESS_2016 WINDOWS_2012R2_BASE WINDOWS_2012R2_CORE WINDOWS_2012R2_SQL_SERVER_EXPRESS_2016 WINDOWS_2012R2_SQL_SERVER_STANDARD_2016 WINDOWS_2012R2_SQL_SERVER_WEB_2016 WINDOWS_2012R2_SQL_SERVER_EXPRESS_2014 WINDOWS_2012R2_SQL_SERVER_STANDARD_2014 WINDOWS_2012R2_SQL_SERVER_WEB_2014 WINDOWS_2012_BASE WINDOWS_2012_SQL_SERVER_EXPRESS_2014 WINDOWS_2012_SQL_SERVER_STANDARD_2014 WINDOWS_2012_SQL_SERVER_WEB_2014 WINDOWS_2012_SQL_SERVER_EXPRESS_2012 WINDOWS_2012_SQL_SERVER_STANDARD_2012 WINDOWS_2012_SQL_SERVER_WEB_2012 WINDOWS_2012_SQL_SERVER_EXPRESS_2008 WINDOWS_2012_SQL_SERVER_STANDARD_2008 WINDOWS_2012_SQL_SERVER_WEB_2008 WINDOWS_2008R2_BASE WINDOWS_2008R2_SQL_SERVER_EXPRESS_2012 WINDOWS_2008R2_SQL_SERVER_STANDARD_2012 WINDOWS_2008R2_SQL_SERVER_WEB_2012 WINDOWS_2008R2_SQL_SERVER_EXPRESS_2008 WINDOWS_2008R2_SQL_SERVER_STANDARD_2008 WINDOWS_2008R2_SQL_SERVER_WEB_2008 WINDOWS_2008RTM_BASE WINDOWS_2008RTM_SQL_SERVER_EXPRESS_2008 WINDOWS_2008RTM_SQL_SERVER_STANDARD_2008 WINDOWS_2008_BEANSTALK_IIS75 WINDOWS_2012_BEANSTALK_IIS8 VPC_NAT

Ejemplo 2: En este ejemplo se describe la AMI especificada. El uso de este comando para localizar una AMI resulta útil porque AWS publica nuevas AMI de Windows con las actualizaciones más recientes cada mes. Puede especificar 'ImageId' en New-EC2Instance para lanzar una instancia mediante la AMI actual para el filtro especificado.

Get-EC2ImageByName -Names WINDOWS_2016_BASE

Salida:

Architecture : x86_64 BlockDeviceMappings : {/dev/sda1, xvdca, xvdcb, xvdcc...} CreationDate : yyyy.mm.ddThh:mm:ss.000Z Description : Microsoft Windows Server 2016 with Desktop Experience Locale English AMI provided by Amazon Hypervisor : xen ImageId : ami-xxxxxxxx ImageLocation : amazon/Windows_Server-2016-English-Full-Base-yyyy.mm.dd ImageOwnerAlias : amazon ImageType : machine KernelId : Name : Windows_Server-2016-English-Full-Base-yyyy.mm.dd OwnerId : 801119661308 Platform : Windows ProductCodes : {} Public : True RamdiskId : RootDeviceName : /dev/sda1 RootDeviceType : ebs SriovNetSupport : simple State : available StateReason : Tags : {} VirtualizationType : hvm
  • Para obtener información sobre la API, consulte Get-EC2ImageByName en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ImportImageTask.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la tarea de importación de imágenes especificada.

Get-EC2ImportImageTask -ImportTaskId import-ami-hgfedcba

Salida:

Architecture : x86_64 Description : Windows Image 2 Hypervisor : ImageId : ami-1a2b3c4d ImportTaskId : import-ami-hgfedcba LicenseType : AWS Platform : Windows Progress : SnapshotDetails : {/dev/sda1} Status : completed StatusMessage :

Ejemplo 2: En este ejemplo se describen todas las tareas de importación de imágenes.

Get-EC2ImportImageTask

Salida:

Architecture : Description : Windows Image 1 Hypervisor : ImageId : ImportTaskId : import-ami-abcdefgh LicenseType : AWS Platform : Windows Progress : SnapshotDetails : {} Status : deleted StatusMessage : User initiated task cancelation Architecture : x86_64 Description : Windows Image 2 Hypervisor : ImageId : ami-1a2b3c4d ImportTaskId : import-ami-hgfedcba LicenseType : AWS Platform : Windows Progress : SnapshotDetails : {/dev/sda1} Status : completed StatusMessage :
  • Para obtener información sobre la API, consulte DescribeImportImageTasks en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ImportSnapshotTask.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la tarea de importación de instantáneas especificada.

Get-EC2ImportSnapshotTask -ImportTaskId import-snap-abcdefgh

Salida:

Description ImportTaskId SnapshotTaskDetail ----------------- -------------------- ------------------ Disk Image Import 1 import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetail

Ejemplo 2: En este ejemplo se describen todas las tareas de importación de instantáneas.

Get-EC2ImportSnapshotTask

Salida:

Description ImportTaskId SnapshotTaskDetail ----------------- -------------------- ------------------ Disk Image Import 1 import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetail Disk Image Import 2 import-snap-hgfedcba Amazon.EC2.Model.SnapshotTaskDetail
  • Para obtener información sobre la API, consulte DescribeImportSnapshotTasks en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Instance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la instancia especificada.

(Get-EC2Instance -InstanceId i-12345678).Instances

Salida:

AmiLaunchIndex : 0 Architecture : x86_64 BlockDeviceMappings : {/dev/sda1} ClientToken : TleEy1448154045270 EbsOptimized : False Hypervisor : xen IamInstanceProfile : Amazon.EC2.Model.IamInstanceProfile ImageId : ami-12345678 InstanceId : i-12345678 InstanceLifecycle : InstanceType : t2.micro KernelId : KeyName : my-key-pair LaunchTime : 12/4/2015 4:44:40 PM Monitoring : Amazon.EC2.Model.Monitoring NetworkInterfaces : {ip-10-0-2-172.us-west-2.compute.internal} Placement : Amazon.EC2.Model.Placement Platform : Windows PrivateDnsName : ip-10-0-2-172.us-west-2.compute.internal PrivateIpAddress : 10.0.2.172 ProductCodes : {} PublicDnsName : PublicIpAddress : RamdiskId : RootDeviceName : /dev/sda1 RootDeviceType : ebs SecurityGroups : {default} SourceDestCheck : True SpotInstanceRequestId : SriovNetSupport : State : Amazon.EC2.Model.InstanceState StateReason : StateTransitionReason : SubnetId : subnet-12345678 Tags : {Name} VirtualizationType : hvm VpcId : vpc-12345678

Ejemplo 2: En este ejemplo se describen todas las instancias de la región actual, agrupadas por reserva. Para ver los detalles de la instancia, amplíe la colección de instancias dentro de cada objeto de reserva.

Get-EC2Instance

Salida:

GroupNames : {} Groups : {} Instances : {} OwnerId : 123456789012 RequesterId : 226008221399 ReservationId : r-c5df370c GroupNames : {} Groups : {} Instances : {} OwnerId : 123456789012 RequesterId : 854251627541 ReservationId : r-63e65bab ...

Ejemplo 3: Este ejemplo ilustra el uso de un filtro para consultar instancias de EC2 en una subred específica de una VPC.

(Get-EC2Instance -Filter @{Name="vpc-id";Values="vpc-1a2bc34d"},@{Name="subnet-id";Values="subnet-1a2b3c4d"}).Instances

Salida:

InstanceId InstanceType Platform PrivateIpAddress PublicIpAddress SecurityGroups SubnetId VpcId ---------- ------------ -------- ---------------- --------------- -------------- -------- ----- i-01af...82cf180e19 t2.medium Windows 10.0.0.98 ... subnet-1a2b3c4d vpc-1a2b3c4d i-0374...7e9d5b0c45 t2.xlarge Windows 10.0.0.53 ... subnet-1a2b3c4d vpc-1a2b3c4d

Ejemplo 4: Este ejemplo ilustra el uso de un filtro con varios valores para consultar las instancias de EC2 que están en ejecución y detenidas

$InstanceParams = @{ Filter = @( @{'Name' = 'instance-state-name';'Values' = @("running","stopped")} ) } (Get-EC2Instance @InstanceParams).Instances

Salida:

InstanceId InstanceType Platform PrivateIpAddress PublicIpAddress SecurityGroups SubnetId VpcId ---------- ------------ -------- ---------------- --------------- -------------- -------- ----- i-05a9...f6c5f46e18 t3.medium 10.0.1.7 ... subnet-1a2b3c4d vpc-1a2b3c4d i-02cf...945c4fdd07 t3.medium Windows 10.0.1.8 ... subnet-1a2b3c4d vpc-1a2b3c4d i-0ac0...c037f9f3a1 t3.xlarge Windows 10.0.1.10 ... subnet-1a2b3c4d vpc-1a2b3c4d i-066b...57b7b08888 t3.medium Windows 10.0.1.11 ... subnet-1a2b3c4d vpc-1a2b3c4d i-0fee...82e83ccd72 t3.medium Windows 10.0.1.5 ... subnet-1a2b3c4d vpc-1a2b3c4d i-0a68...274cc5043b t3.medium Windows 10.0.1.6 ... subnet-1a2b3c4d vpc-1a2b3c4d

Ejemplo 5: Este ejemplo ilustra el uso de un filtro con varios valores para consultar las instancias de EC2 que están en ejecución y el uso del cmdlet Select-Object para elegir valores específicos en la salida.

$InstanceParams = @{ Filter = @( @{'Name' = 'instance-state-name';'Values' = @("running","stopped")} ) } $SelectParams = @{ Property = @( "InstanceID", "InstanceType", "Platform", "PrivateIpAddress", @{Name="Name";Expression={$_.Tags[$_.Tags.Key.IndexOf("Name")].Value}}, @{Name="State";Expression={$_.State.Name}} ) } $result = Get-EC2Instance @InstanceParams $result.Instances | Select-Object @SelectParams | Format-Table -AutoSize

Salida:

InstanceId InstanceType Platform PrivateIpAddress Name State ---------- ------------ -------- ---------------- ---- ----- i-05a9...f6c5f46e18 t3.medium 10.0.1.7 ec2-name-01 running i-02cf...945c4fdd07 t3.medium Windows 10.0.1.8 ec2-name-02 stopped i-0ac0...c037f9f3a1 t3.xlarge Windows 10.0.1.10 ec2-name-03 running i-066b...57b7b08888 t3.medium Windows 10.0.1.11 ec2-name-04 stopped i-0fee...82e83ccd72 t3.medium Windows 10.0.1.5 ec2-name-05 running i-0a68...274cc5043b t3.medium Windows 10.0.1.6 ec2-name-06 stopped
  • Para obtener información sobre la API, consulte DescribeInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2InstanceAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el tipo de instancia de la instancia especificada.

Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceType

Salida:

InstanceType : t2.micro

Ejemplo 2: En este ejemplo se describe si la conexión en red mejorada está habilitada para la instancia especificada.

Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sriovNetSupport

Salida:

SriovNetSupport : simple

Ejemplo 3: En este ejemplo se describen los grupos de seguridad para la instancia especificada.

(Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute groupSet).Groups

Salida:

GroupId ------- sg-12345678 sg-45678901

Ejemplo 4: En este ejemplo se describe si la optimización de EBS está habilitada para la instancia especificada.

Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute ebsOptimized

Salida:

EbsOptimized : False

Ejemplo 5: En este ejemplo se describe el atributo “disableApiTermination” de la instancia especificada.

Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute disableApiTermination

Salida:

DisableApiTermination : False

Ejemplo 6: En este ejemplo se describe el atributo 'instanceInitiatedShutdownBehavior' de la instancia especificada.

Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceInitiatedShutdownBehavior

Salida:

InstanceInitiatedShutdownBehavior : stop
  • Para obtener información sobre la API, consulte DescribeInstanceAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2InstanceMetadata.

Herramientas para PowerShell V4

Ejemplo 1: Muestra las categorías disponibles de metadatos de instancia que se pueden consultar.

Get-EC2InstanceMetadata -ListCategory

Salida:

AmiId LaunchIndex ManifestPath AncestorAmiId BlockDeviceMapping InstanceId InstanceType LocalHostname LocalIpv4 KernelId AvailabilityZone ProductCode PublicHostname PublicIpv4 PublicKey RamdiskId Region ReservationId SecurityGroup UserData InstanceMonitoring IdentityDocument IdentitySignature IdentityPkcs7

Ejemplo 2: Devuelve el ID de Imagen de máquina de Amazon (AMI) que se utilizó para lanzar la instancia.

Get-EC2InstanceMetadata -Category AmiId

Salida:

ami-b2e756ca

Ejemplo 3: En este ejemplo se consulta el documento de identidad con formato JSON de la instancia.

Get-EC2InstanceMetadata -Category IdentityDocument { "availabilityZone" : "us-west-2a", "devpayProductCodes" : null, "marketplaceProductCodes" : null, "version" : "2017-09-30", "instanceId" : "i-01ed50f7e2607f09e", "billingProducts" : [ "bp-6ba54002" ], "instanceType" : "t2.small", "pendingTime" : "2018-03-07T16:26:04Z", "imageId" : "ami-b2e756ca", "privateIp" : "10.0.0.171", "accountId" : "111122223333", "architecture" : "x86_64", "kernelId" : null, "ramdiskId" : null, "region" : "us-west-2" }

Ejemplo 4: En este ejemplo se utiliza una consulta de ruta para obtener los macs de la interfaz de red de la instancia.

Get-EC2InstanceMetadata -Path "/network/interfaces/macs"

Salida:

02:80:7f:ef:4c:e0/

Ejemplo 5: Si existe un rol de IAM asociado a la instancia, devuelve información acerca de la última vez que se actualizó el perfil de instancia, incluido el valor de LastUpdated, InstanceProfileArn e InstanceProfileId de la instancia.

Get-EC2InstanceMetadata -Path "/iam/info"

Salida:

{ "Code" : "Success", "LastUpdated" : "2018-03-08T03:38:40Z", "InstanceProfileArn" : "arn:aws:iam::111122223333:instance-profile/MyLaunchRole_Profile", "InstanceProfileId" : "AIPAI4...WVK2RW" }
  • Para obtener información sobre la API, consulte Get-EC2InstanceMetadata en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2InstanceStatus.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el estado de la instancia especificada.

Get-EC2InstanceStatus -InstanceId i-12345678

Salida:

AvailabilityZone : us-west-2a Events : {} InstanceId : i-12345678 InstanceState : Amazon.EC2.Model.InstanceState Status : Amazon.EC2.Model.InstanceStatusSummary SystemStatus : Amazon.EC2.Model.InstanceStatusSummary
$status = Get-EC2InstanceStatus -InstanceId i-12345678 $status.InstanceState

Salida:

Code Name ---- ---- 16 running
$status.Status

Salida:

Details Status ------- ------ {reachability} ok
$status.SystemStatus

Salida:

Details Status ------- ------ {reachability} ok
  • Para obtener información sobre la API, consulte DescribeInstanceStatus en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2InternetGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la puerta de enlace de Internet especificada.

Get-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d

Salida:

Attachments InternetGatewayId Tags ----------- ----------------- ---- {vpc-1a2b3c4d} igw-1a2b3c4d {}

Ejemplo 2: En este ejemplo se describen todas las puertas de enlace de Internet.

Get-EC2InternetGateway

Salida:

Attachments InternetGatewayId Tags ----------- ----------------- ---- {vpc-1a2b3c4d} igw-1a2b3c4d {} {} igw-2a3b4c5d {}
  • Para obtener información sobre la API, consulte DescribeInternetGateways en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2KeyPair.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el par de claves especificado.

Get-EC2KeyPair -KeyName my-key-pair

Salida:

KeyFingerprint KeyName -------------- ------- 1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f my-key-pair

Ejemplo 2: En este ejemplo se describen todos los pares de claves.

Get-EC2KeyPair
  • Para obtener información sobre la API, consulte DescribeKeyPairs en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2NetworkAcl.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la ACL de red especificada.

Get-EC2NetworkAcl -NetworkAclId acl-12345678

Salida:

Associations : {aclassoc-1a2b3c4d} Entries : {Amazon.EC2.Model.NetworkAclEntry, Amazon.EC2.Model.NetworkAclEntry} IsDefault : False NetworkAclId : acl-12345678 Tags : {Name} VpcId : vpc-12345678

Ejemplo 2: En este ejemplo se describen las reglas para la ACL de red especificada.

(Get-EC2NetworkAcl -NetworkAclId acl-12345678).Entries

Salida:

CidrBlock : 0.0.0.0/0 Egress : True IcmpTypeCode : PortRange : Protocol : -1 RuleAction : deny RuleNumber : 32767 CidrBlock : 0.0.0.0/0 Egress : False IcmpTypeCode : PortRange : Protocol : -1 RuleAction : deny RuleNumber : 32767

Ejemplo 3: En este ejemplo se describen todas las ACL de red.

Get-EC2NetworkAcl
  • Para obtener información sobre la API, consulte DescribeNetworkAcls en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2NetworkInterface.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la interfaz de red especificada.

Get-EC2NetworkInterface -NetworkInterfaceId eni-12345678

Salida:

Association : Attachment : Amazon.EC2.Model.NetworkInterfaceAttachment AvailabilityZone : us-west-2c Description : Groups : {my-security-group} MacAddress : 0a:e9:a6:19:4c:7f NetworkInterfaceId : eni-12345678 OwnerId : 123456789012 PrivateDnsName : ip-10-0-0-107.us-west-2.compute.internal PrivateIpAddress : 10.0.0.107 PrivateIpAddresses : {ip-10-0-0-107.us-west-2.compute.internal} RequesterId : RequesterManaged : False SourceDestCheck : True Status : in-use SubnetId : subnet-1a2b3c4d TagSet : {} VpcId : vpc-12345678

Ejemplo 2: En este ejemplo se describen todas las interfaces de red.

Get-EC2NetworkInterface
  • Para obtener información sobre la API, consulte DescribeNetworkInterfaces en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2NetworkInterfaceAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la interfaz de red especificada.

Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute Attachment

Salida:

Attachment : Amazon.EC2.Model.NetworkInterfaceAttachment

Ejemplo 2: En este ejemplo se describe la interfaz de red especificada.

Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute Description

Salida:

Description : My description

Ejemplo 3: En este ejemplo se describe la interfaz de red especificada.

Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute GroupSet

Salida:

Groups : {my-security-group}

Ejemplo 4: En este ejemplo se describe la interfaz de red especificada.

Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute SourceDestCheck

Salida:

SourceDestCheck : True

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2PasswordData.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se descifra la contraseña que Amazon EC2 asignó a la cuenta de administrador de la instancia de Windows especificada. Cuando se especificó un archivo pem, se asumió automáticamente la configuración del modificador -Decrypt.

Get-EC2PasswordData -InstanceId i-12345678 -PemFile C:\path\my-key-pair.pem

Salida:

mYZ(PA9?C)Q

Ejemplo 2: (Solo en Windows PowerShell) Inspecciona la instancia para determinar el nombre del par de claves utilizado para lanzar la instancia y, a continuación, intenta buscar los datos del par de claves correspondientes en el almacén de configuración del Kit de herramientas de AWS para Visual Studio. Si se encuentran los datos del par de claves, se descifra la contraseña.

Get-EC2PasswordData -InstanceId i-12345678 -Decrypt

Salida:

mYZ(PA9?C)Q

Ejemplo 3: Devuelve los datos de contraseña cifrados de la instancia.

Get-EC2PasswordData -InstanceId i-12345678

Salida:

iVz3BAK/WAXV.....dqt8WeMA==
  • Para obtener información sobre la API, consulte GetPasswordData en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2PlacementGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el grupo de ubicación especificado.

Get-EC2PlacementGroup -GroupName my-placement-group

Salida:

GroupName State Strategy --------- ----- -------- my-placement-group available cluster
  • Para obtener información sobre la API, consulte DescribePlacementGroups en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2PrefixList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtienen los Servicios de AWS disponibles en un formato de lista de prefijos para la región.

Get-EC2PrefixList

Salida:

Cidrs PrefixListId PrefixListName ----- ------------ -------------- {52.94.5.0/24, 52.119.240.0/21, 52.94.24.0/23} pl-6fa54006 com.amazonaws.eu-west-1.dynamodb {52.218.0.0/17, 54.231.128.0/19} pl-6da54004 com.amazonaws.eu-west-1.s3
  • Para obtener información sobre la API, consulte DescribePrefixLists en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Region.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describen las regiones que están disponibles.

Get-EC2Region

Salida:

Endpoint RegionName -------- ---------- ec2.eu-west-1.amazonaws.com eu-west-1 ec2.ap-southeast-1.amazonaws.com ap-southeast-1 ec2.ap-southeast-2.amazonaws.com ap-southeast-2 ec2.eu-central-1.amazonaws.com eu-central-1 ec2.ap-northeast-1.amazonaws.com ap-northeast-1 ec2.us-east-1.amazonaws.com us-east-1 ec2.sa-east-1.amazonaws.com sa-east-1 ec2.us-west-1.amazonaws.com us-west-1 ec2.us-west-2.amazonaws.com us-west-2
  • Para obtener información sobre la API, consulte DescribeRegions en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2RouteTable.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describen todas las tablas de enrutamiento.

Get-EC2RouteTable

Salida:

DestinationCidrBlock : 10.0.0.0/16 DestinationPrefixListId : GatewayId : local InstanceId : InstanceOwnerId : NetworkInterfaceId : Origin : CreateRouteTable State : active VpcPeeringConnectionId : DestinationCidrBlock : 0.0.0.0/0 DestinationPrefixListId : GatewayId : igw-1a2b3c4d InstanceId : InstanceOwnerId : NetworkInterfaceId : Origin : CreateRoute State : active VpcPeeringConnectionId :

Ejemplo 2: En este ejemplo se devuelven los detalles de la tabla de enrutamiento especificada.

Get-EC2RouteTable -RouteTableId rtb-1a2b3c4d

Ejemplo 3: En este ejemplo se describen las tablas de enrutamiento para la VPC especificada.

Get-EC2RouteTable -Filter @{ Name="vpc-id"; Values="vpc-1a2b3c4d" }

Salida:

Associations : {rtbassoc-12345678} PropagatingVgws : {} Routes : {, } RouteTableId : rtb-1a2b3c4d Tags : {} VpcId : vpc-1a2b3c4d
  • Para obtener información sobre la API, consulte DescribeRouteTables en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ScheduledInstance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la instancia programada especificada.

Get-EC2ScheduledInstance -ScheduledInstanceId sci-1234-1234-1234-1234-123456789012

Salida:

AvailabilityZone : us-west-2b CreateDate : 1/25/2016 1:43:38 PM HourlyPrice : 0.095 InstanceCount : 1 InstanceType : c4.large NetworkPlatform : EC2-VPC NextSlotStartTime : 1/31/2016 1:00:00 AM Platform : Linux/UNIX PreviousSlotEndTime : Recurrence : Amazon.EC2.Model.ScheduledInstanceRecurrence ScheduledInstanceId : sci-1234-1234-1234-1234-123456789012 SlotDurationInHours : 32 TermEndDate : 1/31/2017 1:00:00 AM TermStartDate : 1/31/2016 1:00:00 AM TotalScheduledInstanceHours : 1696

Ejemplo 2: En este ejemplo se describen todas las instancias programadas.

Get-EC2ScheduledInstance
  • Para obtener información sobre la API, consulte DescribeScheduledInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ScheduledInstanceAvailability.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe una programación que tiene lugar todos los domingos a partir de la fecha especificada.

Get-EC2ScheduledInstanceAvailability -Recurrence_Frequency Weekly -Recurrence_Interval 1 -Recurrence_OccurrenceDay 1 -FirstSlotStartTimeRange_EarliestTime 2016-01-31T00:00:00Z -FirstSlotStartTimeRange_LatestTime 2016-01-31T04:00:00Z

Salida:

AvailabilityZone : us-west-2b AvailableInstanceCount : 20 FirstSlotStartTime : 1/31/2016 8:00:00 AM HourlyPrice : 0.095 InstanceType : c4.large MaxTermDurationInDays : 366 MinTermDurationInDays : 366 NetworkPlatform : EC2-VPC Platform : Linux/UNIX PurchaseToken : eyJ2IjoiMSIsInMiOjEsImMiOi... Recurrence : Amazon.EC2.Model.ScheduledInstanceRecurrence SlotDurationInHours : 23 TotalScheduledInstanceHours : 1219 ...

Ejemplo 2: Para delimitar los resultados, puede añadir filtros para criterios como el sistema operativo, la red y el tipo de instancia.

-Filter @{ Name="platform";Values="Linux/UNIX" },@{ Name="network-platform";Values="EC2-VPC" },@{ Name="instance-type";Values="c4.large" }

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SecurityGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el grupo de seguridad para la VPC especificada. Al trabajar con grupos de seguridad que pertenecen a una VPC, debe usar el ID del grupo de seguridad (parámetro -GroupId), no el nombre (parámetro -GroupName), para hacer referencia al grupo.

Get-EC2SecurityGroup -GroupId sg-12345678

Salida:

Description : default VPC security group GroupId : sg-12345678 GroupName : default IpPermissions : {Amazon.EC2.Model.IpPermission} IpPermissionsEgress : {Amazon.EC2.Model.IpPermission} OwnerId : 123456789012 Tags : {} VpcId : vpc-12345678

Ejemplo 2: En este ejemplo se describe el grupo de seguridad especificado para EC2-Classic. Al trabajar con grupos de seguridad de EC2-Classic, debe usar el nombre del grupo (parámetro -GroupName) o el ID del grupo (parámetro -GroupId), para hacer referencia al grupo.

Get-EC2SecurityGroup -GroupName my-security-group

Salida:

Description : my security group GroupId : sg-45678901 GroupName : my-security-group IpPermissions : {Amazon.EC2.Model.IpPermission, Amazon.EC2.Model.IpPermission} IpPermissionsEgress : {} OwnerId : 123456789012 Tags : {} VpcId :

Ejemplo 3: En este ejemplo se recuperan todos los grupos de seguridad de vpc-0fc1ff23456b789eb.

Get-EC2SecurityGroup -Filter @{Name="vpc-id";Values="vpc-0fc1ff23456b789eb"}
  • Para obtener información sobre la API, consulte DescribeSecurityGroups en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Snapshot.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la instantánea especificada.

Get-EC2Snapshot -SnapshotId snap-12345678

Salida:

DataEncryptionKeyId : Description : Created by CreateImage(i-1a2b3c4d) for ami-12345678 from vol-12345678 Encrypted : False KmsKeyId : OwnerAlias : OwnerId : 123456789012 Progress : 100% SnapshotId : snap-12345678 StartTime : 10/23/2014 6:01:28 AM State : completed StateMessage : Tags : {} VolumeId : vol-12345678 VolumeSize : 8

Ejemplo 2: En este ejemplo se describen las instantáneas que tienen la etiqueta “Name”.

Get-EC2Snapshot | ? { $_.Tags.Count -gt 0 -and $_.Tags.Key -eq "Name" }

Ejemplo 3: En este ejemplo se describen las instantáneas que tienen la etiqueta “Name” con el valor “TestValue”.

Get-EC2Snapshot | ? { $_.Tags.Count -gt 0 -and $_.Tags.Key -eq "Name" -and $_.Tags.Value -eq "TestValue" }

Ejemplo 4: En este ejemplo se describen todas las instantáneas.

Get-EC2Snapshot -Owner self
  • Para obtener información sobre la API, consulte DescribeSnapshots en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SnapshotAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el atributo especificado de la instantánea especificada.

Get-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute ProductCodes

Salida:

CreateVolumePermissions ProductCodes SnapshotId ----------------------- ------------ ---------- {} {} snap-12345678

Ejemplo 2: En este ejemplo se describe el atributo especificado de la instantánea especificada.

(Get-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission).CreateVolumePermissions

Salida:

Group UserId ----- ------ all
  • Para obtener información sobre la API, consulte DescribeSnapshotAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotDatafeedSubscription.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la fuente de datos de la instancia de spot.

Get-EC2SpotDatafeedSubscription

Salida:

Bucket : amzn-s3-demo-bucket Fault : OwnerId : 123456789012 Prefix : spotdata State : Active

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotFleetInstance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describen las instancias asociadas a la solicitud de flota de spot especificada.

Get-EC2SpotFleetInstance -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE

Salida:

InstanceId InstanceType SpotInstanceRequestId ---------- ------------ --------------------- i-f089262a c3.large sir-12345678 i-7e8b24a4 c3.large sir-87654321
  • Para obtener información sobre la API, consulte DescribeSpotFleetInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotFleetRequest.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la solicitud de flota de spot especificada.

Get-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE | format-list

Salida:

ConfigData : Amazon.EC2.Model.SpotFleetRequestConfigData CreateTime : 12/26/2015 8:23:33 AM SpotFleetRequestId : sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE SpotFleetRequestState : active

Ejemplo 2: En este ejemplo se describen todas las solicitudes de flota de spot.

Get-EC2SpotFleetRequest
  • Para obtener información sobre la API, consulte DescribeSpotFleetRequests en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotFleetRequestHistory.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el historial de la solicitud de flota de spot especificada.

Get-EC2SpotFleetRequestHistory -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -StartTime 2015-12-26T00:00:00Z

Salida:

HistoryRecords : {Amazon.EC2.Model.HistoryRecord, Amazon.EC2.Model.HistoryRecord...} LastEvaluatedTime : 12/26/2015 8:29:11 AM NextToken : SpotFleetRequestId : sfr-088bc5f1-7e7b-451a-bd13-757f10672b93 StartTime : 12/25/2015 8:00:00 AM
(Get-EC2SpotFleetRequestHistory -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -StartTime 2015-12-26T00:00:00Z).HistoryRecords

Salida:

EventInformation EventType Timestamp ---------------- --------- --------- Amazon.EC2.Model.EventInformation fleetRequestChange 12/26/2015 8:23:33 AM Amazon.EC2.Model.EventInformation fleetRequestChange 12/26/2015 8:23:33 AM Amazon.EC2.Model.EventInformation fleetRequestChange 12/26/2015 8:23:33 AM Amazon.EC2.Model.EventInformation launched 12/26/2015 8:25:34 AM Amazon.EC2.Model.EventInformation launched 12/26/2015 8:25:05 AM
  • Para obtener información sobre la API, consulte DescribeSpotFleetRequestHistory en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotInstanceRequest.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la solicitud de instancia de spot especificada.

Get-EC2SpotInstanceRequest -SpotInstanceRequestId sir-12345678

Salida:

ActualBlockHourlyPrice : AvailabilityZoneGroup : BlockDurationMinutes : 0 CreateTime : 4/8/2015 2:51:33 PM Fault : InstanceId : i-12345678 LaunchedAvailabilityZone : us-west-2b LaunchGroup : LaunchSpecification : Amazon.EC2.Model.LaunchSpecification ProductDescription : Linux/UNIX SpotInstanceRequestId : sir-12345678 SpotPrice : 0.020000 State : active Status : Amazon.EC2.Model.SpotInstanceStatus Tags : {Name} Type : one-time

Ejemplo 2: En este ejemplo se describen todas las solicitudes de instancia de spot.

Get-EC2SpotInstanceRequest
  • Para obtener información sobre la API, consulte DescribeSpotInstanceRequests en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotPriceHistory.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtienen las 10 últimas entradas del historial de precios de spot para el tipo de instancia y la zona de disponibilidad especificados. Tenga en cuenta que el valor especificado para el parámetro -AvailabilityZone debe ser válido para el valor de región proporcionado al parámetro -Region del cmdlet (no se muestra en el ejemplo) o estar establecido como predeterminado en el intérprete de comandos. En este comando se presupone que se ha establecido la región predeterminada “us-west-2” en el entorno.

Get-EC2SpotPriceHistory -InstanceType c3.large -AvailabilityZone us-west-2a -MaxResult 10

Salida:

AvailabilityZone : us-west-2a InstanceType : c3.large Price : 0.017300 ProductDescription : Linux/UNIX (Amazon VPC) Timestamp : 12/25/2015 7:39:49 AM AvailabilityZone : us-west-2a InstanceType : c3.large Price : 0.017200 ProductDescription : Linux/UNIX (Amazon VPC) Timestamp : 12/25/2015 7:38:29 AM AvailabilityZone : us-west-2a InstanceType : c3.large Price : 0.017300 ProductDescription : Linux/UNIX (Amazon VPC) Timestamp : 12/25/2015 6:57:13 AM ...
  • Para obtener información sobre la API, consulte DescribeSpotPriceHistory en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Subnet.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la subred especificada.

Get-EC2Subnet -SubnetId subnet-1a2b3c4d

Salida:

AvailabilityZone : us-west-2c AvailableIpAddressCount : 251 CidrBlock : 10.0.0.0/24 DefaultForAz : False MapPublicIpOnLaunch : False State : available SubnetId : subnet-1a2b3c4d Tags : {} VpcId : vpc-12345678

Ejemplo 2: En este ejemplo se describen todas las subredes.

Get-EC2Subnet
  • Para obtener información sobre la API, consulte DescribeSubnets en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Tag.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se recuperan las etiquetas del tipo de recurso “image”.

Get-EC2Tag -Filter @{Name="resource-type";Values="image"}

Salida:

Key ResourceId ResourceType Value --- ---------- ------------ ----- Name ami-0a123b4ccb567a8ea image Win7-Imported auto-delete ami-0a123b4ccb567a8ea image never

Ejemplo 2: En este ejemplo se buscan todas las etiquetas de todos los recursos y se agrupan por tipo de recurso.

Get-EC2Tag | Group-Object resourcetype

Salida:

Count Name Group ----- ---- ----- 9 subnet {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...} 53 instance {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...} 3 route-table {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription} 5 security-group {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...} 30 volume {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...} 1 internet-gateway {Amazon.EC2.Model.TagDescription} 3 network-interface {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription} 4 elastic-ip {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription} 1 dhcp-options {Amazon.EC2.Model.TagDescription} 2 image {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription} 3 vpc {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription}

Ejemplo 3: Este ejemplo muestra todos los recursos con la etiqueta “auto-delete” con el valor “no” para la región especificada.

Get-EC2Tag -Region eu-west-1 -Filter @{Name="tag:auto-delete";Values="no"}

Salida:

Key ResourceId ResourceType Value --- ---------- ------------ ----- auto-delete i-0f1bce234d5dd678b instance no auto-delete vol-01d234aa5678901a2 volume no auto-delete vol-01234bfb5def6f7b8 volume no auto-delete vol-01ccb23f4c5e67890 volume no

Ejemplo 4: En este ejemplo se obtienen todos los recursos con la etiqueta “auto-delete” con el valor “no”, luego se aplica un filtro en el siguiente envío para analizar solo los tipos de recursos “instance” y, finalmente, se crea la etiqueta “ThisInstance” para todos los recursos de instancia cuyo valor es el propio identificador de la instancia.

Get-EC2Tag -Region eu-west-1 -Filter @{Name="tag:auto-delete";Values="no"} | Where-Object ResourceType -eq "instance" | ForEach-Object {New-EC2Tag -ResourceId $_.ResourceId -Tag @{Key="ThisInstance";Value=$_.ResourceId}}

Ejemplo 5: En este ejemplo se recuperan las etiquetas de todos los recursos de instancia, así como las claves “Name”, y las muestra en formato de tabla.

Get-EC2Tag -Filter @{Name="resource-type";Values="instance"},@{Name="key";Values="Name"} | Select-Object ResourceId, @{Name="Name-Tag";Expression={$PSItem.Value}} | Format-Table -AutoSize

Salida:

ResourceId Name-Tag ---------- -------- i-012e3cb4df567e1aa jump1 i-01c23a45d6fc7a89f repro-3
  • Para obtener información sobre la API, consulte DescribeTags en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Volume.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el volumen de EBS especificado.

Get-EC2Volume -VolumeId vol-12345678

Salida:

Attachments : {} AvailabilityZone : us-west-2c CreateTime : 7/17/2015 4:35:19 PM Encrypted : False Iops : 90 KmsKeyId : Size : 30 SnapshotId : snap-12345678 State : in-use Tags : {} VolumeId : vol-12345678 VolumeType : standard

Ejemplo 2: En este ejemplo se describen los volúmenes de EBS que tienen el estado “disponible”.

Get-EC2Volume -Filter @{ Name="status"; Values="available" }

Salida:

Attachments : {} AvailabilityZone : us-west-2c CreateTime : 12/21/2015 2:31:29 PM Encrypted : False Iops : 60 KmsKeyId : Size : 20 SnapshotId : snap-12345678 State : available Tags : {} VolumeId : vol-12345678 VolumeType : gp2 ...

Ejemplo 3: En este ejemplo se describen todos los volúmenes de EBS.

Get-EC2Volume
  • Para obtener información sobre la API, consulte DescribeVolumes en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VolumeAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el atributo especificado del volumen especificado.

Get-EC2VolumeAttribute -VolumeId vol-12345678 -Attribute AutoEnableIO

Salida:

AutoEnableIO ProductCodes VolumeId ------------ ------------ -------- False {} vol-12345678
  • Para obtener información sobre la API, consulte DescribeVolumeAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VolumeStatus.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el estado del volumen especificado.

Get-EC2VolumeStatus -VolumeId vol-12345678

Salida:

Actions : {} AvailabilityZone : us-west-2a Events : {} VolumeId : vol-12345678 VolumeStatus : Amazon.EC2.Model.VolumeStatusInfo
(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatus

Salida:

Details Status ------- ------ {io-enabled, io-performance} ok
(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatus.Details

Salida:

Name Status ---- ------ io-enabled passed io-performance not-applicable
  • Para obtener información sobre la API, consulte DescribeVolumeStatus en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Vpc.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la VPC especificada.

Get-EC2Vpc -VpcId vpc-12345678

Salida:

CidrBlock : 10.0.0.0/16 DhcpOptionsId : dopt-1a2b3c4d InstanceTenancy : default IsDefault : False State : available Tags : {Name} VpcId : vpc-12345678

Ejemplo 2: En este ejemplo se describe la VPC predeterminada (solo puede haber una por región). Si su cuenta es compatible con EC2-Classic en esta región, no hay una VPC predeterminada.

Get-EC2Vpc -Filter @{Name="isDefault"; Values="true"}

Salida:

CidrBlock : 172.31.0.0/16 DhcpOptionsId : dopt-12345678 InstanceTenancy : default IsDefault : True State : available Tags : {} VpcId : vpc-45678901

Ejemplo 3: En este ejemplo se describen las VPC que coinciden con el filtro especificado (es decir, tienen un CIDR que coincide con el valor “10.0.0.0/16” y tienen el estado “disponible”).

Get-EC2Vpc -Filter @{Name="cidr"; Values="10.0.0.0/16"},@{Name="state";Values="available"}

Ejemplo 4: En este ejemplo se describen todas las VPC.

Get-EC2Vpc
  • Para obtener información sobre la API, consulte DescribeVpcs en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el atributo “enableDnsSupport”.

Get-EC2VpcAttribute -VpcId vpc-12345678 -Attribute enableDnsSupport

Salida:

EnableDnsSupport ---------------- True

Ejemplo 2: En este ejemplo se describe el atributo “enableDnsHostnames”.

Get-EC2VpcAttribute -VpcId vpc-12345678 -Attribute enableDnsHostnames

Salida:

EnableDnsHostnames ------------------ True
  • Para obtener información sobre la API, consulte DescribeVpcAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcClassicLink.

Herramientas para PowerShell V4

Ejemplo 1: El ejemplo anterior devuelve todas las VPC de la región con su estado ClassicLinkEnabled.

Get-EC2VpcClassicLink -Region eu-west-1

Salida:

ClassicLinkEnabled Tags VpcId ------------------ ---- ----- False {Name} vpc-0fc1ff23f45b678eb False {} vpc-01e23c4a5d6db78e9 False {Name} vpc-0123456b078b9d01f False {} vpc-12cf3b4f False {Name} vpc-0b12d3456a7e8901d
  • Para obtener información sobre la API, consulte DescribeVpcClassicLink en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcClassicLinkDnsSupport.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el estado de compatibilidad de DNS de ClassicLink de las VPC de la región eu-west-1.

Get-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d -Region eu-west-1

Salida:

ClassicLinkDnsSupported VpcId ----------------------- ----- False vpc-0b12d3456a7e8910d False vpc-12cf3b4f

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcEndpoint.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describen uno o varios de los puntos de conexión de VPC para la región eu-west-1. A continuación, se envía el resultado al siguiente comando, que selecciona la propiedad VpcEndpointId y devuelve el ID de VPC de la matriz como una matriz de cadenas.

Get-EC2VpcEndpoint -Region eu-west-1 | Select-Object -ExpandProperty VpcEndpointId

Salida:

vpce-01a2ab3f4f5cc6f7d vpce-01d2b345a6787890b vpce-0012e34d567890e12 vpce-0c123db4567890123

Ejemplo 2: En este ejemplo se describen todos los puntos de conexión de VPC de la región eu-west-1 y se seleccionan las propiedades VpcEndpointId, VpcId, ServiceName y PrivateDnsEnabled para presentarlas en formato tabular.

Get-EC2VpcEndpoint -Region eu-west-1 | Select-Object VpcEndpointId, VpcId, ServiceName, PrivateDnsEnabled | Format-Table -AutoSize

Salida:

VpcEndpointId VpcId ServiceName PrivateDnsEnabled ------------- ----- ----------- ----------------- vpce-02a2ab2f2f2cc2f2d vpc-0fc6ff46f65b039eb com.amazonaws.eu-west-1.ssm True vpce-01d1b111a1114561b vpc-0fc6ff46f65b039eb com.amazonaws.eu-west-1.ec2 True vpce-0011e23d45167e838 vpc-0fc6ff46f65b039eb com.amazonaws.eu-west-1.ec2messages True vpce-0c123db4567890123 vpc-0fc6ff46f65b039eb com.amazonaws.eu-west-1.ssmmessages True

Ejemplo 3: En este ejemplo se exporta el documento de política del punto de conexión de VPC vpce-01a2ab3f4f5cc6f7d a un archivo json.

Get-EC2VpcEndpoint -Region eu-west-1 -VpcEndpointId vpce-01a2ab3f4f5cc6f7d | Select-Object -expand PolicyDocument | Out-File vpce_policyDocument.json
  • Para obtener información sobre la API, consulte DescribeVpcEndpoints en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcEndpointService.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el servicio de punto de conexión de VPC de EC2 con el filtro indicado, en este caso, com.amazonaws.eu-west-1.ecs. Además, también se amplía la propiedad ServiceDetails y se muestran los detalles.

Get-EC2VpcEndpointService -Region eu-west-1 -MaxResult 5 -Filter @{Name="service-name";Values="com.amazonaws.eu-west-1.ecs"} | Select-Object -ExpandProperty ServiceDetails

Salida:

AcceptanceRequired : False AvailabilityZones : {eu-west-1a, eu-west-1b, eu-west-1c} BaseEndpointDnsNames : {ecs.eu-west-1.vpce.amazonaws.com} Owner : amazon PrivateDnsName : ecs.eu-west-1.amazonaws.com ServiceName : com.amazonaws.eu-west-1.ecs ServiceType : {Amazon.EC2.Model.ServiceTypeDetail} VpcEndpointPolicySupported : False

Ejemplo 2: En este ejemplo se recuperan todos los servicios de punto de conexión de VPC de EC2 y se devuelven los ServiceNames que coinciden con “ssm”.

Get-EC2VpcEndpointService -Region eu-west-1 | Select-Object -ExpandProperty Servicenames | Where-Object { -match "ssm"}

Salida:

com.amazonaws.eu-west-1.ssm com.amazonaws.eu-west-1.ssmmessages
  • Para obtener información sobre la API, consulte DescribeVpcEndpointServices en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpnConnection.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la conexión VPN especificada.

Get-EC2VpnConnection -VpnConnectionId vpn-12345678

Salida:

CustomerGatewayConfiguration : [XML document] CustomerGatewayId : cgw-1a2b3c4d Options : Amazon.EC2.Model.VpnConnectionOptions Routes : {Amazon.EC2.Model.VpnStaticRoute} State : available Tags : {} Type : ipsec.1 VgwTelemetry : {Amazon.EC2.Model.VgwTelemetry, Amazon.EC2.Model.VgwTelemetry} VpnConnectionId : vpn-12345678 VpnGatewayId : vgw-1a2b3c4d

Ejemplo 2: En este ejemplo se describen todas las conexiones VPN cuyo estado sea pendiente o disponible.

$filter = New-Object Amazon.EC2.Model.Filter $filter.Name = "state" $filter.Values = @( "pending", "available" ) Get-EC2VpnConnection -Filter $filter

Ejemplo 3: En este ejemplo se describen todas las conexiones VPN.

Get-EC2VpnConnection
  • Para obtener información sobre la API, consulte DescribeVpnConnections en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpnGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe la puerta de enlace privada virtual especificada.

Get-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d

Salida:

AvailabilityZone : State : available Tags : {} Type : ipsec.1 VpcAttachments : {vpc-12345678} VpnGatewayId : vgw-1a2b3c4d

Ejemplo 2: En este ejemplo se describen todas las puertas de enlace privada virtuales cuyo estado sea pendiente o disponible.

$filter = New-Object Amazon.EC2.Model.Filter $filter.Name = "state" $filter.Values = @( "pending", "available" ) Get-EC2VpnGateway -Filter $filter

Ejemplo 3: En este ejemplo se describen las puertas de enlace privadas virtuales.

Get-EC2VpnGateway
  • Para obtener información sobre la API, consulte DescribeVpnGateways en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Grant-EC2SecurityGroupEgress.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se define una regla de salida para el grupo de seguridad especificado para EC2-VPC. La regla otorga acceso en el puerto TCP 80 al intervalo de direcciones IP especificado. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

$ip = @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; IpRanges="203.0.113.0/24" } Grant-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip

Ejemplo 2: Con la versión 2 de PowerShell, debe usar New-Object para crear cada objeto IpPermission.

$ip = New-Object Amazon.EC2.Model.IpPermission $ip.IpProtocol = "tcp" $ip.FromPort = 80 $ip.ToPort = 80 $ip.IpRanges.Add("203.0.113.0/24") Grant-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip

Ejemplo 3: En este ejemplo se otorga acceso al grupo de seguridad de origen especificado en el puerto TCP 80.

$ug = New-Object Amazon.EC2.Model.UserIdGroupPair $ug.GroupId = "sg-1a2b3c4d" $ug.UserId = "123456789012" Grant-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission @( @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; UserIdGroupPairs=$ug } )
  • Para obtener información sobre la API, consulte AuthorizeSecurityGroupEgress en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Grant-EC2SecurityGroupIngress.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se define una regla de entrada para un grupo de seguridad para EC2-VPC. Estas reglas otorgan acceso a una dirección IP específica para SSH (puerto 22) y RDC (puerto 3389). Además, debe identificar los grupos de seguridad de EC2-VPC mediante el ID del grupo de seguridad, en lugar del nombre del grupo de seguridad. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

$ip1 = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.25/32" } $ip2 = @{ IpProtocol="tcp"; FromPort="3389"; ToPort="3389"; IpRanges="203.0.113.25/32" } Grant-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission @( $ip1, $ip2 )

Ejemplo 2: Con la versión 2 de PowerShell, debe usar New-Object para crear los objetos IpPermission.

$ip1 = New-Object Amazon.EC2.Model.IpPermission $ip1.IpProtocol = "tcp" $ip1.FromPort = 22 $ip1.ToPort = 22 $ip1.IpRanges.Add("203.0.113.25/32") $ip2 = new-object Amazon.EC2.Model.IpPermission $ip2.IpProtocol = "tcp" $ip2.FromPort = 3389 $ip2.ToPort = 3389 $ip2.IpRanges.Add("203.0.113.25/32") Grant-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission @( $ip1, $ip2 )

Ejemplo 3: En este ejemplo se definen las regla de entrada para un grupo de seguridad de EC2-VPC. Estas reglas otorgan acceso a una dirección IP específica para SSH (puerto 22) y RDC (puerto 3389). La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

$ip1 = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.25/32" } $ip2 = @{ IpProtocol="tcp"; FromPort="3389"; ToPort="3389"; IpRanges="203.0.113.25/32" } Grant-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission @( $ip1, $ip2 )

Ejemplo 4: Con la versión 2 de PowerShell, debe usar New-Object para crear los objetos IpPermission.

$ip1 = New-Object Amazon.EC2.Model.IpPermission $ip1.IpProtocol = "tcp" $ip1.FromPort = 22 $ip1.ToPort = 22 $ip1.IpRanges.Add("203.0.113.25/32") $ip2 = new-object Amazon.EC2.Model.IpPermission $ip2.IpProtocol = "tcp" $ip2.FromPort = 3389 $ip2.ToPort = 3389 $ip2.IpRanges.Add("203.0.113.25/32") Grant-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission @( $ip1, $ip2 )

Ejemplo 5: En este ejemplo se concede el acceso del puerto TCP 8081 desde el grupo de seguridad de origen especificado (sg-1a2b3c4d) al grupo de seguridad especificado (sg-12345678).

$ug = New-Object Amazon.EC2.Model.UserIdGroupPair $ug.GroupId = "sg-1a2b3c4d" $ug.UserId = "123456789012" Grant-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission @( @{ IpProtocol="tcp"; FromPort="8081"; ToPort="8081"; UserIdGroupPairs=$ug } )

Ejemplo 6: Este ejemplo añade el CIDR 5.5.5.5/32 a las reglas de entrada del grupo de seguridad sg-1234abcd para el tráfico del puerto TCP 22 con una descripción.

$IpRange = New-Object -TypeName Amazon.EC2.Model.IpRange $IpRange.CidrIp = "5.5.5.5/32" $IpRange.Description = "SSH from Office" $IpPermission = New-Object Amazon.EC2.Model.IpPermission $IpPermission.IpProtocol = "tcp" $IpPermission.ToPort = 22 $IpPermission.FromPort = 22 $IpPermission.Ipv4Ranges = $IpRange Grant-EC2SecurityGroupIngress -GroupId sg-1234abcd -IpPermission $IpPermission
  • Para obtener información sobre la API, consulte AuthorizeSecurityGroupIngress en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Import-EC2Image.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se importa una imagen de máquina virtual de un solo disco del bucket de Amazon S3 especificado a Amazon EC2 con un token de idempotencia. El ejemplo requiere que exista un rol de servicio de VM Import con el nombre predeterminado “vmimport”, con una política que permita a Amazon EC2 acceder al bucket especificado, como se explica en el tema Requisitos previos de VM Import. Para usar un rol personalizado, especifique el nombre del rol mediante el parámetro -RoleName.

$container = New-Object Amazon.EC2.Model.ImageDiskContainer $container.Format="VMDK" $container.UserBucket = New-Object Amazon.EC2.Model.UserBucket $container.UserBucket.S3Bucket = "amzn-s3-demo-bucket" $container.UserBucket.S3Key = "Win_2008_Server_Standard_SP2_64-bit-disk1.vmdk" $parms = @{ "ClientToken"="idempotencyToken" "Description"="Windows 2008 Standard Image Import" "Platform"="Windows" "LicenseType"="AWS" } Import-EC2Image -DiskContainer $container @parms

Salida:

Architecture : Description : Windows 2008 Standard Image Hypervisor : ImageId : ImportTaskId : import-ami-abcdefgh LicenseType : AWS Platform : Windows Progress : 2 SnapshotDetails : {} Status : active StatusMessage : pending
  • Para obtener información sobre la API, consulte ImportImage en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Import-EC2KeyPair.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se importa una clave pública a EC2. La primera línea almacena el contenido del archivo de clave pública (*.pub) en la variable $publickey. A continuación, el ejemplo convierte el formato UTF8 del archivo de clave pública en una cadena codificada en Base64 y almacena la cadena convertida en la variable $pkbase64. En la última línea, la clave pública convertida se importa a EC2. Como resultado, el cmdlet devuelve la huella digital y el nombre de la clave.

$publickey=[Io.File]::ReadAllText("C:\Users\TestUser\.ssh\id_rsa.pub") $pkbase64 = [System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($publickey)) Import-EC2KeyPair -KeyName Example-user-key -PublicKey $pkbase64

Salida:

KeyFingerprint KeyName -------------- ------- do:d0:15:8f:79:97:12:be:00:fd:df:31:z3:b1:42:z1 Example-user-key
  • Para obtener información sobre la API, consulte ImportKeyPair en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Import-EC2Snapshot.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se importa una imagen de disco de máquina virtual con el formato “VMDK” a una instantánea de Amazon EBS. El ejemplo requiere un rol de servicio de VM Import con el nombre predeterminado “vmimport”, con una política que permita a Amazon EC2 acceder al bucket especificado, como se explica en el tema VM Import Prequisites en http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/VMImportPrerequisites.html. Para usar un rol personalizado, especifique el nombre del rol mediante el parámetro -RoleName.

$parms = @{ "ClientToken"="idempotencyToken" "Description"="Disk Image Import" "DiskContainer_Description" = "Data disk" "DiskContainer_Format" = "VMDK" "DiskContainer_S3Bucket" = "amzn-s3-demo-bucket" "DiskContainer_S3Key" = "datadiskimage.vmdk" } Import-EC2Snapshot @parms

Salida:

Description ImportTaskId SnapshotTaskDetail ----------------- -------------------- ------------------ Disk Image Import import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetail
  • Para obtener información sobre la API, consulte ImportSnapshot en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Move-EC2AddressToVpc.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se mueve una instancia de EC2 con la dirección IP pública 12.345.67.89 a la plataforma de EC2-VPC en la región Este de EE. UU. (Norte de Virginia).

Move-EC2AddressToVpc -PublicIp 12.345.67.89 -Region us-east-1

Ejemplo 2: En este ejemplo se envían los resultados de un comando Get-EC2Instance al cmdlet Move-EC2AddressToVpc. El comando Get-EC2Instance obtiene una instancia que se especifica mediante el ID de la instancia y, a continuación, devuelve la propiedad de dirección IP pública de la instancia.

(Get-EC2Instance -Instance i-12345678).Instances.PublicIpAddress | Move-EC2AddressToVpc
  • Para obtener información sobre la API, consulte MoveAddressToVpc en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Address.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asigna una dirección IP elástica para usarla con una instancia en una VPC.

New-EC2Address -Domain Vpc

Salida:

AllocationId Domain PublicIp ------------ ------ -------- eipalloc-12345678 vpc 198.51.100.2

Ejemplo 2: En este ejemplo se asigna una dirección IP elástica para usarla con una instancia en EC2-Classic.

New-EC2Address

Salida:

AllocationId Domain PublicIp ------------ ------ -------- standard 203.0.113.17
  • Para obtener información sobre la API, consulte AllocateAddress en la Referencia del cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2CustomerGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea la puerta de enlace de cliente especificada.

New-EC2CustomerGateway -Type ipsec.1 -PublicIp 203.0.113.12 -BgpAsn 65534

Salida:

BgpAsn : 65534 CustomerGatewayId : cgw-1a2b3c4d IpAddress : 203.0.113.12 State : available Tags : {} Type : ipsec.1
  • Para obtener información sobre la API, consulte CreateCustomerGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2DhcpOption.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea el conjunto especificado de opciones de DHCP. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

$options = @( @{Key="domain-name";Values=@("abc.local")}, @{Key="domain-name-servers";Values=@("10.0.0.101","10.0.0.102")}) New-EC2DhcpOption -DhcpConfiguration $options

Salida:

DhcpConfigurations DhcpOptionsId Tags ------------------ ------------- ---- {domain-name, domain-name-servers} dopt-1a2b3c4d {}

Ejemplo 2: Con la versión 2 de PowerShell, debe usar New-Object para crear cada opción de DHCP.

$option1 = New-Object Amazon.EC2.Model.DhcpConfiguration $option1.Key = "domain-name" $option1.Values = "abc.local" $option2 = New-Object Amazon.EC2.Model.DhcpConfiguration $option2.Key = "domain-name-servers" $option2.Values = @("10.0.0.101","10.0.0.102") New-EC2DhcpOption -DhcpConfiguration @($option1, $option2)

Salida:

DhcpConfigurations DhcpOptionsId Tags ------------------ ------------- ---- {domain-name, domain-name-servers} dopt-2a3b4c5d {}
  • Para obtener información sobre la API, consulte CreateDhcpOptions en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2FlowLog.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un registro de flujo de EC2 para la subred subnet-1d234567 en el cloud-watch-log llamado “subnet1-log” para todo el tráfico marcado como “REJECT” con los permisos del rol “Administrador”

New-EC2FlowLog -ResourceId "subnet-1d234567" -LogDestinationType cloud-watch-logs -LogGroupName subnet1-log -TrafficType "REJECT" -ResourceType Subnet -DeliverLogsPermissionArn "arn:aws:iam::98765432109:role/Admin"

Salida:

ClientToken FlowLogIds Unsuccessful ----------- ---------- ------------ m1VN2cxP3iB4qo//VUKl5EU6cF7gQLOxcqNefvjeTGw= {fl-012fc34eed5678c9d} {}
  • Para obtener información sobre la API, consulte CreateFlowLogs en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Host.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asigna un host dedicado a su cuenta para el tipo de instancia y la zona de disponibilidad especificados

New-EC2Host -AutoPlacement on -AvailabilityZone eu-west-1b -InstanceType m4.xlarge -Quantity 1

Salida:

h-01e23f4cd567890f3
  • Para obtener información sobre la API, consulte AllocateHosts en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2HostReservation.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se compra la oferta de reserva 0c1f23456789d0ab con configuraciones que coinciden con las de su host dedicado h-01e23f4cd567890f1.

New-EC2HostReservation -OfferingId hro-0c1f23456789d0ab HostIdSet h-01e23f4cd567890f1

Salida:

ClientToken : CurrencyCode : Purchase : {hr-0123f4b5d67bedc89} TotalHourlyPrice : 1.307 TotalUpfrontPrice : 0.000
  • Para obtener información sobre la API, consulte PurchaseHostReservation en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Image.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una AMI con el nombre y la descripción especificados desde la instancia especificada. Amazon EC2 intenta cerrar la instancia de forma limpia antes de crear la imagen y la reinicia una vez finalizada.

New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI"

Ejemplo 2: En este ejemplo se crea una AMI con el nombre y la descripción especificados desde la instancia especificada. Amazon EC2 crea la imagen sin cerrar ni reiniciar la instancia; por lo tanto, no se puede garantizar la integridad del sistema de archivos de la imagen creada.

New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI" -NoReboot $true

Ejemplo 3: En este ejemplo se crea una AMI con tres volúmenes. El primer volumen se basa en una instantánea de Amazon EBS. El segundo volumen es un volumen de Amazon EBS vacío de 100 GiB. El tercer volumen es un volumen de almacén de instancias. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

$ebsBlock1 = @{SnapshotId="snap-1a2b3c4d"} $ebsBlock2 = @{VolumeSize=100} New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI" -BlockDeviceMapping @( @{DeviceName="/dev/sdf";Ebs=$ebsBlock1}, @{DeviceName="/dev/sdg";Ebs=$ebsBlock2}, @{DeviceName="/dev/sdc";VirtualName="ephemeral0"})
  • Para obtener información sobre la API, consulte CreateImage en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Instance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se lanza una sola instancia de la AMI especificada en EC2-Classic o en una VPC predeterminada.

New-EC2Instance -ImageId ami-12345678 -MinCount 1 -MaxCount 1 -InstanceType m3.medium -KeyName my-key-pair -SecurityGroup my-security-group

Ejemplo 2: En este ejemplo se lanza una sola instancia de la AMI especificada en una VPC.

New-EC2Instance -ImageId ami-12345678 -MinCount 1 -MaxCount 1 -SubnetId subnet-12345678 -InstanceType t2.micro -KeyName my-key-pair -SecurityGroupId sg-12345678

Ejemplo 3: Para añadir un volumen de EBS o un volumen de almacén de instancias, defina una asignación de dispositivos de bloques y añádala al comando. En este ejemplo se añade un volumen de almacén de instancias.

$bdm = New-Object Amazon.EC2.Model.BlockDeviceMapping $bdm.VirtualName = "ephemeral0" $bdm.DeviceName = "/dev/sdf" New-EC2Instance -ImageId ami-12345678 -BlockDeviceMapping $bdm ...

Ejemplo 4: Para especificar una de las AMI de Windows actuales, obtenga su ID de AMI mediante Get-EC2ImageByName. En este ejemplo se lanza una instancia desde la AMI base actual para Windows Server 2016.

$ami = Get-EC2ImageByName WINDOWS_2016_BASE New-EC2Instance -ImageId $ami.ImageId ...

Ejemplo 5: Lanza una instancia en el entorno de host dedicado especificado.

New-EC2Instance -ImageId ami-1a2b3c4d -InstanceType m4.large -KeyName my-key-pair -SecurityGroupId sg-1a2b3c4d -AvailabilityZone us-west-1a -Tenancy host -HostID h-1a2b3c4d5e6f1a2b3

Ejemplo 6: Esta solicitud lanza dos instancias y aplica una etiqueta con una clave de servidor web y un valor de producción a las instancias. La solicitud también aplica una etiqueta con una clave de cost-center y un valor de cc123 a los volúmenes que se crean (en este caso, el volumen raíz de cada instancia).

$tag1 = @{ Key="webserver"; Value="production" } $tag2 = @{ Key="cost-center"; Value="cc123" } $tagspec1 = new-object Amazon.EC2.Model.TagSpecification $tagspec1.ResourceType = "instance" $tagspec1.Tags.Add($tag1) $tagspec2 = new-object Amazon.EC2.Model.TagSpecification $tagspec2.ResourceType = "volume" $tagspec2.Tags.Add($tag2) New-EC2Instance -ImageId "ami-1a2b3c4d" -KeyName "my-key-pair" -MaxCount 2 -InstanceType "t2.large" -SubnetId "subnet-1a2b3c4d" -TagSpecification $tagspec1,$tagspec2
  • Para obtener información sobre la API, consulte RunInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2InstanceExportTask.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se exporta una instancia detenida, i-0800b00a00EXAMPLE, como un disco duro virtual (VHD) al bucket de S3 testbucket-export-instances-2019. El entorno de destino es Microsoft, y el parámetro region se añade porque la instancia está en la región us-east-1, mientras que la región de AWS predeterminada del usuario no es us-east-1. Para obtener el estado de la tarea de exportación, copie el valor de ExportTaskId de los resultados de este comando y ejecute Get-EC2ExportTask -ExportTaskId export_task_ID_from_results.

New-EC2InstanceExportTask -InstanceId i-0800b00a00EXAMPLE -ExportToS3Task_DiskImageFormat VHD -ExportToS3Task_S3Bucket "amzn-s3-demo-bucket" -TargetEnvironment Microsoft -Region us-east-1

Salida:

Description : ExportTaskId : export-i-077c73108aEXAMPLE ExportToS3Task : Amazon.EC2.Model.ExportToS3Task InstanceExportDetails : Amazon.EC2.Model.InstanceExportDetails State : active StatusMessage :
  • Para obtener información sobre la API, consulte CreateInstanceExportTask en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2InternetGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una puerta de enlace de Internet.

New-EC2InternetGateway

Salida:

Attachments InternetGatewayId Tags ----------- ----------------- ---- {} igw-1a2b3c4d {}
  • Para obtener información sobre la API, consulte CreateInternetGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2KeyPair.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo crea un par de claves y captura la clave privada de RSA codificada en PEM en un archivo con el nombre especificado. Si utiliza PowerShell, la codificación debe estar configurada en ascii para generar una clave válida. Para obtener más información, consulte Creación, visualización y eliminación de pares de claves de Amazon EC2 (https://docs.aws.amazon.com/cli/latest/userguide/cli-services-ec2-keypairs.html) en la Guía del usuario de la CLI de AWS.

(New-EC2KeyPair -KeyName "my-key-pair").KeyMaterial | Out-File -Encoding ascii -FilePath C:\path\my-key-pair.pem
  • Para obtener información sobre la API, consulte CreateKeyPair en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2NetworkAcl.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una ACL de red para la VPC especificada.

New-EC2NetworkAcl -VpcId vpc-12345678

Salida:

Associations : {} Entries : {Amazon.EC2.Model.NetworkAclEntry, Amazon.EC2.Model.NetworkAclEntry} IsDefault : False NetworkAclId : acl-12345678 Tags : {} VpcId : vpc-12345678
  • Para obtener información sobre la API, consulte CreateNetworkAcl en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2NetworkAclEntry.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una entrada para la ACL de red especificada. La regla permite la entrada de tráfico desde cualquier dirección (0.0.0.0/0) en el puerto UDP 53 (DNS) a cualquier subred asociada.

New-EC2NetworkAclEntry -NetworkAclId acl-12345678 -Egress $false -RuleNumber 100 -Protocol 17 -PortRange_From 53 -PortRange_To 53 -CidrBlock 0.0.0.0/0 -RuleAction allow
  • Para obtener información sobre la API, consulte CreateNetworkAclEntry en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2NetworkInterface.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea la interfaz de red especificada.

New-EC2NetworkInterface -SubnetId subnet-1a2b3c4d -Description "my network interface" -Group sg-12345678 -PrivateIpAddress 10.0.0.17

Salida:

Association : Attachment : AvailabilityZone : us-west-2c Description : my network interface Groups : {my-security-group} MacAddress : 0a:72:bc:1a:cd:7f NetworkInterfaceId : eni-12345678 OwnerId : 123456789012 PrivateDnsName : ip-10-0-0-17.us-west-2.compute.internal PrivateIpAddress : 10.0.0.17 PrivateIpAddresses : {} RequesterId : RequesterManaged : False SourceDestCheck : True Status : pending SubnetId : subnet-1a2b3c4d TagSet : {} VpcId : vpc-12345678
  • Para obtener información sobre la API, consulte CreateNetworkInterface en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2PlacementGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un grupo de ubicación con el nombre especificado.

New-EC2PlacementGroup -GroupName my-placement-group -Strategy cluster
  • Para obtener información sobre la API, consulte CreatePlacementGroup en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Route.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea la ruta especificada para la tabla de enrutamiento especificada. La ruta coincide con todo el tráfico y lo dirige a la puerta de enlace de Internet especificada.

New-EC2Route -RouteTableId rtb-1a2b3c4d -DestinationCidrBlock 0.0.0.0/0 -GatewayId igw-1a2b3c4d

Salida:

True
  • Para obtener información sobre la API, consulte CreateRoute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2RouteTable.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una tabla de enrutamiento para la VPC especificada.

New-EC2RouteTable -VpcId vpc-12345678

Salida:

Associations : {} PropagatingVgws : {} Routes : {} RouteTableId : rtb-1a2b3c4d Tags : {} VpcId : vpc-12345678
  • Para obtener información sobre la API, consulte CreateRouteTable en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2ScheduledInstance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se lanza la instancia programada especificada.

New-EC2ScheduledInstance -ScheduledInstanceId sci-1234-1234-1234-1234-123456789012 -InstanceCount 1 ` -IamInstanceProfile_Name my-iam-role ` -LaunchSpecification_ImageId ami-12345678 ` -LaunchSpecification_InstanceType c4.large ` -LaunchSpecification_SubnetId subnet-12345678` -LaunchSpecification_SecurityGroupId sg-12345678
  • Para obtener información sobre la API, consulte RunScheduledInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2ScheduledInstancePurchase.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se compra una instancia programada.

$request = New-Object Amazon.EC2.Model.PurchaseRequest $request.InstanceCount = 1 $request.PurchaseToken = "eyJ2IjoiMSIsInMiOjEsImMiOi..." New-EC2ScheduledInstancePurchase -PurchaseRequest $request

Salida:

AvailabilityZone : us-west-2b CreateDate : 1/25/2016 1:43:38 PM HourlyPrice : 0.095 InstanceCount : 1 InstanceType : c4.large NetworkPlatform : EC2-VPC NextSlotStartTime : 1/31/2016 1:00:00 AM Platform : Linux/UNIX PreviousSlotEndTime : Recurrence : Amazon.EC2.Model.ScheduledInstanceRecurrence ScheduledInstanceId : sci-1234-1234-1234-1234-123456789012 SlotDurationInHours : 32 TermEndDate : 1/31/2017 1:00:00 AM TermStartDate : 1/31/2016 1:00:00 AM TotalScheduledInstanceHours : 1696
  • Para obtener información sobre la API, consulte PurchaseScheduledInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2SecurityGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un grupo de seguridad para la VPC especificada.

New-EC2SecurityGroup -GroupName my-security-group -Description "my security group" -VpcId vpc-12345678

Salida:

sg-12345678

Ejemplo 2: En este ejemplo se crea un grupo de seguridad para EC2-Classic.

New-EC2SecurityGroup -GroupName my-security-group -Description "my security group"

Salida:

sg-45678901
  • Para obtener información sobre la API, consulte CreateSecurityGroup en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Snapshot.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una instantánea del volumen especificado.

New-EC2Snapshot -VolumeId vol-12345678 -Description "This is a test"

Salida:

DataEncryptionKeyId : Description : This is a test Encrypted : False KmsKeyId : OwnerAlias : OwnerId : 123456789012 Progress : SnapshotId : snap-12345678 StartTime : 12/22/2015 1:28:42 AM State : pending StateMessage : Tags : {} VolumeId : vol-12345678 VolumeSize : 20
  • Para obtener información sobre la API, consulte CreateSnapshot en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2SpotDatafeedSubscription.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea la fuente de datos de una instancia de spot.

New-EC2SpotDatafeedSubscription -Bucket amzn-s3-demo-bucket -Prefix spotdata

Salida:

Bucket : amzn-s3-demo-bucket Fault : OwnerId : 123456789012 Prefix : spotdata State : Active
  • Para obtener información sobre la API, consulte CreateSpotDatafeedSubscription en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Subnet.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una subred para el CIDR especificado.

New-EC2Subnet -VpcId vpc-12345678 -CidrBlock 10.0.0.0/24

Salida:

AvailabilityZone : us-west-2c AvailableIpAddressCount : 251 CidrBlock : 10.0.0.0/24 DefaultForAz : False MapPublicIpOnLaunch : False State : pending SubnetId : subnet-1a2b3c4d Tag : {} VpcId : vpc-12345678
  • Para obtener información sobre la API, consulte CreateSubnet en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Tag.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se añade una etiqueta única al recurso especificado. La clave de la etiqueta es «myTag» y el valor de la etiqueta es «myTagValue». La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

New-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag"; Value="myTagValue" }

Ejemplo 2: En este ejemplo se actualizan o añaden las etiquetas especificadas al recurso especificado. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

New-EC2Tag -Resource i-12345678 -Tag @( @{ Key="myTag"; Value="newTagValue" }, @{ Key="test"; Value="anotherTagValue" } )

Ejemplo 3: Con la versión 2 de PowerShell, debe usar New-Object para crear la etiqueta para el parámetro Tag.

$tag = New-Object Amazon.EC2.Model.Tag $tag.Key = "myTag" $tag.Value = "myTagValue" New-EC2Tag -Resource i-12345678 -Tag $tag
  • Para obtener información sobre la API, consulte CreateTags en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Volume.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea el volumen especificado.

New-EC2Volume -Size 50 -AvailabilityZone us-west-2a -VolumeType gp2

Salida:

Attachments : {} AvailabilityZone : us-west-2a CreateTime : 12/22/2015 1:42:07 AM Encrypted : False Iops : 150 KmsKeyId : Size : 50 SnapshotId : State : creating Tags : {} VolumeId : vol-12345678 VolumeType : gp2

Ejemplo 2: Esta solicitud de ejemplo crea un volumen y aplica una etiqueta con una clave de pila y un valor de producción.

$tag = @{ Key="stack"; Value="production" } $tagspec = new-object Amazon.EC2.Model.TagSpecification $tagspec.ResourceType = "volume" $tagspec.Tags.Add($tag) New-EC2Volume -Size 80 -AvailabilityZone "us-west-2a" -TagSpecification $tagspec
  • Para obtener información sobre la API, consulte CreateVolume en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Vpc.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una VPC con el CIDR especificado. Amazon VPC también crea lo siguiente para la VPC: un conjunto de opciones de DHCP predeterminado, una tabla de enrutamiento principal y una ACL de red predeterminada.

New-EC2VPC -CidrBlock 10.0.0.0/16

Salida:

CidrBlock : 10.0.0.0/16 DhcpOptionsId : dopt-1a2b3c4d InstanceTenancy : default IsDefault : False State : pending Tags : {} VpcId : vpc-12345678
  • Para obtener información sobre la API, consulte CreateVpc en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2VpcEndpoint.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un nuevo punto de conexión de VPC para el servicio com.amazonaws.eu-west-1.s3 en la VPC vpc-0fc1ff23f45b678eb

New-EC2VpcEndpoint -ServiceName com.amazonaws.eu-west-1.s3 -VpcId vpc-0fc1ff23f45b678eb

Salida:

ClientToken VpcEndpoint ----------- ----------- Amazon.EC2.Model.VpcEndpoint
  • Para obtener información sobre la API, consulte CreateVpcEndpoint en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2VpnConnection.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una conexión VPN entre la puerta de enlace privada virtual especificada y la puerta de enlace de cliente especificada. La salida incluye la información de configuración que el administrador de red necesita en formato XML.

New-EC2VpnConnection -Type ipsec.1 -CustomerGatewayId cgw-1a2b3c4d -VpnGatewayId vgw-1a2b3c4d

Salida:

CustomerGatewayConfiguration : [XML document] CustomerGatewayId : cgw-1a2b3c4d Options : Routes : {} State : pending Tags : {} Type : VgwTelemetry : {} VpnConnectionId : vpn-12345678 VpnGatewayId : vgw-1a2b3c4d

Ejemplo 2: En este ejemplo se crea la conexión VPN y se captura la configuración en un archivo con el nombre especificado.

(New-EC2VpnConnection -CustomerGatewayId cgw-1a2b3c4d -VpnGatewayId vgw-1a2b3c4d).CustomerGatewayConfiguration | Out-File C:\path\vpn-configuration.xml

Ejemplo 3: En este ejemplo se crea una conexión VPN, con enrutamiento estático, entre la puerta de enlace privada virtual especificada y la puerta de enlace de cliente especificada.

New-EC2VpnConnection -Type ipsec.1 -CustomerGatewayId cgw-1a2b3c4d -VpnGatewayId vgw-1a2b3c4d -Options_StaticRoutesOnly $true
  • Para obtener información sobre la API, consulte CreateVpnConnection en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2VpnConnectionRoute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea la ruta estática especificada para la conexión VPN especificada.

New-EC2VpnConnectionRoute -VpnConnectionId vpn-12345678 -DestinationCidrBlock 11.12.0.0/16
  • Para obtener información sobre la API, consulte CreateVpnConnectionRoute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2VpnGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea la puerta de enlace privada virtual especificada.

New-EC2VpnGateway -Type ipsec.1

Salida:

AvailabilityZone : State : available Tags : {} Type : ipsec.1 VpcAttachments : {} VpnGatewayId : vgw-1a2b3c4d
  • Para obtener información sobre la API, consulte CreateVpnGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2Address.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia la dirección IP elástica especificada con la instancia especificada en una VPC.

C:\> Register-EC2Address -InstanceId i-12345678 -AllocationId eipalloc-12345678

Salida:

eipassoc-12345678

Ejemplo 2: En este ejemplo se asocia la dirección IP elástica especificada con la instancia especificada en EC2-Classic.

C:\> Register-EC2Address -InstanceId i-12345678 -PublicIp 203.0.113.17
  • Para obtener información sobre la API, consulte AssociateAddress en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2DhcpOption.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia el conjunto de opciones de DHCP especificado a la VPC especificada.

Register-EC2DhcpOption -DhcpOptionsId dopt-1a2b3c4d -VpcId vpc-12345678

Ejemplo 2: En este ejemplo se asocia el conjunto de opciones de DHCP predeterminado a la VPC especificada.

Register-EC2DhcpOption -DhcpOptionsId default -VpcId vpc-12345678
  • Para obtener información sobre la API, consulte AssociateDhcpOptions en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2Image.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se registra una AMI mediante el archivo de manifiesto especificado en Amazon S3.

Register-EC2Image -ImageLocation amzn-s3-demo-bucket/my-web-server-ami/image.manifest.xml -Name my-web-server-ami
  • Para obtener información sobre la API, consulte RegisterImage en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2PrivateIpAddress.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asigna la dirección IP privada secundaria especificada a la interfaz de red especificada.

Register-EC2PrivateIpAddress -NetworkInterfaceId eni-1a2b3c4d -PrivateIpAddress 10.0.0.82

Ejemplo 2: En este ejemplo se asignan dos direcciones IP privadas secundarias a la interfaz de red especificada.

Register-EC2PrivateIpAddress -NetworkInterfaceId eni-1a2b3c4d -SecondaryPrivateIpAddressCount 2
  • Para obtener información sobre la API, consulte AssignPrivateIpAddresses en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2RouteTable.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia la tabla de enrutamiento especificada a la subred especificada.

Register-EC2RouteTable -RouteTableId rtb-1a2b3c4d -SubnetId subnet-1a2b3c4d

Salida:

rtbassoc-12345678
  • Para obtener información sobre la API, consulte AssociateRouteTable en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Address.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se publica la dirección IP elástica especificada para las instancias de una VPC.

Remove-EC2Address -AllocationId eipalloc-12345678 -Force

Ejemplo 2: En este ejemplo se publica la dirección IP elástica especificada para las instancias de EC2-Classic.

Remove-EC2Address -PublicIp 198.51.100.2 -Force
  • Para obtener información sobre la API, consulte ReleaseAddress en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2CapacityReservation.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se cancela la reserva de capacidad cr-0c1f2345db6f7cdba

Remove-EC2CapacityReservation -CapacityReservationId cr-0c1f2345db6f7cdba

Salida:

Confirm Are you sure you want to perform this action? Performing the operation "Remove-EC2CapacityReservation (CancelCapacityReservation)" on target "cr-0c1f2345db6f7cdba". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y True
  • Para obtener información sobre la API, consulte CancelCapacityReservation en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2CustomerGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la puerta de enlace de cliente especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2CustomerGateway -CustomerGatewayId cgw-1a2b3c4d

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2CustomerGateway (DeleteCustomerGateway)" on Target "cgw-1a2b3c4d". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteCustomerGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2DhcpOption.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el conjunto de opciones de DHCP especificado. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2DhcpOption -DhcpOptionsId dopt-1a2b3c4d

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2DhcpOption (DeleteDhcpOptions)" on Target "dopt-1a2b3c4d". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteDhcpOptions en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2FlowLog.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el FlowLogId fl-01a2b3456a789c01 especificado.

Remove-EC2FlowLog -FlowLogId fl-01a2b3456a789c01

Salida:

Confirm Are you sure you want to perform this action? Performing the operation "Remove-EC2FlowLog (DeleteFlowLogs)" on target "fl-01a2b3456a789c01". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
  • Para obtener información sobre la API, consulte DeleteFlowLogs en la Referencia de cmdlets de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Host.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se publica el ID de host especificado h-0badafd1dcb2f3456.

Remove-EC2Host -HostId h-0badafd1dcb2f3456

Salida:

Confirm Are you sure you want to perform this action? Performing the operation "Remove-EC2Host (ReleaseHosts)" on target "h-0badafd1dcb2f3456". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y Successful Unsuccessful ---------- ------------ {h-0badafd1dcb2f3456} {}
  • Para obtener información sobre la API, consulte ReleaseHosts en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Instance.

Herramientas para PowerShell V4

Ejemplo 1: Este ejemplo finaliza la instancia especificada (la instancia puede estar en ejecución o en estado “detenido”). El cmdlet pedirá confirmación antes de continuar con la operación; para suprimir la confirmación, utilice el modificador -Force.

Remove-EC2Instance -InstanceId i-12345678

Salida:

CurrentState InstanceId PreviousState ------------ ---------- ------------- Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState
  • Para obtener información sobre la API, consulte TerminateInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2InternetGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la puerta de enlace de Internet especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2InternetGateway (DeleteInternetGateway)" on Target "igw-1a2b3c4d". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteInternetGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2KeyPair.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el par de claves especificado. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2KeyPair -KeyName my-key-pair

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2KeyPair (DeleteKeyPair)" on Target "my-key-pair". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteKeyPair en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2NetworkAcl.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la ACL de red especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2NetworkAcl -NetworkAclId acl-12345678

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2NetworkAcl (DeleteNetworkAcl)" on Target "acl-12345678". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteNetworkAcl en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2NetworkAclEntry.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la regla especificada de la ACL de red especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2NetworkAclEntry -NetworkAclId acl-12345678 -Egress $false -RuleNumber 100

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2NetworkAclEntry (DeleteNetworkAclEntry)" on Target "acl-12345678". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteNetworkAclEntry en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2NetworkInterface.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la interfaz de red especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2NetworkInterface -NetworkInterfaceId eni-12345678

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2NetworkInterface (DeleteNetworkInterface)" on Target "eni-12345678". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteNetworkInterface en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2PlacementGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el grupo de ubicación especificado. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2PlacementGroup -GroupName my-placement-group

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2PlacementGroup (DeletePlacementGroup)" on Target "my-placement-group". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeletePlacementGroup en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Route.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la ruta especificada de la tabla de enrutamiento especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2Route -RouteTableId rtb-1a2b3c4d -DestinationCidrBlock 0.0.0.0/0

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2Route (DeleteRoute)" on Target "rtb-1a2b3c4d". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteRoute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2RouteTable.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la tabla de enrutamiento especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2RouteTable -RouteTableId rtb-1a2b3c4d

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2RouteTable (DeleteRouteTable)" on Target "rtb-1a2b3c4d". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteRouteTable en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2SecurityGroup.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el grupo de seguridad especificado para EC2-VPC. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2SecurityGroup -GroupId sg-12345678

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2SecurityGroup (DeleteSecurityGroup)" on Target "sg-12345678". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):

Ejemplo 2: En este ejemplo se elimina el grupo de seguridad especificado para EC2-Classic.

Remove-EC2SecurityGroup -GroupName my-security-group -Force
  • Para obtener información sobre la API, consulte DeleteSecurityGroup en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Snapshot.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la instantánea especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2Snapshot -SnapshotId snap-12345678

Salida:

Confirm Are you sure you want to perform this action? Performing the operation "Remove-EC2Snapshot (DeleteSnapshot)" on target "snap-12345678". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteSnapshot en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2SpotDatafeedSubscription.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la fuente de datos de la instancia de spot. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2SpotDatafeedSubscription

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2SpotDatafeedSubscription (DeleteSpotDatafeedSubscription)" on Target "". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteSpotDatafeedSubscription en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Subnet.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la subred especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2Subnet -SubnetId subnet-1a2b3c4d

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2Subnet (DeleteSubnet)" on Target "subnet-1a2b3c4d". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteSubnet en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Tag.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la etiqueta especificada del recurso especificado, independientemente del valor de la etiqueta. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

Remove-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag" } -Force

Ejemplo 2: En este ejemplo se elimina la etiqueta especificada del recurso especificado, pero solo si coincide el valor de la etiqueta. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

Remove-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag";Value="myTagValue" } -Force

Ejemplo 3: En este ejemplo se elimina la etiqueta especificada del recurso especificado, independientemente del valor de la etiqueta.

$tag = New-Object Amazon.EC2.Model.Tag $tag.Key = "myTag" Remove-EC2Tag -Resource i-12345678 -Tag $tag -Force

Ejemplo 4: En este ejemplo se elimina la etiqueta especificada del recurso especificado, pero solo si coincide el valor de la etiqueta.

$tag = New-Object Amazon.EC2.Model.Tag $tag.Key = "myTag" $tag.Value = "myTagValue" Remove-EC2Tag -Resource i-12345678 -Tag $tag -Force
  • Para obtener información sobre la API, consulte DeleteTags en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Volume.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se desconecta el volumen especificado. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2Volume -VolumeId vol-12345678

Salida:

Confirm Are you sure you want to perform this action? Performing the operation "Remove-EC2Volume (DeleteVolume)" on target "vol-12345678". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteVolume en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Vpc.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la VPC especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2Vpc -VpcId vpc-12345678

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2Vpc (DeleteVpc)" on Target "vpc-12345678". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteVpc en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2VpnConnection.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la conexión VPN especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2VpnConnection -VpnConnectionId vpn-12345678

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2VpnConnection (DeleteVpnConnection)" on Target "vpn-12345678". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteVpnConnection en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2VpnConnectionRoute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la ruta estática especificada de la conexión VPN especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2VpnConnectionRoute -VpnConnectionId vpn-12345678 -DestinationCidrBlock 11.12.0.0/16

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2VpnConnectionRoute (DeleteVpnConnectionRoute)" on Target "vpn-12345678". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteVpnConnectionRoute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2VpnGateway.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la puerta de enlace privada virtual especificada. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force.

Remove-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d

Salida:

Confirm Are you sure you want to perform this action? Performing operation "Remove-EC2VpnGateway (DeleteVpnGateway)" on Target "vgw-1a2b3c4d". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
  • Para obtener información sobre la API, consulte DeleteVpnGateway en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Request-EC2SpotFleet.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una solicitud de flota de spot en la zona de disponibilidad con el precio más bajo para el tipo de instancia especificado. Si su cuenta admite EC2-VPC únicamente, la flota de spot lanza las instancias de spot en la zona de disponibilidad con el precio más bajo que tenga una subred predeterminada. Si su cuenta admite EC2-Classic, la flota de spot lanza las instancias en EC2-Classic en la zona de disponibilidad con el precio más bajo. Tenga en cuenta que el precio que pague no superará el precio de spot especificado para la solicitud.

$sg = New-Object Amazon.EC2.Model.GroupIdentifier $sg.GroupId = "sg-12345678" $lc = New-Object Amazon.EC2.Model.SpotFleetLaunchSpecification $lc.ImageId = "ami-12345678" $lc.InstanceType = "m3.medium" $lc.SecurityGroups.Add($sg) Request-EC2SpotFleet -SpotFleetRequestConfig_SpotPrice 0.04 ` -SpotFleetRequestConfig_TargetCapacity 2 ` -SpotFleetRequestConfig_IamFleetRole arn:aws:iam::123456789012:role/my-spot-fleet-role ` -SpotFleetRequestConfig_LaunchSpecification $lc
  • Para obtener información sobre la API, consulte RequestSpotFleet en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Request-EC2SpotInstance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se solicita una instancia de spot única en la subred especificada. Tenga en cuenta que el grupo de seguridad debe crearse para la VPC que contiene la subred especificada y debe especificarse mediante un ID usando la interfaz de red. Si especifica una interfaz de red, debe incluir el ID de subred mediante la interfaz de red.

$n = New-Object Amazon.EC2.Model.InstanceNetworkInterfaceSpecification $n.DeviceIndex = 0 $n.SubnetId = "subnet-12345678" $n.Groups.Add("sg-12345678") Request-EC2SpotInstance -InstanceCount 1 -SpotPrice 0.050 -Type one-time ` -IamInstanceProfile_Arn arn:aws:iam::123456789012:instance-profile/my-iam-role ` -LaunchSpecification_ImageId ami-12345678 ` -LaunchSpecification_InstanceType m3.medium ` -LaunchSpecification_NetworkInterface $n

Salida:

ActualBlockHourlyPrice : AvailabilityZoneGroup : BlockDurationMinutes : 0 CreateTime : 12/26/2015 7:44:10 AM Fault : InstanceId : LaunchedAvailabilityZone : LaunchGroup : LaunchSpecification : Amazon.EC2.Model.LaunchSpecification ProductDescription : Linux/UNIX SpotInstanceRequestId : sir-12345678 SpotPrice : 0.050000 State : open Status : Amazon.EC2.Model.SpotInstanceStatus Tags : {} Type : one-time
  • Para obtener información sobre la API, consulte RequestSpotInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Reset-EC2ImageAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se restablece el atributo “launchPermission” en su valor predeterminado. De forma predeterminada, las AMI son privadas.

Reset-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission
  • Para obtener información sobre la API, consulte ResetImageAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Reset-EC2InstanceAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se restablece el atributo “sriovNetSupport” de la instancia especificada.

Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sriovNetSupport

Ejemplo 2: En este ejemplo se restablece el atributo “ebsOptimized” de la instancia especificada.

Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute ebsOptimized

Ejemplo 3: En este ejemplo se restablece el atributo “sourceDestCheck” de la instancia especificada.

Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sourceDestCheck

Ejemplo 4: En este ejemplo se restablece el atributo “disableApiTermination” de la instancia especificada.

Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute disableApiTermination

Ejemplo 5: En este ejemplo se restablece el atributo “instanceInitiatedShutdownBehavior” de la instancia especificada.

Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceInitiatedShutdownBehavior
  • Para obtener información sobre la API, consulte ResetInstanceAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Reset-EC2NetworkInterfaceAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se restablece la comprobación de origen/destino de la interfaz de red especificada.

Reset-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -SourceDestCheck
  • Para obtener información sobre la API, consulte ResetNetworkInterfaceAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Reset-EC2SnapshotAttribute.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se restablece el atributo especificado de la instantánea especificada.

Reset-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission
  • Para obtener información sobre la API, consulte ResetSnapshotAttribute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Restart-EC2Instance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se reinicia la instancia especificada.

Restart-EC2Instance -InstanceId i-12345678
  • Para obtener información sobre la API, consulte RebootInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Revoke-EC2SecurityGroupEgress.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la regla del grupo de seguridad especificado para EC2-VPC. Esto revoca el acceso en el puerto TCP 80 al intervalo de direcciones IP especificado. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

$ip = @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; IpRanges="203.0.113.0/24" } Revoke-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip

Ejemplo 2: Con la versión 2 de PowerShell, debe usar New-Object para crear cada objeto IpPermission.

$ip = New-Object Amazon.EC2.Model.IpPermission $ip.IpProtocol = "tcp" $ip.FromPort = 80 $ip.ToPort = 80 $ip.IpRanges.Add("203.0.113.0/24") Revoke-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip

Ejemplo 3: En este ejemplo se revoca el acceso al grupo de seguridad de origen especificado en el puerto TCP 80.

$ug = New-Object Amazon.EC2.Model.UserIdGroupPair $ug.GroupId = "sg-1a2b3c4d" $ug.UserId = "123456789012" Revoke-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission @( @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; UserIdGroupPairs=$ug } )
  • Para obtener información sobre la API, consulte RevokeSecurityGroupEgress en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Revoke-EC2SecurityGroupIngress.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se revoca el acceso al puerto TCP 22 desde el intervalo de direcciones especificado para el grupo de seguridad especificado para EC2-VPC. Además, debe identificar los grupos de seguridad de EC2-VPC mediante el ID del grupo de seguridad, en lugar del nombre del grupo de seguridad. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

$ip = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.0/24" } Revoke-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission $ip

Ejemplo 2: Con la versión 2 de PowerShell, debe usar New-Object para crear cada objeto IpPermission.

$ip = New-Object Amazon.EC2.Model.IpPermission $ip.IpProtocol = "tcp" $ip.FromPort = 22 $ip.ToPort = 22 $ip.IpRanges.Add("203.0.113.0/24") Revoke-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission $ip

Ejemplo 3: En este ejemplo se revoca el acceso al puerto TCP 22 desde el intervalo de direcciones especificado para el grupo de seguridad especificado para EC2-Classic. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

$ip = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.0/24" } Revoke-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission $ip

Ejemplo 4: Con la versión 2 de PowerShell, debe usar New-Object para crear cada objeto IpPermission.

$ip = New-Object Amazon.EC2.Model.IpPermission $ip.IpProtocol = "tcp" $ip.FromPort = 22 $ip.ToPort = 22 $ip.IpRanges.Add("203.0.113.0/24") Revoke-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission $ip
  • Para obtener información sobre la API, consulte RevokeSecurityGroupIngress en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Send-EC2InstanceStatus.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se registran los comentarios de estado de la instancia especificada.

Send-EC2InstanceStatus -Instance i-12345678 -Status impaired -ReasonCode unresponsive
  • Para obtener información sobre la API, consulte ReportInstanceStatus en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Set-EC2NetworkAclAssociation.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia la ACL de red especificada a la subred para la asociación de ACL de red especificada.

Set-EC2NetworkAclAssociation -NetworkAclId acl-12345678 -AssociationId aclassoc-1a2b3c4d

Salida:

aclassoc-87654321
  • Para obtener información sobre la API, consulte ReplaceNetworkAclAssociation en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Set-EC2NetworkAclEntry.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se reemplaza la entrada especificada para la ACL de red especificada. La nueva regla permite el tráfico entrante desde la dirección especificada a cualquier subred asociada.

Set-EC2NetworkAclEntry -NetworkAclId acl-12345678 -Egress $false -RuleNumber 100 -Protocol 17 -PortRange_From 53 -PortRange_To 53 -CidrBlock 203.0.113.12/24 -RuleAction allow
  • Para obtener información sobre la API, consulte ReplaceNetworkAclEntry en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Set-EC2Route.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se reemplaza la ruta especificada para la tabla de enrutamiento especificada. La nueva ruta envía el tráfico especificado a la puerta de enlace privada virtual especificada.

Set-EC2Route -RouteTableId rtb-1a2b3c4d -DestinationCidrBlock 10.0.0.0/24 -GatewayId vgw-1a2b3c4d
  • Para obtener información sobre la API, consulte ReplaceRoute en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Set-EC2RouteTableAssociation.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia la tabla de enrutamiento especificada a la subred para la asociación de tabla de enrutamiento especificada.

Set-EC2RouteTableAssociation -RouteTableId rtb-1a2b3c4d -AssociationId rtbassoc-12345678

Salida:

rtbassoc-87654321
  • Para obtener información sobre la API, consulte ReplaceRouteTableAssociation en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Start-EC2Instance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se inicia la instancia especificada.

Start-EC2Instance -InstanceId i-12345678

Salida:

CurrentState InstanceId PreviousState ------------ ---------- ------------- Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState

Ejemplo 2: En este ejemplo se inician las instancias especificadas.

@("i-12345678", "i-76543210") | Start-EC2Instance

Ejemplo 3: En este ejemplo se inicia el conjunto de instancias que están detenidas actualmente. Los objetos Instance devueltos por Get-EC2Instance se envían a Start-EC2Instance. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

(Get-EC2Instance -Filter @{ Name="instance-state-name"; Values="stopped"}).Instances | Start-EC2Instance

Ejemplo 4: Con la versión 2 de PowerShell, debe usar New-Object para crear el filtro del parámetro Filter.

$filter = New-Object Amazon.EC2.Model.Filter $filter.Name = "instance-state-name" $filter.Values = "stopped" (Get-EC2Instance -Filter $filter).Instances | Start-EC2Instance
  • Para obtener información sobre la API, consulte StartInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Start-EC2InstanceMonitoring.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se habilita la supervisión detallada de la instancia especificada.

Start-EC2InstanceMonitoring -InstanceId i-12345678

Salida:

InstanceId Monitoring ---------- ---------- i-12345678 Amazon.EC2.Model.Monitoring
  • Para obtener información sobre la API, consulte MonitorInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2ImportTask.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se cancela la tarea de importación especificada (importación de instantáneas o imágenes). Si es necesario, se puede proporcionar un motivo mediante el parámetro -CancelReason.

Stop-EC2ImportTask -ImportTaskId import-ami-abcdefgh
  • Para obtener información sobre la API, consulte CancelImportTask en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2Instance.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se detiene la instancia especificada.

Stop-EC2Instance -InstanceId i-12345678

Salida:

CurrentState InstanceId PreviousState ------------ ---------- ------------- Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState
  • Para obtener información sobre la API, consulte StopInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2InstanceMonitoring.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se deshabilita la supervisión detallada de la instancia especificada.

Stop-EC2InstanceMonitoring -InstanceId i-12345678

Salida:

InstanceId Monitoring ---------- ---------- i-12345678 Amazon.EC2.Model.Monitoring
  • Para obtener información sobre la API, consulte UnmonitorInstances en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2SpotFleetRequest.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se cancela la solicitud de flota de spot especificada y se terminan las instancias de spot asociadas.

Stop-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -TerminateInstance $true

Ejemplo 2: En este ejemplo se cancela la solicitud de flota de spot especificada sin que se terminan las instancias de spot asociadas.

Stop-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -TerminateInstance $false
  • Para obtener información sobre la API, consulte CancelSpotFleetRequests en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2SpotInstanceRequest.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se cancela la solicitud de instancia de spot especificada.

Stop-EC2SpotInstanceRequest -SpotInstanceRequestId sir-12345678

Salida:

SpotInstanceRequestId State --------------------- ----- sir-12345678 cancelled
  • Para obtener información sobre la API, consulte CancelSpotInstanceRequests en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-EC2Address.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se desvincula la dirección IP elástica especificada de la instancia especificada en una VPC.

Unregister-EC2Address -AssociationId eipassoc-12345678

Ejemplo 2: En este ejemplo se desvincula la dirección IP elástica especificada de la instancia especificada en EC2-Classic.

Unregister-EC2Address -PublicIp 203.0.113.17
  • Para obtener información sobre la API, consulte DisassociateAddress en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-EC2Image.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se anula el registro de la AMI especificada.

Unregister-EC2Image -ImageId ami-12345678
  • Para obtener información sobre la API, consulte DeregisterImage en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-EC2PrivateIpAddress.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se anula la asignación de la dirección IP privada especificada de la interfaz de red especificada.

Unregister-EC2PrivateIpAddress -NetworkInterfaceId eni-1a2b3c4d -PrivateIpAddress 10.0.0.82
  • Para obtener información sobre la API, consulte UnassignPrivateIpAddresses en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-EC2RouteTable.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la asociación especificada entre una tabla de enrutamiento y una subred.

Unregister-EC2RouteTable -AssociationId rtbassoc-1a2b3c4d
  • Para obtener información sobre la API, consulte DisassociateRouteTable en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-EC2SecurityGroupRuleIngressDescription.

Herramientas para PowerShell V4

Ejemplo 1: Actualiza la descripción de una regla del grupo de seguridad de entrada existente.

$existingInboundRule = Get-EC2SecurityGroupRule -SecurityGroupRuleId "sgr-1234567890" $ruleWithUpdatedDescription = [Amazon.EC2.Model.SecurityGroupRuleDescription]@{ "SecurityGroupRuleId" = $existingInboundRule.SecurityGroupRuleId "Description" = "Updated rule description" } Update-EC2SecurityGroupRuleIngressDescription -GroupId $existingInboundRule.GroupId -SecurityGroupRuleDescription $ruleWithUpdatedDescription

Ejemplo 2: Elimina la descripción de una regla de grupo de seguridad de entrada (entrante) existente (omitiendo el parámetro de la solicitud).

$existingInboundRule = Get-EC2SecurityGroupRule -SecurityGroupRuleId "sgr-1234567890" $ruleWithoutDescription = [Amazon.EC2.Model.SecurityGroupRuleDescription]@{ "SecurityGroupRuleId" = $existingInboundRule.SecurityGroupRuleId } Update-EC2SecurityGroupRuleIngressDescription -GroupId $existingInboundRule.GroupId -SecurityGroupRuleDescription $ruleWithoutDescription