Ejemplos de Elastic Load Balancing, versión 1, con las Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se añade la subred especificada al conjunto de subredes configuradas para el equilibrador de carga especificado. El resultado incluye la lista completa de subredes.

Add-ELBLoadBalancerToSubnet -LoadBalancerName my-load-balancer -Subnet subnet-12345678

Salida:

subnet-12345678
subnet-87654321

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

Add-ELBResourceTag -LoadBalancerName my-load-balancer -Tag @{ Key="project";Value="lima" },@{ Key="department";Value="digital-media" }

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

$tag = New-Object Amazon.ElasticLoadBalancing.Model.Tag
$tag.Key = "project"
$tag.Value = "lima"
Add-ELBResourceTag -LoadBalancerName my-load-balancer -Tag $tag

Ejemplo 1: En este ejemplo se elimina la zona de disponibilidad especificada del equilibrador de carga especificado. El resultado incluye las zonas de disponibilidad restantes.

Disable-ELBAvailabilityZoneForLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a

Salida:

us-west-2b

Ejemplo 1: En este ejemplo se elimina la subred especificada del conjunto de subredes configuradas para el equilibrador de carga especificado. La salida incluye las subredes restantes.

Dismount-ELBLoadBalancerFromSubnet -LoadBalancerName my-load-balancer -Subnet subnet-12345678

Salida:

subnet-87654321

Ejemplo 1: En este ejemplo se habilita el equilibrio de carga entre zonas para el equilibrador de carga especificado.

Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer -CrossZoneLoadBalancing_Enabled $true

Ejemplo 2: En este ejemplo se deshabilita el drenaje de conexiones para el equilibrador de carga especificado.

Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer -ConnectionDraining_Enabled $false

Ejemplo 3: En este ejemplo se habilita el registro de acceso del equilibrador de carga especificado.

Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer `
>> -AccessLog_Enabled $true `
>> -AccessLog_S3BucketName amzn-s3-demo-logging-bucket `
>> -AccessLog_S3BucketPrefix my-app/prod `
>> -AccessLog_EmitInterval 60

Ejemplo 1: En este ejemplo se añade la zona de disponibilidad especificada al equilibrador de carga especificado. El resultado incluye la lista completa de zonas de disponibilidad.

Enable-ELBAvailabilityZoneForLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a

Salida:

us-west-2a
us-west-2b

Ejemplo 1: En este ejemplo se describe el estado de las instancias registradas en el equilibrador de carga especificado.

Get-ELBInstanceHealth -LoadBalancerName my-load-balancer

Salida:

Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService

Ejemplo 2: En este ejemplo se describe el estado de la instancia registrada especificada en el equilibrador de carga especificado.

Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678

Ejemplo 3: En este ejemplo se muestra la descripción completa del estado de la instancia especificada.

(Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678).Description

Salida:

Instance has failed at least the UnhealthyThreshold number of health checks consecutively.

Ejemplo 1: En este ejemplo se muestran los nombres de los equilibradores de carga.

Get-ELBLoadBalancer | format-table -property LoadBalancerName

Salida:

LoadBalancerName
----------------
my-load-balancer
my-other-load-balancer
my-internal-load-balancer

Ejemplo 2: En este ejemplo se describe el equilibrador de carga especificado.

Get-ELBLoadBalancer -LoadBalancerName my-load-balancer

Salida:

AvailabilityZones         : {us-west-2a, us-west-2b}
BackendServerDescriptions : {Amazon.ElasticLoadBalancing.Model.BackendServerDescription}
CanonicalHostedZoneName   : my-load-balancer-1234567890.us-west-2.elb.amazonaws.com
CanonicalHostedZoneNameID : Z3DZXE0EXAMPLE
CreatedTime               : 4/11/2015 12:12:45 PM
DNSName                   : my-load-balancer-1234567890.us-west-2.elb.amazonaws.com
HealthCheck               : Amazon.ElasticLoadBalancing.Model.HealthCheck
Instances                 : {i-207d9717, i-afefb49b}
ListenerDescriptions      : {Amazon.ElasticLoadBalancing.Model.ListenerDescription}
LoadBalancerName          : my-load-balancer
Policies                  : Amazon.ElasticLoadBalancing.Model.Policies
Scheme                    : internet-facing
SecurityGroups            : {sg-a61988c3}
SourceSecurityGroup       : Amazon.ElasticLoadBalancing.Model.SourceSecurityGroup
Subnets                   : {subnet-15aaab61}
VPCId                     : vpc-a01106c2

Ejemplo 3: En este ejemplo se describen todos los equilibradores de carga de la región de AWS actual.

Get-ELBLoadBalancer

Ejemplo 4: En este ejemplo se describen todos los equilibradores de carga de todas las Regiones de AWS disponibles.

Get-AWSRegion | % { Get-ELBLoadBalancer -Region $_ }

Ejemplo 1: En este ejemplo se describen los atributos del equilibrador de carga especificado.

Get-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer

Salida:

AccessLog              : Amazon.ElasticLoadBalancing.Model.AccessLog
AdditionalAttributes   : {}
ConnectionDraining     : Amazon.ElasticLoadBalancing.Model.ConnectionDraining
ConnectionSettings     : Amazon.ElasticLoadBalancing.Model.ConnectionSettings
CrossZoneLoadBalancing : Amazon.ElasticLoadBalancing.Model.CrossZoneLoadBalancing

Ejemplo 1: En este ejemplo se describen las políticas asociadas al equilibrador de carga especificado.

Get-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer

Salida:

PolicyAttributeDescriptions             PolicyName                              PolicyTypeName
---------------------------             ----------                              --------------
{ProxyProtocol}                         my-ProxyProtocol-policy                 ProxyProtocolPolicyType
{CookieName}                            my-app-cookie-policy                    AppCookieStickinessPolicyType

Ejemplo 2: En este ejemplo se describen los atributos de la política especificada.

(Get-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-ProxyProtocol-policy).PolicyAttributeDescriptions

Salida:

AttributeName    AttributeValue
-------------    --------------
ProxyProtocol    true

Ejemplo 3: En este ejemplo se describen las políticas predefinidas, incluidas las políticas de ejemplo. Los nombres de las políticas de ejemplo tienen el prefijo ELBSample-.

Get-ELBLoadBalancerPolicy

Salida:

PolicyAttributeDescriptions             PolicyName                              PolicyTypeName
---------------------------             ----------                              --------------
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2015-05               SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2015-03               SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2015-02               SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2014-10               SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2014-01               SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2011-08               SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSample-ELBDefaultCipherPolicy        SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSample-OpenSSLDefaultCipherPolicy    SSLNegotiationPolicyType

Ejemplo 1: En este ejemplo se obtienen los tipos de políticas compatibles con Elastic Load Balancing.

Get-ELBLoadBalancerPolicyType

Salida:

Description                             PolicyAttributeTypeDescriptions         PolicyTypeName
-----------                             -------------------------------         --------------
Stickiness policy with session lifet... {CookieExpirationPeriod}                LBCookieStickinessPolicyType
Policy that controls authentication ... {PublicKeyPolicyName}                   BackendServerAuthenticationPolicyType
Listener policy that defines the cip... {Protocol-SSLv2, Protocol-TLSv1, Pro... SSLNegotiationPolicyType
Policy containing a list of public k... {PublicKey}                             PublicKeyPolicyType
Stickiness policy with session lifet... {CookieName}                            AppCookieStickinessPolicyType
Policy that controls whether to incl... {ProxyProtocol}                         ProxyProtocolPolicyType

Ejemplo 2: En este ejemplo se describe el tipo de política especificado.

Get-ELBLoadBalancerPolicyType -PolicyTypeName ProxyProtocolPolicyType

Salida:

Description                             PolicyAttributeTypeDescriptions         PolicyTypeName
-----------                             -------------------------------         --------------
Policy that controls whether to incl... {ProxyProtocol}                         ProxyProtocolPolicyType

Ejemplo 3: En este ejemplo se muestra la descripción completa del tipo de política especificado.

(Get-ELBLoadBalancerPolicyType -PolicyTypeName).Description

Salida:

Policy that controls whether to include the IP address and port of the originating request for TCP messages. 
This policy operates on TCP/SSL listeners only

Ejemplo 1: En este ejemplo se enumeran las etiquetas de los equilibradores de carga especificados.

Get-ELBResourceTag -LoadBalancerName @("my-load-balancer","my-internal-load-balancer")

Salida:

LoadBalancerName             Tags
----------------             ----
my-load-balancer             {project, department}
my-internal-load-balancer    {project, department}

Ejemplo 2: En este ejemplo se describen las etiquetas del equilibrador de carga especificado.

(Get-ELBResourceTag -LoadBalancerName my-load-balancer).Tags

Salida:

Key           Value
---           -----
project       lima
department    digital-media

Ejemplo 1: En este ejemplo se reemplaza el grupo de seguridad actual del equilibrador de carga especificado por el grupo de seguridad especificado.

Join-ELBSecurityGroupToLoadBalancer -LoadBalancerName my-load-balancer -SecurityGroup sg-87654321

Salida:

sg-87654321

Ejemplo 2: Para conservar el grupo de seguridad actual y especificar un grupo de seguridad adicional, especifique tanto el grupo de seguridad existente como el nuevo.

Join-ELBSecurityGroupToLoadBalancer -LoadBalancerName my-load-balancer -SecurityGroup @("sg-12345678", "sg-87654321")

Salida:

sg-12345678
sg-87654321

Ejemplo 1: En este ejemplo se crea una política de persistencia que sigue las vidas útiles de las sesiones persistentes de la cookie generada por la aplicación especificada.

New-ELBAppCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-app-cookie-policy -CookieName my-app-cookie

Ejemplo 1: En este ejemplo se crea una política de persistencia en la que las vidas útiles de las sesiones persistentes se controlan en función del período de vencimiento especificado (en segundos).

New-ELBLBCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy -CookieExpirationPeriod 60

Ejemplo 2: En este ejemplo se crea una política de persistencia en la que las vidas útiles de las sesiones persistentes se controlan mediante la vida útil del navegador (usuario-agente).

New-ELBLBCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy

Ejemplo 1: En este ejemplo se crea un equilibrador de carga con un oyente de HTTP en una VPC.

$httpListener = New-Object Amazon.ElasticLoadBalancing.Model.Listener
$httpListener.Protocol = "http"
$httpListener.LoadBalancerPort = 80
$httpListener.InstanceProtocol = "http"
$httpListener.InstancePort = 80
New-ELBLoadBalancer -LoadBalancerName my-vpc-load-balancer -SecurityGroup sg-a61988c3 -Subnet subnet-15aaab61 -Listener $httpListener

my-vpc-load-balancer-1234567890.us-west-2.elb.amazonaws.com

Ejemplo 2: En este ejemplo se crea un equilibrador de carga con un oyente de HTTP en EC2-Classic.

New-ELBLoadBalancer -LoadBalancerName my-classic-load-balancer -AvailabilityZone us-west-2a` -Listener $httpListener

Salida:

my-classic-load-balancer-123456789.us-west-2.elb.amazonaws.com

Ejemplo 3: En este ejemplo se crea un equilibrador de carga con un oyente de HTTPS.

$httpsListener = New-Object Amazon.ElasticLoadBalancing.Model.Listener
$httpsListener.Protocol = "https"
$httpsListener.LoadBalancerPort = 443
$httpsListener.InstanceProtocol = "http"
$httpsListener.InstancePort = 80 
$httpsListener.SSLCertificateId="arn:aws:iam::123456789012:server-certificate/my-server-cert"
New-ELBLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a -Listener $httpsListener

my-load-balancer-123456789.us-west-2.elb.amazonaws.com

Ejemplo 1: En este ejemplo se añade un oyente de HTTPS al equilibrador de carga especificado.

$httpsListener = New-Object Amazon.ElasticLoadBalancing.Model.Listener
$httpsListener.Protocol = "https"
$httpsListener.LoadBalancerPort = 443
$httpsListener.InstanceProtocol = "https"
$httpsListener.InstancePort = 443 
$httpsListener.SSLCertificateId="arn:aws:iam::123456789012:server-certificate/my-server-cert"
New-ELBLoadBalancerListener -LoadBalancerName my-load-balancer -Listener $httpsListener

Ejemplo 1: En este ejemplo se crea una nueva política de protocolo de proxy para un equilibrador de carga especificado.

$attribute = New-Object Amazon.ElasticLoadBalancing.Model.PolicyAttribute -Property @{
         AttributeName="ProxyProtocol"
         AttributeValue="True"
    }
New-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-ProxyProtocol-policy -PolicyTypeName ProxyProtocolPolicyType -PolicyAttribute $attribute

Ejemplo 1: En este ejemplo se registra la instancia de EC2 especificada en el equilibrador de carga especificado.

Register-ELBInstanceWithLoadBalancer -LoadBalancerName my-load-balancer -Instance i-12345678

Salida:

InstanceId
----------
i-12345678
i-87654321

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

Remove-ELBInstanceFromLoadBalancer -LoadBalancerName my-load-balancer -Instance i-12345678

Salida:

Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ELBInstanceFromLoadBalancer (DeregisterInstancesFromLoadBalancer)" on Target
"Amazon.ElasticLoadBalancing.Model.Instance".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

InstanceId
----------
i-87654321

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

Remove-ELBLoadBalancer -LoadBalancerName my-load-balancer

Salida:

Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ELBLoadBalancer (DeleteLoadBalancer)" on Target "my-load-balancer".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

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

Remove-ELBLoadBalancerListener -LoadBalancerName my-load-balancer -LoadBalancerPort 80

Salida:

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

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

Remove-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy

Salida:

Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ELBLoadBalancerPolicy (DeleteLoadBalancerPolicy)" on Target "my-duration-cookie-policy".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

Ejemplo 1: En este ejemplo se elimina la etiqueta especificada del equilibrador de carga especificado. Para que la operación continúe, se le pedirá confirmación, a menos que especifique el parámetro Force. La sintaxis utilizada en este ejemplo requiere la versión 3 o posterior de PowerShell.

Remove-ELBResourceTag -LoadBalancerName my-load-balancer -Tag @{ Key="project" }

Salida:

Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ELBResourceTag (RemoveTags)" on target "Amazon.ElasticLoadBalancing.Model.TagKeyOnly".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

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

$tag = New-Object Amazon.ElasticLoadBalancing.Model.TagKeyOnly
$tag.Key = "project"
Remove-ELBResourceTag -Tag $tag -Force

Ejemplo 1: En este ejemplo se configuran las opciones de comprobación de estado del equilibrador de carga especificado.

Set-ELBHealthCheck -LoadBalancerName my-load-balancer `
>> -HealthCheck_HealthyThreshold 2 `
>> -HealthCheck_UnhealthyThreshold 2 `
>> -HealthCheck_Target "HTTP:80/ping" `
>> -HealthCheck_Interval 30 `
>> -HealthCheck_Timeout 3

Salida:

HealthyThreshold   : 2
Interval           : 30
Target             : HTTP:80/ping
Timeout            : 3
UnhealthyThreshold : 2

Ejemplo 1: En este ejemplo se reemplaza el certificado que termina las conexiones SSL del oyente especificado.

Set-ELBLoadBalancerListenerSSLCertificate -LoadBalancerName my-load-balancer `
>> -LoadBalancerPort 443 `
>> -SSLCertificateId "arn:aws:iam::123456789012:server-certificate/new-server-cert"

Ejemplo 1: En este ejemplo se sustituyen las políticas del puerto especificado por la política especificada.

Set-ELBLoadBalancerPolicyForBackendServer -LoadBalancerName my-load-balancer -InstancePort 80 -PolicyName my-ProxyProtocol-policy

Ejemplo 2: En este ejemplo se quitan todas las políticas asociadas al puerto especificado.

Set-ELBLoadBalancerPolicyForBackendServer -LoadBalancerName my-load-balancer -InstancePort 80

Ejemplo 1: En este ejemplo se sustituyen las políticas del oyente especificado por la política especificada.

Set-ELBLoadBalancerPolicyOfListener -LoadBalancerName my-load-balancer -LoadBalancerPort 443 -PolicyName my-SSLNegotiation-policy

Ejemplo 2: En este ejemplo se quitan todas las políticas asociadas al oyente especificado.

Set-ELBLoadBalancerPolicyOfListener -LoadBalancerName my-load-balancer -LoadBalancerPort 443