¡Se Herramientas de AWS para PowerShell ha lanzado la versión 5 (V5) del!
Para obtener información sobre los cambios más importantes y la migración de sus aplicaciones, consulte el tema sobre migración.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
EC2 Ejemplos de Amazon que utilizan Tools for PowerShell V5
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la Herramientas de AWS para PowerShell V5 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.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2CapacityReservation.
- Herramientas para la PowerShell V5
-
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 WindowsSalida:
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 más información sobre la API, consulte CreateCapacityReservationla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2InternetGateway.
- Herramientas para la versión 5 PowerShell
-
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-12345678Ejemplo 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 más información sobre la API, consulte AttachInternetGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2NetworkInterface.
- Herramientas para la versión 5 PowerShell
-
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 1Salida:
eni-attach-1a2b3c4d-
Para obtener más información sobre la API, consulte AttachNetworkInterfacela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2Volume.
- Herramientas para la versión 5 PowerShell
-
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/sdhSalida:
AttachTime : 12/22/2015 1:53:58 AM DeleteOnTermination : False Device : /dev/sdh InstanceId : i-1a2b3c4d State : attaching VolumeId : vol-12345678-
Para obtener más información sobre la API, consulte AttachVolumela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Add-EC2VpnGateway.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
State VpcId ----- ----- attaching vpc-12345678-
Para obtener más información sobre la API, consulte AttachVpnGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Approve-EC2VpcPeeringConnection.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo aprueba el pcx-1dfad234b56ff78be solicitado VpcPeeringConnectionId
Approve-EC2VpcPeeringConnection -VpcPeeringConnectionId pcx-1dfad234b56ff78beSalida:
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 Cmdlet Reference (V5). AcceptVpcPeeringConnectionHerramientas de AWS para PowerShell
-
En el siguiente ejemplo de código, se muestra cómo utilizar Confirm-EC2ProductInstance.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte ConfirmProductInstancela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Copy-EC2Image.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte CopyImagela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Copy-EC2Snapshot.
- Herramientas para la versión 5 PowerShell
-
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-2Ejemplo 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 más información sobre la API, consulte CopySnapshotla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Deny-EC2VpcPeeringConnection.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: El ejemplo anterior deniega la solicitud del identificador de solicitud VpcPeering pcx-01a2b3ce45fe67eb8
Deny-EC2VpcPeeringConnection -VpcPeeringConnectionId pcx-01a2b3ce45fe67eb8-
Para obtener información RejectVpcPeeringConnectionsobre Herramientas de AWS para PowerShell la API, consulte Cmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Disable-EC2VgwRoutePropagation.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte DisableVgwRoutePropagationla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Disable-EC2VpcClassicLink.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo se desactiva EC2 VpcClassicLink para el vpc-01e23c4a5d6db78e9. Devuelve True o False
Disable-EC2VpcClassicLink -VpcId vpc-01e23c4a5d6db78e9-
Herramientas de AWS para PowerShell Para obtener información sobre DisableVpcClassicLinkla API, consulte Cmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Disable-EC2VpcClassicLinkDnsSupport.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo deshabilita la compatibilidad con ClassicLink DNS para el vpc-0b12d3456a7e8910d
Disable-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d-
Para obtener más información DisableVpcClassicLinkDnsSupportsobre Herramientas de AWS para PowerShell la API, consulte Cmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Dismount-EC2InternetGateway.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte DetachInternetGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Dismount-EC2NetworkInterface.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte DetachNetworkInterfacela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Dismount-EC2Volume.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se desconecta el volumen especificado.
Dismount-EC2Volume -VolumeId vol-12345678Salida:
AttachTime : 12/22/2015 1:53:58 AM DeleteOnTermination : False Device : /dev/sdh InstanceId : i-1a2b3c4d State : detaching VolumeId : vol-12345678Ejemplo 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 más información sobre la API, consulte DetachVolumela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Dismount-EC2VpnGateway.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte DetachVpnGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2CapacityReservation.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo modifica el CapacityReservationId cr-0c1f2345db6f7cdba cambiando el recuento de instancias a 1
Edit-EC2CapacityReservation -CapacityReservationId cr-0c1f2345db6f7cdba -InstanceCount 1Salida:
True-
Para obtener más ModifyCapacityReservationinformación sobre Herramientas de AWS para PowerShell la API, consulte Cmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2Host.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo modifica la AutoPlacement configuración a desactivada para el host dedicado h-01e23f4cd567890f3
Edit-EC2Host -HostId h-03e09f8cd681609f3 -AutoPlacement offSalida:
Successful Unsuccessful ---------- ------------ {h-01e23f4cd567890f3} {}-
Para obtener más ModifyHostsinformación sobre Herramientas de AWS para PowerShell la API, consulte Cmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2IdFormat.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se habilita el formato de ID largo para el recurso especificado.
Edit-EC2IdFormat -Resource instance -UseLongId $trueEjemplo 2: En este ejemplo se deshabilita el formato de ID largo para el recurso especificado.
Edit-EC2IdFormat -Resource instance -UseLongId $false-
Para obtener más información sobre la API, consulte ModifyIdFormatla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2ImageAttribute.
- Herramientas para la versión 5 PowerShell
-
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 cualquiera Cuenta de AWS pueda utilizarla).
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup allEjemplo 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 allEjemplo 4: en este ejemplo se concede el permiso de lanzamiento a la persona especificada Cuenta de AWS.
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333Ejemplo 5: en este ejemplo se elimina el permiso de lanzamiento del especificado Cuenta de AWS.
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333-
Para obtener más información sobre la API, consulte ModifyImageAttribute Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2InstanceAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se modifica el tipo de instancia de la instancia especificada.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.mediumEjemplo 2: Este ejemplo permite mejorar las redes para la instancia especificada, especificando «simple» como el valor del parámetro de soporte de red de I/O virtualización 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: Este ejemplo permite la I/O optimización 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 $trueEjemplo 5: Este ejemplo permite source/destination comprobar la instancia especificada. Para que una instancia de NAT se ejecute, el valor debe ser “false'.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $trueEjemplo 6: En este ejemplo se deshabilita la terminación de la instancia especificada.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $trueEjemplo 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 Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2InstanceCreditSpecification.
- Herramientas para la versión 5 PowerShell
-
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-
Para obtener más información sobre la API, consulte ModifyInstanceCreditSpecificationla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2NetworkInterfaceAttribute.
- Herramientas para la versión 5 PowerShell
-
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 $trueEjemplo 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-1a2b3c4dEjemplo 4: En este ejemplo se deshabilita la source/destination comprobación de la interfaz de red especificada.
Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -SourceDestCheck $false-
Para obtener más información sobre la API, consulte ModifyNetworkInterfaceAttribute Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2ReservedInstance.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte ModifyReservedInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2SnapshotAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo, se hace pública la instantánea especificada mediante la configuración de su CreateVolumePermission atributo.
Edit-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission -OperationType Add -GroupName all-
Para obtener más información sobre la API, consulte ModifySnapshotAttribute Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2SpotFleetRequest.
- Herramientas para la versión 5 PowerShell
-
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 10Salida:
True-
Para obtener más información sobre la API, consulte ModifySpotFleetRequestla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2SubnetAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se habilita el direccionamiento IP público para la subred especificada.
Edit-EC2SubnetAttribute -SubnetId subnet-1a2b3c4d -MapPublicIpOnLaunch $trueEjemplo 2: En este ejemplo se deshabilita el direccionamiento IP público para la subred especificada.
Edit-EC2SubnetAttribute -SubnetId subnet-1a2b3c4d -MapPublicIpOnLaunch $false-
Para obtener más información sobre la API, consulte ModifySubnetAttributela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2VolumeAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo modifica el atributo especificado del volumen especificado. I/O Las operaciones del volumen se reanudan automáticamente tras su suspensión debido a la posible incoherencia de los datos.
Edit-EC2VolumeAttribute -VolumeId vol-12345678 -AutoEnableIO $true-
Para obtener más información sobre la API, consulte ModifyVolumeAttributela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Edit-EC2VpcAttribute.
- Herramientas para la versión 5 PowerShell
-
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 $trueEjemplo 2: En este ejemplo se deshabilita la compatibilidad con los nombres de host DNS para la VPC especificada.
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsHostnames $falseEjemplo 3: En este ejemplo se habilita la compatibilidad con la resolución DNS para la VPC especificada.
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsSupport $trueEjemplo 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 más información sobre la API, consulte ModifyVpcAttributela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Enable-EC2VgwRoutePropagation.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte EnableVgwRoutePropagationla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Enable-EC2VolumeIO.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo habilita I/O las operaciones para el volumen especificado, si I/O las operaciones estaban deshabilitadas.
Enable-EC2VolumeIO -VolumeId vol-12345678-
Para obtener más información sobre la API, consulte EnableVolumeIo Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Enable-EC2VpcClassicLink.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo habilita la VPC vpc-0123456b789b0d12f para ClassicLink
Enable-EC2VpcClassicLink -VpcId vpc-0123456b789b0d12fSalida:
True-
Para obtener información sobre la API, consulte Cmdlet Reference (V5). EnableVpcClassicLinkHerramientas de AWS para PowerShell
-
En el siguiente ejemplo de código, se muestra cómo utilizar Enable-EC2VpcClassicLinkDnsSupport.
- Herramientas para la versión 5 PowerShell
-
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 más EnableVpcClassicLinkDnsSupportinformación sobre Herramientas de AWS para PowerShell la API, consulte Cmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2AccountAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: en este ejemplo se describe si puede lanzar instancias en EC2 -Classic y EC2 -VPC en la región, o solo en -VPC. EC2
(Get-EC2AccountAttribute -AttributeName supported-platforms).AttributeValuesSalida:
AttributeValue -------------- EC2 VPCEjemplo 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).AttributeValuesSalida:
AttributeValue -------------- vpc-12345678Ejemplo 3: En este ejemplo se describe el número máximo de instancias bajo demanda que puede ejecutar.
(Get-EC2AccountAttribute -AttributeName max-instances).AttributeValuesSalida:
AttributeValue -------------- 20-
Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet Reference (DescribeAccountAttributesV5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Address.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: en este ejemplo se describe la dirección IP elástica especificada para las instancias de EC2 -Classic.
Get-EC2Address -AllocationId eipalloc-12345678Salida:
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.2Ejemplo 2: En este ejemplo se describen las direcciones IP elásticas para las instancias de una VPC. Esta sintaxis requiere la PowerShell versión 3 o posterior.
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.17Salida:
AllocationId : AssociationId : Domain : standard InstanceId : i-12345678 NetworkInterfaceId : NetworkInterfaceOwnerId : PrivateIpAddress : PublicIp : 203.0.113.17Ejemplo 4: En este ejemplo, se describen las direcciones IP elásticas para las instancias de EC2 -Classic. Esta sintaxis requiere la PowerShell versión 3 o posterior.
Get-EC2Address -Filter @{ Name="domain";Values="standard" }Ejemplo 5: En este ejemplo se describen todas las direcciones IP elásticas.
Get-EC2AddressEjemplo 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, PublicIpSalida:
PrivateIpAddress PublicIp ---------------- -------- 10.0.0.99 63.36.5.227Ejemplo 7: Este ejemplo recupera todo el Elastic IPs 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, PublicIpSalida:
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.270Ejemplo 8: Este ejemplo busca una lista de direcciones EC2 IP que coinciden con la clave de etiqueta «Categoría» 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 más información sobre la API, consulte DescribeAddresses Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2AvailabilityZone.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describen las zonas de disponibilidad de la región actual que están disponibles.
Get-EC2AvailabilityZoneSalida:
Messages RegionName State ZoneName -------- ---------- ----- -------- {} us-west-2 available us-west-2a {} us-west-2 available us-west-2b {} us-west-2 available us-west-2cEjemplo 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 PowerShell versión 3 o superior.
Get-EC2AvailabilityZone -Filter @{ Name="state";Values="impaired" }Ejemplo 3: Con la PowerShell versión 2, debe usar New-Object para crear el filtro.
$filter = New-Object Amazon.EC2.Model.Filter $filter.Name = "state" $filter.Values = "impaired" Get-EC2AvailabilityZone -Filter $filter-
Para obtener más información sobre la API, consulte DescribeAvailabilityZones Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2BundleTask.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la tarea de agrupación especificada.
Get-EC2BundleTask -BundleId bun-12345678Ejemplo 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 más información sobre la API, consulte DescribeBundleTasksla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2CapacityReservation.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe una o varias de sus reservas de capacidad para la región
Get-EC2CapacityReservation -Region eu-west-1Salida:
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 más información sobre la API, consulte DescribeCapacityReservationsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ConsoleOutput.
- Herramientas para la versión 5 PowerShell
-
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-0e19abcd47c123456Salida:
InstanceId Output ---------- ------ i-0e194d3c47c123637 WyAgICAwLjAwMDAwMF0gQ29tbW...bGU9dHR5UzAgc2VsEjemplo 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 más información sobre la API, consulte GetConsoleOutputla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2CustomerGateway.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la puerta de enlace de cliente especificada.
Get-EC2CustomerGateway -CustomerGatewayId cgw-1a2b3c4dSalida:
BgpAsn : 65534 CustomerGatewayId : cgw-1a2b3c4d IpAddress : 203.0.113.12 State : available Tags : {} Type : ipsec.1Ejemplo 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 $filterEjemplo 3: En este ejemplo se describen sus puertas de enlace de cliente.
Get-EC2CustomerGateway-
Para obtener más información sobre la API, consulte DescribeCustomerGatewaysla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2DhcpOption.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se muestran los conjuntos de opciones de DHCP.
Get-EC2DhcpOptionSalida:
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).DhcpConfigurationsSalida:
Key Values --- ------ domain-name {abc.local} domain-name-servers {10.0.0.101, 10.0.0.102}-
Para obtener más información sobre la API, consulte DescribeDhcpOptionsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2FlowLog.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte DescribeFlowLogsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Host.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo devuelve los detalles del EC2 host
Get-EC2HostSalida:
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 servidor AvailableInstanceCapacity h-01e23f4cd567899f1
Get-EC2Host -HostId h-01e23f4cd567899f1 | Select-Object -ExpandProperty AvailableCapacity | Select-Object -expand AvailableInstanceCapacitySalida:
AvailableCapacity InstanceType TotalCapacity ----------------- ------------ ------------- 11 m4.xlarge 11-
Para obtener información sobre la API, consulte Cmdlet Reference (V5). DescribeHostsHerramientas de AWS para PowerShell
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2HostReservationOffering.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describen las reservas de hosts dedicados que se pueden adquirir para el filtro «familia de instancias» determinado, donde está «» PaymentOption NoUpfront
Get-EC2HostReservationOffering -Filter @{Name="instance-family";Values="m4"} | Where-Object PaymentOption -eq NoUpfrontSalida:
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-
Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DescribeHostReservationOfferingsReference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2HostReservationPurchasePreview.
- Herramientas para la versión 5 PowerShell
-
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-01e23f4cd567890f1Salida:
CurrencyCode Purchase TotalHourlyPrice TotalUpfrontPrice ------------ -------- ---------------- ----------------- {} 1.307 0.000-
Para obtener más información sobre la API, consulte GetHostReservationPurchasePreviewla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2IdFormat.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el formato de ID del tipo de recurso especificado.
Get-EC2IdFormat -Resource instanceSalida:
Resource UseLongIds -------- ---------- instance FalseEjemplo 2: en este ejemplo se describen los formatos de ID de todos los tipos de recursos que admiten versiones más largas IDs.
Get-EC2IdFormatSalida:
Resource UseLongIds -------- ---------- reservation False instance False-
Para obtener información sobre la API, consulte DescribeIdFormat Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2IdentityIdFormat.
- Herramientas para la versión 5 PowerShell
-
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 imageSalida:
Deadline Resource UseLongIds -------- -------- ---------- 8/2/2018 11:30:00 PM image True-
Para obtener más información sobre la API, consulte DescribeIdentityIdFormatla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Image.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la AMI especificada.
Get-EC2Image -ImageId ami-12345678Salida:
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 : hvmEjemplo 2: Este ejemplo describe lo AMIs que tienes.
Get-EC2Image -owner selfEjemplo 3: En este ejemplo se describe el público AMIs que ejecuta Microsoft Windows Server.
Get-EC2Image -Filter @{ Name="platform"; Values="windows" }Ejemplo 4: En este ejemplo se describen todos los públicos AMIs de la región «us-west-2".
Get-EC2Image -Region us-west-2-
Para obtener más información sobre la API, consulte DescribeImages Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ImageAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se obtiene la descripción de la AMI especificada.
Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute descriptionSalida:
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 launchPermissionSalida:
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 sriovNetSupportSalida:
BlockDeviceMappings : {} Description : ImageId : ami-12345678 KernelId : LaunchPermissions : {} ProductCodes : {} RamdiskId : SriovNetSupport : simple-
Para obtener más información sobre la API, consulte DescribeImageAttributela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ImportImageTask.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la tarea de importación de imágenes especificada.
Get-EC2ImportImageTask -ImportTaskId import-ami-hgfedcbaSalida:
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-EC2ImportImageTaskSalida:
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 más información sobre la API, consulte DescribeImportImageTasksla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ImportSnapshotTask.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la tarea de importación de instantáneas especificada.
Get-EC2ImportSnapshotTask -ImportTaskId import-snap-abcdefghSalida:
Description ImportTaskId SnapshotTaskDetail ----------------- -------------------- ------------------ Disk Image Import 1 import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetailEjemplo 2: En este ejemplo se describen todas las tareas de importación de instantáneas.
Get-EC2ImportSnapshotTaskSalida:
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 más información sobre la API, consulte DescribeImportSnapshotTasksla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Instance.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la instancia especificada.
(Get-EC2Instance -InstanceId i-12345678).InstancesSalida:
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-12345678Ejemplo 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-EC2InstanceSalida:
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 EC2 instancias en una subred específica de una VPC.
(Get-EC2Instance -Filter @{Name="vpc-id";Values="vpc-1a2bc34d"},@{Name="subnet-id";Values="subnet-1a2b3c4d"}).InstancesSalida:
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-1a2b3c4dEjemplo 4: Este ejemplo ilustra el uso de un filtro con varios valores para consultar EC2 instancias que están en ejecución y detenidas
$InstanceParams = @{ Filter = @( @{'Name' = 'instance-state-name';'Values' = @("running","stopped")} ) } (Get-EC2Instance @InstanceParams).InstancesSalida:
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-1a2b3c4dEjemplo 5: En este ejemplo, se ilustra el uso de un filtro con varios valores para consultar EC2 instancias que están en ejecución y detenidas, y el uso del cmdlet Select-Object para elegir valores específicos para su 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 -AutoSizeSalida:
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 stoppedEjemplo 6: en este ejemplo se validan los permisos para obtener EC2 instancias que utilizan el DryRun parámetro sin obtenerlas realmente. Nota: Si se realiza correctamente, se produce una excepción, que es el comportamiento esperado.
Get-EC2Tag -DryRun $trueSalida:
Get-EC2Instance: Request would have succeeded, but DryRun flag is set.-
Para obtener más información sobre la API, consulte DescribeInstances Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2InstanceAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el tipo de instancia de la instancia especificada.
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceTypeSalida:
InstanceType : t2.microEjemplo 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 sriovNetSupportSalida:
SriovNetSupport : simpleEjemplo 3: En este ejemplo se describen los grupos de seguridad para la instancia especificada.
(Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute groupSet).GroupsSalida:
GroupId ------- sg-12345678 sg-45678901Ejemplo 4: En este ejemplo se describe si la optimización de EBS está habilitada para la instancia especificada.
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute ebsOptimizedSalida:
EbsOptimized : FalseEjemplo 5: en este ejemplo se describe el atributo disableApiTermination '' de la instancia especificada.
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute disableApiTerminationSalida:
DisableApiTermination : FalseEjemplo 6: En este ejemplo se describe el atributo 'instanceInitiatedShutdownBehavior' de la instancia especificada.
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceInitiatedShutdownBehaviorSalida:
InstanceInitiatedShutdownBehavior : stop-
Para obtener más información sobre la API, consulte DescribeInstanceAttribute Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2InstanceMetadata.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Se muestran las categorías disponibles de metadatos de instancia que se pueden consultar.
Get-EC2InstanceMetadata -ListCategorySalida:
AmiId LaunchIndex ManifestPath AncestorAmiId BlockDeviceMapping InstanceId InstanceType LocalHostname LocalIpv4 KernelId AvailabilityZone ProductCode PublicHostname PublicIpv4 PublicKey RamdiskId Region ReservationId SecurityGroup UserData InstanceMonitoring IdentityDocument IdentitySignature IdentityPkcs7Ejemplo 2: Se devuelve el ID de la Imagen de máquina de Amazon (AMI) que se utilizó para lanzar la instancia.
Get-EC2InstanceMetadata -Category AmiIdSalida:
ami-b2e756caEjemplo 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 hay un rol de IAM asociado a la instancia, devuelve información sobre la última vez que se actualizó el perfil de la instancia, incluida la LastUpdated fecha de la instancia InstanceProfileArn, y. InstanceProfileId
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 más información sobre la API, consulte Get-EC2InstanceMetadata Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2InstanceStatus.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el estado de la instancia especificada.
Get-EC2InstanceStatus -InstanceId i-12345678Salida:
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.InstanceStateSalida:
Code Name ---- ---- 16 running$status.StatusSalida:
Details Status ------- ------ {reachability} ok$status.SystemStatusSalida:
Details Status ------- ------ {reachability} ok-
Para obtener más información sobre la API, consulte DescribeInstanceStatusla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2InternetGateway.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la puerta de enlace de Internet especificada.
Get-EC2InternetGateway -InternetGatewayId igw-1a2b3c4dSalida:
Attachments InternetGatewayId Tags ----------- ----------------- ---- {vpc-1a2b3c4d} igw-1a2b3c4d {}Ejemplo 2: En este ejemplo se describen todas las puertas de enlace de Internet.
Get-EC2InternetGatewaySalida:
Attachments InternetGatewayId Tags ----------- ----------------- ---- {vpc-1a2b3c4d} igw-1a2b3c4d {} {} igw-2a3b4c5d {}-
Para obtener más información sobre la API, consulte DescribeInternetGatewaysla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2KeyPair.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el par de claves especificado.
Get-EC2KeyPair -KeyName my-key-pairSalida:
KeyFingerprint KeyName -------------- ------- 1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f my-key-pairEjemplo 2: En este ejemplo se describen todos los pares de claves.
Get-EC2KeyPair-
Para obtener más información sobre la API, consulte DescribeKeyPairsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2NetworkAcl.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la ACL de red especificada.
Get-EC2NetworkAcl -NetworkAclId acl-12345678Salida:
Associations : {aclassoc-1a2b3c4d} Entries : {Amazon.EC2.Model.NetworkAclEntry, Amazon.EC2.Model.NetworkAclEntry} IsDefault : False NetworkAclId : acl-12345678 Tags : {Name} VpcId : vpc-12345678Ejemplo 2: En este ejemplo se describen las reglas para la ACL de red especificada.
(Get-EC2NetworkAcl -NetworkAclId acl-12345678).EntriesSalida:
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 : 32767Ejemplo 3: En este ejemplo se describe toda la red ACLs.
Get-EC2NetworkAcl-
Para obtener información sobre la API, consulte DescribeNetworkAcls Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2NetworkInterface.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la interfaz de red especificada.
Get-EC2NetworkInterface -NetworkInterfaceId eni-12345678Salida:
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-12345678Ejemplo 2: En este ejemplo se describen todas las interfaces de red.
Get-EC2NetworkInterface-
Para obtener más información sobre la API, consulte DescribeNetworkInterfacesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2NetworkInterfaceAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la interfaz de red especificada.
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute AttachmentSalida:
Attachment : Amazon.EC2.Model.NetworkInterfaceAttachmentEjemplo 2: En este ejemplo se describe la interfaz de red especificada.
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute DescriptionSalida:
Description : My descriptionEjemplo 3: En este ejemplo se describe la interfaz de red especificada.
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute GroupSetSalida:
Groups : {my-security-group}Ejemplo 4: En este ejemplo se describe la interfaz de red especificada.
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute SourceDestCheckSalida:
SourceDestCheck : True-
Para obtener más información sobre la API, consulte DescribeNetworkInterfaceAttributela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2PasswordData.
- Herramientas para la versión 5 PowerShell
-
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.pemSalida:
mYZ(PA9?C)QEjemplo 2: ( PowerShell solo en Windows) 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 AWS Toolkit for Visual Studio. Si se encuentran los datos del par de claves, se descifra la contraseña.
Get-EC2PasswordData -InstanceId i-12345678 -DecryptSalida:
mYZ(PA9?C)QEjemplo 3: Devuelve los datos de contraseña cifrados de la instancia.
Get-EC2PasswordData -InstanceId i-12345678Salida:
iVz3BAK/WAXV.....dqt8WeMA==-
Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet GetPasswordDataReference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2PlacementGroup.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el grupo de ubicación especificado.
Get-EC2PlacementGroup -GroupName my-placement-groupSalida:
GroupName State Strategy --------- ----- -------- my-placement-group available cluster-
Para obtener más información sobre la API, consulte DescribePlacementGroupsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2PrefixList.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se obtiene lo disponible Servicios de AWS en un formato de lista de prefijos para la región
Get-EC2PrefixListSalida:
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 más información sobre la API, consulte DescribePrefixLists Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Region.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describen las regiones que están disponibles.
Get-EC2RegionSalida:
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 más información sobre la API, consulte DescribeRegionsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2RouteTable.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describen todas las tablas de enrutamiento.
Get-EC2RouteTableSalida:
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-1a2b3c4dEjemplo 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 más información sobre la API, consulte DescribeRouteTablesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ScheduledInstance.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la instancia programada especificada.
Get-EC2ScheduledInstance -ScheduledInstanceId sci-1234-1234-1234-1234-123456789012Salida:
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 : 1696Ejemplo 2: En este ejemplo se describen todas las instancias programadas.
Get-EC2ScheduledInstance-
Para obtener más información sobre la API, consulte DescribeScheduledInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2ScheduledInstanceAvailability.
- Herramientas para la versión 5 PowerShell
-
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:00ZSalida:
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" }-
Para obtener más información sobre la API, consulte DescribeScheduledInstanceAvailabilityla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SecurityGroup.
- Herramientas para la versión 5 PowerShell
-
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 (GroupId parámetro -), no el nombre (GroupName parámetro -), para hacer referencia al grupo.
Get-EC2SecurityGroup -GroupId sg-12345678Salida:
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-12345678Ejemplo 2: en este ejemplo se describe el grupo de seguridad especificado para EC2 -Classic. Al trabajar con grupos de seguridad para EC2 -Classic, puede utilizar el nombre del grupo (GroupName parámetro -) o el ID del grupo (GroupId parámetro -) para hacer referencia al grupo de seguridad.
Get-EC2SecurityGroup -GroupName my-security-groupSalida:
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 más información sobre la API, consulte DescribeSecurityGroups Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Snapshot.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la instantánea especificada.
Get-EC2Snapshot -SnapshotId snap-12345678Salida:
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 : 8Ejemplo 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 una etiqueta de «Nombre» 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 más información sobre la API, consulte DescribeSnapshots Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SnapshotAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el atributo especificado de la instantánea especificada.
Get-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute ProductCodesSalida:
CreateVolumePermissions ProductCodes SnapshotId ----------------------- ------------ ---------- {} {} snap-12345678Ejemplo 2: En este ejemplo se describe el atributo especificado de la instantánea especificada.
(Get-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission).CreateVolumePermissionsSalida:
Group UserId ----- ------ all-
Para obtener más información sobre la API, consulte DescribeSnapshotAttributela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotDatafeedSubscription.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la fuente de datos de la instancia de spot.
Get-EC2SpotDatafeedSubscriptionSalida:
Bucket : amzn-s3-demo-bucket Fault : OwnerId : 123456789012 Prefix : spotdata State : Active-
Para obtener más información sobre la API, consulte DescribeSpotDatafeedSubscriptionla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotFleetInstance.
- Herramientas para la versión 5 PowerShell
-
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-1cee4EXAMPLESalida:
InstanceId InstanceType SpotInstanceRequestId ---------- ------------ --------------------- i-f089262a c3.large sir-12345678 i-7e8b24a4 c3.large sir-87654321-
Para obtener más información sobre la API, consulte DescribeSpotFleetInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotFleetRequest.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la solicitud de flota de spot especificada.
Get-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE | format-listSalida:
ConfigData : Amazon.EC2.Model.SpotFleetRequestConfigData CreateTime : 12/26/2015 8:23:33 AM SpotFleetRequestId : sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE SpotFleetRequestState : activeEjemplo 2: En este ejemplo se describen todas las solicitudes de flota de spot.
Get-EC2SpotFleetRequest-
Para obtener más información sobre la API, consulte DescribeSpotFleetRequestsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotFleetRequestHistory.
- Herramientas para la versión 5 PowerShell
-
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:00ZSalida:
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).HistoryRecordsSalida:
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 más información sobre la API, consulte DescribeSpotFleetRequestHistoryla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotInstanceRequest.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la solicitud de instancia de spot especificada.
Get-EC2SpotInstanceRequest -SpotInstanceRequestId sir-12345678Salida:
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-timeEjemplo 2: En este ejemplo se describen todas las solicitudes de instancia de spot.
Get-EC2SpotInstanceRequest-
Para obtener más información sobre la API, consulte DescribeSpotInstanceRequestsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2SpotPriceHistory.
- Herramientas para la versión 5 PowerShell
-
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 AvailabilityZone parámetro - 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 shell. 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 10Salida:
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 más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DescribeSpotPriceHistoryReference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Subnet.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la subred especificada.
Get-EC2Subnet -SubnetId subnet-1a2b3c4dSalida:
AvailabilityZone : us-west-2c AvailableIpAddressCount : 251 CidrBlock : 10.0.0.0/24 DefaultForAz : False MapPublicIpOnLaunch : False State : available SubnetId : subnet-1a2b3c4d Tags : {} VpcId : vpc-12345678Ejemplo 2: En este ejemplo se describen todas las subredes.
Get-EC2Subnet-
Para obtener más información sobre la API, consulte DescribeSubnetsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Tag.
- Herramientas para la versión 5 PowerShell
-
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 neverEjemplo 2: En este ejemplo se buscan todas las etiquetas de todos los recursos y se agrupan por tipo de recurso
Get-EC2Tag | Group-Object resourcetypeSalida:
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 noEjemplo 4: Este ejemplo obtiene todos los recursos con la etiqueta «eliminación automática» con el valor «no» y más filtros en el siguiente tubo para analizar solo los tipos de recursos de «instancia» y, finalmente, crea la etiqueta «ThisInstance» para cada recurso de la 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 -AutoSizeSalida:
ResourceId Name-Tag ---------- -------- i-012e3cb4df567e1aa jump1 i-01c23a45d6fc7a89f repro-3Ejemplo 6: Este ejemplo valida los permisos para obtener EC2 etiquetas mediante el DryRun parámetro sin obtenerlas realmente. Nota: Si se realiza correctamente, se produce una excepción, que es el comportamiento esperado.
Get-EC2Tag -DryRun $trueSalida:
Get-EC2Tag: Request would have succeeded, but DryRun flag is set.-
Para obtener información sobre la API, consulte DescribeTags Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Volume.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el volumen de EBS especificado.
Get-EC2Volume -VolumeId vol-12345678Salida:
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 : standardEjemplo 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 más información sobre la API, consulte DescribeVolumesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VolumeAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el atributo especificado del volumen especificado.
Get-EC2VolumeAttribute -VolumeId vol-12345678 -Attribute AutoEnableIOSalida:
AutoEnableIO ProductCodes VolumeId ------------ ------------ -------- False {} vol-12345678-
Para obtener más información sobre la API, consulte DescribeVolumeAttributela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VolumeStatus.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el estado del volumen especificado.
Get-EC2VolumeStatus -VolumeId vol-12345678Salida:
Actions : {} AvailabilityZone : us-west-2a Events : {} VolumeId : vol-12345678 VolumeStatus : Amazon.EC2.Model.VolumeStatusInfo(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatusSalida:
Details Status ------- ------ {io-enabled, io-performance} ok(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatus.DetailsSalida:
Name Status ---- ------ io-enabled passed io-performance not-applicable-
Para obtener más información sobre la API, consulte DescribeVolumeStatusla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2Vpc.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la VPC especificada.
Get-EC2Vpc -VpcId vpc-12345678Salida:
CidrBlock : 10.0.0.0/16 DhcpOptionsId : dopt-1a2b3c4d InstanceTenancy : default IsDefault : False State : available Tags : {Name} VpcId : vpc-12345678Ejemplo 2: En este ejemplo se describe la VPC predeterminada (solo puede haber una por región). Si su cuenta admite 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-45678901Ejemplo 3: En este ejemplo se describen las VPCs que coinciden con el filtro especificado (es decir, tienen un CIDR que coincide con el valor «10.0.0.0/16» y están en el estado «disponibles»).
Get-EC2Vpc -Filter @{Name="cidr"; Values="10.0.0.0/16"},@{Name="state";Values="available"}Ejemplo 4: En este ejemplo se describen todos sus. VPCs
Get-EC2Vpc-
Para obtener más información sobre la API, consulte DescribeVpcs Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el atributo «enableDnsSupport».
Get-EC2VpcAttribute -VpcId vpc-12345678 -Attribute enableDnsSupportSalida:
EnableDnsSupport ---------------- TrueEjemplo 2: En este ejemplo se describe el atributo enableDnsHostnames «».
Get-EC2VpcAttribute -VpcId vpc-12345678 -Attribute enableDnsHostnamesSalida:
EnableDnsHostnames ------------------ True-
Para obtener más información sobre la API, consulte DescribeVpcAttribute Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcClassicLink.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: El ejemplo anterior devuelve todos los valores VPCs con su ClassicLinkEnabled estado para la región
Get-EC2VpcClassicLink -Region eu-west-1Salida:
ClassicLinkEnabled Tags VpcId ------------------ ---- ----- False {Name} vpc-0fc1ff23f45b678eb False {} vpc-01e23c4a5d6db78e9 False {Name} vpc-0123456b078b9d01f False {} vpc-12cf3b4f False {Name} vpc-0b12d3456a7e8901d-
Para obtener más información sobre la API, consulte DescribeVpcClassicLink Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcClassicLinkDnsSupport.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe el estado de soporte de ClassicLink DNS VPCs de la región eu-west-1
Get-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d -Region eu-west-1Salida:
ClassicLinkDnsSupported VpcId ----------------------- ----- False vpc-0b12d3456a7e8910d False vpc-12cf3b4f-
Para obtener información sobre la API, consulte DescribeVpcClassicLinkDnsSupport Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcEndpoint.
- Herramientas para la versión 5 PowerShell
-
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, canaliza el resultado al siguiente comando, que selecciona la VpcEndpointId propiedad y devuelve el ID de VPC de la matriz como matriz de cadenas
Get-EC2VpcEndpoint -Region eu-west-1 | Select-Object -ExpandProperty VpcEndpointIdSalida:
vpce-01a2ab3f4f5cc6f7d vpce-01d2b345a6787890b vpce-0012e34d567890e12 vpce-0c123db4567890123Ejemplo 2: Este ejemplo describe todos los puntos finales de vpc de la región eu-west-1 y selecciona VpcEndpointId VpcId, ServiceName y PrivateDnsEnabled propiedades para presentarlos en formato tabular
Get-EC2VpcEndpoint -Region eu-west-1 | Select-Object VpcEndpointId, VpcId, ServiceName, PrivateDnsEnabled | Format-Table -AutoSizeSalida:
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 TrueEjemplo 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 más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet Reference (DescribeVpcEndpointsV5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpcEndpointService.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: en este ejemplo se describe el servicio de punto final de la EC2 VPC con el filtro indicado, en este caso com.amazonaws.eu-west-1.ecs. Además, también expande la propiedad y muestra los detalles ServiceDetails
Get-EC2VpcEndpointService -Region eu-west-1 -MaxResult 5 -Filter @{Name="service-name";Values="com.amazonaws.eu-west-1.ecs"} | Select-Object -ExpandProperty ServiceDetailsSalida:
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 : FalseEjemplo 2: Este ejemplo recupera todos los servicios de punto final de la EC2 VPC y devuelve ServiceNames el «ssm» coincidente
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 más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DescribeVpcEndpointServicesReference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpnConnection.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la conexión VPN especificada.
Get-EC2VpnConnection -VpnConnectionId vpn-12345678Salida:
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-1a2b3c4dEjemplo 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 $filterEjemplo 3: En este ejemplo se describen todas las conexiones VPN.
Get-EC2VpnConnection-
Para obtener más información sobre la API, consulte DescribeVpnConnectionsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-EC2VpnGateway.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se describe la puerta de enlace privada virtual especificada.
Get-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4dSalida:
AvailabilityZone : State : available Tags : {} Type : ipsec.1 VpcAttachments : {vpc-12345678} VpnGatewayId : vgw-1a2b3c4dEjemplo 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 $filterEjemplo 3: En este ejemplo se describen las puertas de enlace privadas virtuales.
Get-EC2VpnGateway-
Para obtener más información sobre la API, consulte DescribeVpnGatewaysla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Grant-EC2SecurityGroupEgress.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: este ejemplo 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 PowerShell versión 3 o superior.
$ip = @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; IpRanges="203.0.113.0/24" } Grant-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ipEjemplo 2: Con la PowerShell versión 2, debe usar New-Object para crear el IpPermission objeto.
$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 $ipEjemplo 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 más información sobre la API, consulte AuthorizeSecurityGroupEgress Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Grant-EC2SecurityGroupIngress.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: en este ejemplo se definen las reglas de entrada de 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). Tenga en cuenta que debe identificar los grupos de seguridad de EC2 -VPC mediante el ID del grupo de seguridad, no el nombre del grupo de seguridad. La sintaxis utilizada en este ejemplo requiere la PowerShell versión 3 o superior.
$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 PowerShell versión 2, debe usar New-Object para crear los IpPermission objetos.
$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 reglas de entrada de un grupo de seguridad para -Classic. EC2 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 PowerShell versión 3 o superior.
$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 PowerShell versión 2, debe usar New-Object para crear los IpPermission objetos.
$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 más información sobre la API, consulte AuthorizeSecurityGroupIngress Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Import-EC2Image.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo importa una imagen de máquina virtual de disco único desde el bucket de Amazon S3 especificado a Amazon EC2 con un token de idempotencia. El ejemplo requiere que exista un rol de servicio de importación de VM con el nombre predeterminado «vmimport», con una política que permita a Amazon EC2 acceder al depósito 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 @parmsSalida:
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 más información sobre la API, consulte la referencia de Herramientas de AWS para PowerShell cmdlets (ImportImageV5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Import-EC2KeyPair.
- Herramientas para la versión 5 PowerShell
-
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 UTF8 formato del archivo de clave pública en una cadena codificada en Base64 y almacena la cadena convertida en la variable.$pkbase64En la última línea, se importa la clave pública convertida 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 $pkbase64Salida:
KeyFingerprint KeyName -------------- ------- do:d0:15:8f:79:97:12:be:00:fd:df:31:z3:b1:42:z1 Example-user-key-
Para obtener más información sobre la API, consulte ImportKeyPair Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Import-EC2Snapshot.
- Herramientas para la versión 5 PowerShell
-
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 VM Import Service con el nombre predeterminado «vmimport», con una política que permita a Amazon EC2 acceder al bucket especificado, como se explica en el
VM Import Prequisitestema de 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 @parmsSalida:
Description ImportTaskId SnapshotTaskDetail ----------------- -------------------- ------------------ Disk Image Import import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetail-
Para obtener más información sobre la API, consulte ImportSnapshot Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Move-EC2AddressToVpc.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: este ejemplo mueve una EC2 instancia con una dirección IP pública de 12.345.67.89 a la plataforma EC2 -VPC en la región EE.UU. Este (Norte de Virginia).
Move-EC2AddressToVpc -PublicIp 12.345.67.89 -Region us-east-1Ejemplo 2: este ejemplo canaliza los resultados de un comando al cmdlet. Get-EC2Instance Move-EC2AddressToVpc El Get-EC2Instance comando 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 más información sobre la API, consulte MoveAddressToVpc Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Address.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se asigna una dirección IP elástica para usarla con una instancia en una VPC.
New-EC2Address -Domain VpcSalida:
AllocationId Domain PublicIp ------------ ------ -------- eipalloc-12345678 vpc 198.51.100.2Ejemplo 2: en este ejemplo se asigna una dirección IP elástica para usarla con una instancia en -Classic. EC2
New-EC2AddressSalida:
AllocationId Domain PublicIp ------------ ------ -------- standard 203.0.113.17-
Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet AllocateAddressReference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2CustomerGateway.
- Herramientas para la versión 5 PowerShell
-
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 65534Salida:
BgpAsn : 65534 CustomerGatewayId : cgw-1a2b3c4d IpAddress : 203.0.113.12 State : available Tags : {} Type : ipsec.1-
Para obtener más información sobre la API, consulte CreateCustomerGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2DhcpOption.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se crea el conjunto especificado de opciones de DHCP. La sintaxis utilizada en este ejemplo requiere la PowerShell versión 3 o posterior.
$options = @( @{Key="domain-name";Values=@("abc.local")}, @{Key="domain-name-servers";Values=@("10.0.0.101","10.0.0.102")}) New-EC2DhcpOption -DhcpConfiguration $optionsSalida:
DhcpConfigurations DhcpOptionsId Tags ------------------ ------------- ---- {domain-name, domain-name-servers} dopt-1a2b3c4d {}Ejemplo 2: Con la PowerShell versión 2, 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 más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet CreateDhcpOptionsReference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2FlowLog.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo, se crea un EC2 registro de flujo para la subred-1d234567 en la cloud-watch-log denominada «subnet1-log» para todo el tráfico de «REJECT» con los permisos de la función de «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 CreateFlowLogsHerramientas de AWS para PowerShell más información sobre la API, consulte Cmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Host.
- Herramientas para la versión 5 PowerShell
-
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 1Salida:
h-01e23f4cd567890f3-
Para obtener más información sobre la API, consulte AllocateHostsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2HostReservation.
- Herramientas para la versión 5 PowerShell
-
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-01e23f4cd567890f1Salida:
ClientToken : CurrencyCode : Purchase : {hr-0123f4b5d67bedc89} TotalHourlyPrice : 1.307 TotalUpfrontPrice : 0.000-
Para obtener más información sobre la API, consulte PurchaseHostReservationla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Image.
- Herramientas para la versión 5 PowerShell
-
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 al finalizar.
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 $trueEjemplo 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 PowerShell versión 3 o superior.
$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 Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Instance.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: este ejemplo 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-groupEjemplo 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-12345678Ejemplo 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 uno de los Windows actuales AMIs, obtenga su ID de AMI mediante Get- SSMLatest EC2 Image. En este ejemplo se lanza una instancia desde la AMI base actual para Windows Server 2016.
$ami = (Get-SSMLatestEC2Image -Path 'ami-windows-latest' -ImageName 'WINDOWS*2016*English*Core*BASE').Value New-EC2Instance -ImageId $ami ...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-1a2b3c4d5e6f1a2b3Ejemplo 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,$tagspec2Ejemplo 7: en este ejemplo se validan los permisos para lanzar una EC2 instancia mediante el DryRun parámetro sin crear realmente la instancia. Nota: Si se realiza correctamente, se produce una excepción, que es el comportamiento esperado.
New-EC2Instance -ImageId 'ami-12345678' -InstanceType 't2.micro' -KeyName 'my-key-pair' -Region 'us-west-2' -DryRun $true-
Para obtener más información sobre la API, consulte RunInstances Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2InstanceExportTask.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se exporta una instancia detenida,
i-0800b00a00EXAMPLE, como un disco duro virtual (VHD) al bucket de S3testbucket-export-instances-2019. El entorno de destino esMicrosoft, y el parámetro region se añade porque la instancia está en laus-east-1región, mientras que la AWS región predeterminada del usuario no es us-east-1. Para obtener el estado de la tarea de exportación, copie el valor deExportTaskIdde los resultados de este comando y ejecuteGet-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-1Salida:
Description : ExportTaskId : export-i-077c73108aEXAMPLE ExportToS3Task : Amazon.EC2.Model.ExportToS3Task InstanceExportDetails : Amazon.EC2.Model.InstanceExportDetails State : active StatusMessage :-
Para obtener más información sobre la API, consulte CreateInstanceExportTask Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2InternetGateway.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se crea una puerta de enlace de Internet.
New-EC2InternetGatewaySalida:
Attachments InternetGatewayId Tags ----------- ----------------- ---- {} igw-1a2b3c4d {}-
Para obtener más información sobre la API, consulte CreateInternetGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2KeyPair.
- Herramientas para la versión 5 PowerShell
-
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. Cuando se utiliza PowerShell, la codificación debe estar configurada en ascii para generar una clave válida. Para obtener más información, consulte Crear, mostrar y eliminar pares de EC2 claves de Amazon (https://docs.aws.amazon.com/cli/latest/userguide/cli-services-ec2-keypairs.html) en la Guía del usuario de la interfaz de línea de AWS comandos.
(New-EC2KeyPair -KeyName "my-key-pair").KeyMaterial | Out-File -Encoding ascii -FilePath C:\path\my-key-pair.pem-
Para obtener más información sobre la API, consulte CreateKeyPairla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2NetworkAcl.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se crea una ACL de red para la VPC especificada.
New-EC2NetworkAcl -VpcId vpc-12345678Salida:
Associations : {} Entries : {Amazon.EC2.Model.NetworkAclEntry, Amazon.EC2.Model.NetworkAclEntry} IsDefault : False NetworkAclId : acl-12345678 Tags : {} VpcId : vpc-12345678-
Para obtener más información sobre la API, consulte CreateNetworkAclla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2NetworkAclEntry.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte CreateNetworkAclEntryla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2NetworkInterface.
- Herramientas para la versión 5 PowerShell
-
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.17Salida:
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 más información sobre la API, consulte CreateNetworkInterfacela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2PlacementGroup.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte CreatePlacementGroupla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Route.
- Herramientas para la versión 5 PowerShell
-
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-1a2b3c4dSalida:
True-
Para obtener más información sobre la API, consulte CreateRoutela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2RouteTable.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se crea una tabla de enrutamiento para la VPC especificada.
New-EC2RouteTable -VpcId vpc-12345678Salida:
Associations : {} PropagatingVgws : {} Routes : {} RouteTableId : rtb-1a2b3c4d Tags : {} VpcId : vpc-12345678-
Para obtener más información sobre la API, consulte CreateRouteTablela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2ScheduledInstance.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte RunScheduledInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2ScheduledInstancePurchase.
- Herramientas para la versión 5 PowerShell
-
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 $requestSalida:
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 más información sobre la API, consulte PurchaseScheduledInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2SecurityGroup.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
sg-12345678Ejemplo 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 más información sobre la API, consulte CreateSecurityGroup Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Snapshot.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte CreateSnapshotla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2SpotDatafeedSubscription.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se crea la fuente de datos de una instancia de spot.
New-EC2SpotDatafeedSubscription -Bucket amzn-s3-demo-bucket -Prefix spotdataSalida:
Bucket : amzn-s3-demo-bucket Fault : OwnerId : 123456789012 Prefix : spotdata State : Active-
Para obtener más información sobre la API, consulte CreateSpotDatafeedSubscriptionla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Subnet.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se crea una subred para el CIDR especificado.
New-EC2Subnet -VpcId vpc-12345678 -CidrBlock 10.0.0.0/24Salida:
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 más información sobre la API, consulte CreateSubnetla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Tag.
- Herramientas para la versión 5 PowerShell
-
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 PowerShell versión 3 o superior.
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 PowerShell la versión 3 o superior.
New-EC2Tag -Resource i-12345678 -Tag @( @{ Key="myTag"; Value="newTagValue" }, @{ Key="test"; Value="anotherTagValue" } )Ejemplo 3: Con la PowerShell versión 2, 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 más información sobre la API, consulte CreateTags Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Volume.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se crea el volumen especificado.
New-EC2Volume -Size 50 -AvailabilityZone us-west-2a -VolumeType gp2Salida:
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 : gp2Ejemplo 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 más información sobre la API, consulte CreateVolumela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2Vpc.
- Herramientas para la versión 5 PowerShell
-
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/16Salida:
CidrBlock : 10.0.0.0/16 DhcpOptionsId : dopt-1a2b3c4d InstanceTenancy : default IsDefault : False State : pending Tags : {} VpcId : vpc-12345678-
Para obtener más información sobre la API, consulte CreateVpcla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2VpcEndpoint.
- Herramientas para la versión 5 PowerShell
-
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-0fc1ff23f45b678ebSalida:
ClientToken VpcEndpoint ----------- ----------- Amazon.EC2.Model.VpcEndpoint-
Para obtener más información sobre la API, consulte CreateVpcEndpointla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2VpnConnection.
- Herramientas para la versión 5 PowerShell
-
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-1a2b3c4dSalida:
CustomerGatewayConfiguration : [XML document] CustomerGatewayId : cgw-1a2b3c4d Options : Routes : {} State : pending Tags : {} Type : VgwTelemetry : {} VpnConnectionId : vpn-12345678 VpnGatewayId : vgw-1a2b3c4dEjemplo 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.xmlEjemplo 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 más información sobre la API, consulte CreateVpnConnectionla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2VpnConnectionRoute.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte CreateVpnConnectionRoutela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-EC2VpnGateway.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se crea la puerta de enlace privada virtual especificada.
New-EC2VpnGateway -Type ipsec.1Salida:
AvailabilityZone : State : available Tags : {} Type : ipsec.1 VpcAttachments : {} VpnGatewayId : vgw-1a2b3c4d-
Para obtener más información sobre la API, consulte CreateVpnGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2Address.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
eipassoc-12345678Ejemplo 2: Este ejemplo asocia la dirección IP elástica especificada a la instancia especificada en EC2 -Classic.
C:\> Register-EC2Address -InstanceId i-12345678 -PublicIp 203.0.113.17-
Para obtener más información sobre la API, consulte AssociateAddress Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2DhcpOption.
- Herramientas para la versión 5 PowerShell
-
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-12345678Ejemplo 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 más información sobre la API, consulte AssociateDhcpOptionsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2Image.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte RegisterImagela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2PrivateIpAddress.
- Herramientas para la versión 5 PowerShell
-
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.82Ejemplo 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 más información sobre la API, consulte AssignPrivateIpAddressesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Register-EC2RouteTable.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se asocia la tabla de enrutamiento especificada a la subred especificada.
Register-EC2RouteTable -RouteTableId rtb-1a2b3c4d -SubnetId subnet-1a2b3c4dSalida:
rtbassoc-12345678-
Para obtener más información sobre la API, consulte AssociateRouteTablela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Address.
- Herramientas para la versión 5 PowerShell
-
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 -ForceEjemplo 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 más información sobre la API, consulte ReleaseAddress Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2CapacityReservation.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se cancela la reserva de capacidad cr-0c1f2345db6f7cdba
Remove-EC2CapacityReservation -CapacityReservationId cr-0c1f2345db6f7cdbaSalida:
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 más información sobre la API, consulte CancelCapacityReservationla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2CustomerGateway.
- Herramientas para la versión 5 PowerShell
-
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-1a2b3c4dSalida:
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 más información sobre la API, consulte DeleteCustomerGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2DhcpOption.
- Herramientas para la versión 5 PowerShell
-
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-1a2b3c4dSalida:
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 más información sobre la API, consulte DeleteDhcpOptionsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2FlowLog.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: Este ejemplo elimina el fl-01a2b3456a789c01 dado FlowLogId
Remove-EC2FlowLog -FlowLogId fl-01a2b3456a789c01Salida:
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 Cmdlet Reference (V5). DeleteFlowLogsHerramientas de AWS para PowerShell
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Host.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se publica el ID de host especificado h-0badafd1dcb2f3456
Remove-EC2Host -HostId h-0badafd1dcb2f3456Salida:
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 más información sobre la API, consulte ReleaseHostsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Instance.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
CurrentState InstanceId PreviousState ------------ ---------- ------------- Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState-
Para obtener más información sobre la API, consulte TerminateInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2InternetGateway.
- Herramientas para la versión 5 PowerShell
-
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-1a2b3c4dSalida:
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 más información sobre la API, consulte DeleteInternetGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2KeyPair.
- Herramientas para la versión 5 PowerShell
-
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-pairSalida:
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 más información sobre la API, consulte DeleteKeyPairla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2NetworkAcl.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
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 más información sobre la API, consulte DeleteNetworkAclla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2NetworkAclEntry.
- Herramientas para la versión 5 PowerShell
-
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 100Salida:
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 más información sobre la API, consulte DeleteNetworkAclEntryla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2NetworkInterface.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
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 más información sobre la API, consulte DeleteNetworkInterfacela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2PlacementGroup.
- Herramientas para la versión 5 PowerShell
-
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-groupSalida:
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 más información sobre la API, consulte DeletePlacementGroupla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Route.
- Herramientas para la versión 5 PowerShell
-
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/0Salida:
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 más información sobre la API, consulte DeleteRoutela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2RouteTable.
- Herramientas para la versión 5 PowerShell
-
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-1a2b3c4dSalida:
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 más información sobre la API, consulte DeleteRouteTablela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2SecurityGroup.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
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 -Classic. EC2
Remove-EC2SecurityGroup -GroupName my-security-group -Force-
Para obtener más información sobre la API, consulte DeleteSecurityGroup Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Snapshot.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
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 más información sobre la API, consulte DeleteSnapshotla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2SpotDatafeedSubscription.
- Herramientas para la versión 5 PowerShell
-
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-EC2SpotDatafeedSubscriptionSalida:
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 más información sobre la API, consulte DeleteSpotDatafeedSubscriptionla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Subnet.
- Herramientas para la versión 5 PowerShell
-
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-1a2b3c4dSalida:
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 más información sobre la API, consulte DeleteSubnetla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Tag.
- Herramientas para la versión 5 PowerShell
-
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 PowerShell versión 3 o posterior.
Remove-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag" } -ForceEjemplo 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 PowerShell la versión 3 o posterior.
Remove-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag";Value="myTagValue" } -ForceEjemplo 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 -ForceEjemplo 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 más información sobre la API, consulte DeleteTags Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Volume.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
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 más información sobre la API, consulte DeleteVolumela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2Vpc.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
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 más información sobre la API, consulte DeleteVpcla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2VpnConnection.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
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 más información sobre la API, consulte DeleteVpnConnectionla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2VpnConnectionRoute.
- Herramientas para la versión 5 PowerShell
-
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/16Salida:
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 más información sobre la API, consulte DeleteVpnConnectionRoutela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-EC2VpnGateway.
- Herramientas para la versión 5 PowerShell
-
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-1a2b3c4dSalida:
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 más información sobre la API, consulte DeleteVpnGatewayla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Request-EC2SpotFleet.
- Herramientas para la versión 5 PowerShell
-
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 solo admite EC2 -VPC, la flota de Spot lanza las instancias en la zona de disponibilidad de menor precio 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 más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet RequestSpotFleetReference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Request-EC2SpotInstance.
- Herramientas para la versión 5 PowerShell
-
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 $nSalida:
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 más información sobre la API, consulte RequestSpotInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Reset-EC2ImageAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se restablece el atributo “launchPermission” en su valor predeterminado. De forma predeterminada, AMIs son privadas.
Reset-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission-
Para obtener más información sobre la API, consulte ResetImageAttribute Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Reset-EC2InstanceAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: en este ejemplo se restablece el atributo 'sriovNetSupport' de la instancia especificada.
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sriovNetSupportEjemplo 2: En este ejemplo se restablece el atributo “ebsOptimized” de la instancia especificada.
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute ebsOptimizedEjemplo 3: en este ejemplo se restablece el atributo 'sourceDestCheck' de la instancia especificada.
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sourceDestCheckEjemplo 4: en este ejemplo se restablece el atributo 'disableApiTermination' de la instancia especificada.
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute disableApiTerminationEjemplo 5: en este ejemplo se restablece el atributo 'instanceInitiatedShutdownBehavior' de la instancia especificada.
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceInitiatedShutdownBehavior-
Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet ResetInstanceAttributeReference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Reset-EC2NetworkInterfaceAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se restablece la source/destination comprobación de la interfaz de red especificada.
Reset-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -SourceDestCheck-
Para obtener más información sobre la API, consulte ResetNetworkInterfaceAttribute Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Reset-EC2SnapshotAttribute.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se restablece el atributo especificado de la instantánea especificada.
Reset-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission-
Para obtener más información sobre la API, consulte ResetSnapshotAttributela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Restart-EC2Instance.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se reinicia la instancia especificada.
Restart-EC2Instance -InstanceId i-12345678-
Para obtener más información sobre la API, consulte RebootInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Revoke-EC2SecurityGroupEgress.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: este ejemplo 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 PowerShell versión 3 o superior.
$ip = @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; IpRanges="203.0.113.0/24" } Revoke-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ipEjemplo 2: Con la PowerShell versión 2, debe usar New-Object para crear el IpPermission objeto.
$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 $ipEjemplo 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 más información sobre la API, consulte RevokeSecurityGroupEgress Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Revoke-EC2SecurityGroupIngress.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: este ejemplo revoca el acceso al puerto TCP 22 desde el rango de direcciones especificado para el grupo de seguridad especificado para EC2 -VPC. Tenga en cuenta que debe identificar los grupos de seguridad de EC2 -VPC mediante el ID del grupo de seguridad, no el nombre del grupo de seguridad. La sintaxis utilizada en este ejemplo requiere la PowerShell versión 3 o superior.
$ip = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.0/24" } Revoke-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission $ipEjemplo 2: Con la PowerShell versión 2, debe usar New-Object para crear el IpPermission objeto.
$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 $ipEjemplo 3: Este ejemplo revoca el acceso al puerto TCP 22 desde el rango de direcciones especificado para el grupo de seguridad especificado para -Classic. EC2 La sintaxis utilizada en este ejemplo requiere la PowerShell versión 3 o superior.
$ip = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.0/24" } Revoke-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission $ipEjemplo 4: Con la PowerShell versión 2, debe usar New-Object para crear el IpPermission objeto.
$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 más información sobre la API, consulte RevokeSecurityGroupIngress Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Send-EC2InstanceStatus.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte ReportInstanceStatusla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Set-EC2NetworkAclAssociation.
- Herramientas para la versión 5 PowerShell
-
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-1a2b3c4dSalida:
aclassoc-87654321-
Para obtener más información sobre la API, consulte ReplaceNetworkAclAssociationla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Set-EC2NetworkAclEntry.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte ReplaceNetworkAclEntryla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Set-EC2Route.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte ReplaceRoutela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Set-EC2RouteTableAssociation.
- Herramientas para la versión 5 PowerShell
-
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-12345678Salida:
rtbassoc-87654321-
Para obtener más información sobre la API, consulte ReplaceRouteTableAssociationla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Start-EC2Instance.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se inicia la instancia especificada.
Start-EC2Instance -InstanceId i-12345678Salida:
CurrentState InstanceId PreviousState ------------ ---------- ------------- Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceStateEjemplo 2: En este ejemplo se inician las instancias especificadas.
@("i-12345678", "i-76543210") | Start-EC2InstanceEjemplo 3: En este ejemplo se inicia el conjunto de instancias que están detenidas actualmente. Los objetos de instancia devueltos por Get-EC2Instance se canalizan a. Start-EC2Instance La sintaxis utilizada en este ejemplo requiere la PowerShell versión 3 o superior.
(Get-EC2Instance -Filter @{ Name="instance-state-name"; Values="stopped"}).Instances | Start-EC2InstanceEjemplo 4: Con la PowerShell versión 2, debe usar New-Object para crear el filtro para el parámetro Filter.
$filter = New-Object Amazon.EC2.Model.Filter $filter.Name = "instance-state-name" $filter.Values = "stopped" (Get-EC2Instance -Filter $filter).Instances | Start-EC2InstanceEjemplo 5: en este ejemplo se validan los permisos para iniciar una EC2 instancia mediante el DryRun parámetro sin iniciar realmente la instancia. Nota: Si se realiza correctamente, se produce una excepción, que es el comportamiento esperado.
Start-EC2Instance -InstanceId 'i-0abcdef123456' -Region 'us-west-1' -DryRun $true-
Para obtener más información sobre la API, consulte StartInstances Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Start-EC2InstanceMonitoring.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se habilita la supervisión detallada de la instancia especificada.
Start-EC2InstanceMonitoring -InstanceId i-12345678Salida:
InstanceId Monitoring ---------- ---------- i-12345678 Amazon.EC2.Model.Monitoring-
Para obtener más información sobre la API, consulte MonitorInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2ImportTask.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte CancelImportTaskla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2Instance.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se detiene la instancia especificada.
Stop-EC2Instance -InstanceId i-12345678Salida:
CurrentState InstanceId PreviousState ------------ ---------- ------------- Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState-
Para obtener más información sobre la API, consulte StopInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2InstanceMonitoring.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se deshabilita la supervisión detallada de la instancia especificada.
Stop-EC2InstanceMonitoring -InstanceId i-12345678Salida:
InstanceId Monitoring ---------- ---------- i-12345678 Amazon.EC2.Model.Monitoring-
Para obtener más información sobre la API, consulte UnmonitorInstancesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2SpotFleetRequest.
- Herramientas para la versión 5 PowerShell
-
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 $trueEjemplo 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 más información sobre la API, consulte CancelSpotFleetRequestsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Stop-EC2SpotInstanceRequest.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se cancela la solicitud de instancia de spot especificada.
Stop-EC2SpotInstanceRequest -SpotInstanceRequestId sir-12345678Salida:
SpotInstanceRequestId State --------------------- ----- sir-12345678 cancelled-
Para obtener más información sobre la API, consulte CancelSpotInstanceRequestsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-EC2Address.
- Herramientas para la versión 5 PowerShell
-
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-12345678Ejemplo 2: Este ejemplo desasocia la dirección IP elástica especificada de la instancia especificada en EC2 -Classic.
Unregister-EC2Address -PublicIp 203.0.113.17-
Para obtener más información sobre la API, consulte DisassociateAddress Herramientas de AWS para PowerShellCmdlet Reference (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-EC2Image.
- Herramientas para la versión 5 PowerShell
-
Ejemplo 1: En este ejemplo se anula el registro de la AMI especificada.
Unregister-EC2Image -ImageId ami-12345678-
Para obtener más información sobre la API, consulte DeregisterImagela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-EC2PrivateIpAddress.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte UnassignPrivateIpAddressesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-EC2RouteTable.
- Herramientas para la versión 5 PowerShell
-
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 más información sobre la API, consulte DisassociateRouteTablela referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Update-EC2SecurityGroupRuleIngressDescription.
- Herramientas para la versión 5 PowerShell
-
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 $ruleWithUpdatedDescriptionEjemplo 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-
Para obtener más información sobre la API, consulte UpdateSecurityGroupRuleDescriptionsIngressla referencia de Herramientas de AWS para PowerShell cmdlets (V5).
-