

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada\$1

Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o [tópico de migração](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).

 [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Elastic Load Balancing — Exemplos da versão 1 usando o Tools for V5 PowerShell
<a name="powershell_elastic-load-balancing_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V5 com o Elastic Load Balancing - Versão 1.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `Add-ELBLoadBalancerToSubnet`
<a name="elastic-load-balancing_AttachLoadBalancerToSubnets_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Add-ELBLoadBalancerToSubnet`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo adiciona a sub-rede especificada ao conjunto de sub-redes configuradas para o balanceador de carga especificado. A saída inclui a lista completa de sub-redes.**  

```
Add-ELBLoadBalancerToSubnet -LoadBalancerName my-load-balancer -Subnet subnet-12345678
```
**Saída**:  

```
subnet-12345678
subnet-87654321
```
+  Para obter detalhes da API, consulte [AttachLoadBalancerToSubnets](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Add-ELBResourceTag`
<a name="elastic-load-balancing_AddTags_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Add-ELBResourceTag`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo adiciona as tags especificadas ao balanceador de carga especificado. A sintaxe usada neste exemplo requer a PowerShell versão 3 ou posterior.**  

```
Add-ELBResourceTag -LoadBalancerName my-load-balancer -Tag @{ Key="project";Value="lima" },@{ Key="department";Value="digital-media" }
```
**Exemplo 2: Com a PowerShell versão 2, você deve usar New-Object para criar uma tag para o parâmetro Tag.**  

```
$tag = New-Object Amazon.ElasticLoadBalancing.Model.Tag
$tag.Key = "project"
$tag.Value = "lima"
Add-ELBResourceTag -LoadBalancerName my-load-balancer -Tag $tag
```
+  Para obter detalhes da API, consulte [AddTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Disable-ELBAvailabilityZoneForLoadBalancer`
<a name="elastic-load-balancing_DisableAvailabilityZonesForLoadBalancer_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Disable-ELBAvailabilityZoneForLoadBalancer`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo adiciona a Zona de Disponibilidade especificada ao balanceador de carga especificado. A saída inclui as zonas de disponibilidade restantes.**  

```
Disable-ELBAvailabilityZoneForLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a
```
**Saída**:  

```
us-west-2b
```
+  Para obter detalhes da API, consulte [DisableAvailabilityZonesForLoadBalancer](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Dismount-ELBLoadBalancerFromSubnet`
<a name="elastic-load-balancing_DetachLoadBalancerFromSubnets_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Dismount-ELBLoadBalancerFromSubnet`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo adiciona a sub-rede especificada ao conjunto de sub-redes configuradas para o balanceador de carga especificado. A saída inclui as sub-redes restantes.**  

```
Dismount-ELBLoadBalancerFromSubnet -LoadBalancerName my-load-balancer -Subnet subnet-12345678
```
**Saída**:  

```
subnet-87654321
```
+  Para obter detalhes da API, consulte [DetachLoadBalancerFromSubnets](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Edit-ELBLoadBalancerAttribute`
<a name="elastic-load-balancing_ModifyLoadBalancerAttributes_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Edit-ELBLoadBalancerAttribute`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo habilita o balanceamento de carga entre zonas para o balanceador de carga especificado.**  

```
Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer -CrossZoneLoadBalancing_Enabled $true
```
**Exemplo 2: esse exemplo desativa a drenagem da conexão para o balanceador de carga especificado.**  

```
Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer -ConnectionDraining_Enabled $false
```
**Exemplo 3: esse exemplo habilita os logs de acesso para o balanceador 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
```
+  Para obter detalhes da API, consulte [ModifyLoadBalancerAttributes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Enable-ELBAvailabilityZoneForLoadBalancer`
<a name="elastic-load-balancing_EnableAvailabilityZonesForLoadBalancer_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Enable-ELBAvailabilityZoneForLoadBalancer`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo adiciona a Zona de Disponibilidade especificada ao balanceador de carga especificado. O resultado inclui a lista completa de zonas de disponibilidade.**  

```
Enable-ELBAvailabilityZoneForLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a
```
**Saída**:  

```
us-west-2a
us-west-2b
```
+  Para obter detalhes da API, consulte [EnableAvailabilityZonesForLoadBalancer](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-ELBInstanceHealth`
<a name="elastic-load-balancing_DescribeInstanceHealth_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Get-ELBInstanceHealth`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: descreve o estado das instâncias registradas com o balanceador de carga especificado.**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer
```
**Saída**:  

```
Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService
```
**Exemplo 2: descreve o estado da instância especificada registrada com o balanceador de carga especificado.**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Exemplo 3: esse exemplo exibe a descrição completa do estado da instância especificada.**  

```
(Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678).Description
```
**Saída**:  

```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+  Para obter detalhes da API, consulte [DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-ELBLoadBalancer`
<a name="elastic-load-balancing_DescribeLoadBalancers_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Get-ELBLoadBalancer`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo lista os nomes de seus balanceadores de carga.**  

```
Get-ELBLoadBalancer | format-table -property LoadBalancerName
```
**Saída**:  

```
LoadBalancerName
----------------
my-load-balancer
my-other-load-balancer
my-internal-load-balancer
```
**Exemplo 2: esse exemplo descreve o balanceador de carga especificado.**  

```
Get-ELBLoadBalancer -LoadBalancerName my-load-balancer
```
**Saída**:  

```
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
```
**Exemplo 3: Este exemplo descreve todos os seus balanceadores de carga na AWS região atual.**  

```
Get-ELBLoadBalancer
```
**Exemplo 4: esse exemplo descreve todos os balanceadores de carga em todas as Regiões da AWS disponíveis.**  

```
Get-AWSRegion | % { Get-ELBLoadBalancer -Region $_ }
```
+  Para obter detalhes da API, consulte [DescribeLoadBalancers](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-ELBLoadBalancerAttribute`
<a name="elastic-load-balancing_DescribeLoadBalancerAttributes_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Get-ELBLoadBalancerAttribute`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo descreve os atributos para o balanceador de carga especificado.**  

```
Get-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer
```
**Saída**:  

```
AccessLog              : Amazon.ElasticLoadBalancing.Model.AccessLog
AdditionalAttributes   : {}
ConnectionDraining     : Amazon.ElasticLoadBalancing.Model.ConnectionDraining
ConnectionSettings     : Amazon.ElasticLoadBalancing.Model.ConnectionSettings
CrossZoneLoadBalancing : Amazon.ElasticLoadBalancing.Model.CrossZoneLoadBalancing
```
+  Para obter detalhes da API, consulte [DescribeLoadBalancerAttributes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-ELBLoadBalancerPolicy`
<a name="elastic-load-balancing_DescribeLoadBalancerPolicies_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Get-ELBLoadBalancerPolicy`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo descreve as políticas associadas ao balanceador de carga especificado.**  

```
Get-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer
```
**Saída**:  

```
PolicyAttributeDescriptions             PolicyName                              PolicyTypeName
---------------------------             ----------                              --------------
{ProxyProtocol}                         my-ProxyProtocol-policy                 ProxyProtocolPolicyType
{CookieName}                            my-app-cookie-policy                    AppCookieStickinessPolicyType
```
**Exemplo 2: esse exemplo descreve os atributos da política especificada.**  

```
(Get-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-ProxyProtocol-policy).PolicyAttributeDescriptions
```
**Saída**:  

```
AttributeName    AttributeValue
-------------    --------------
ProxyProtocol    true
```
**Exemplo 3: esse exemplo descreve as políticas predefinidas, incluindo os exemplos de políticas. Os nomes das políticas de amostra têm o prefixo ELBSample -.**  

```
Get-ELBLoadBalancerPolicy
```
**Saída**:  

```
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
```
+  Para obter detalhes da API, consulte [DescribeLoadBalancerPolicies](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-ELBLoadBalancerPolicyType`
<a name="elastic-load-balancing_DescribeLoadBalancerPolicyTypes_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Get-ELBLoadBalancerPolicyType`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo obtém os tipos de políticas compatíveis com o Elastic Load Balancing.**  

```
Get-ELBLoadBalancerPolicyType
```
**Saída**:  

```
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
```
**Exemplo 2: esse exemplo descreve o tipo de política especificado.**  

```
Get-ELBLoadBalancerPolicyType -PolicyTypeName ProxyProtocolPolicyType
```
**Saída**:  

```
Description                             PolicyAttributeTypeDescriptions         PolicyTypeName
-----------                             -------------------------------         --------------
Policy that controls whether to incl... {ProxyProtocol}                         ProxyProtocolPolicyType
```
**Exemplo 3: esse exemplo exibe a descrição completa do tipo de política especificado.**  

```
(Get-ELBLoadBalancerPolicyType -PolicyTypeName).Description
```
**Saída**:  

```
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
```
+  Para obter detalhes da API, consulte [DescribeLoadBalancerPolicyTypes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-ELBResourceTag`
<a name="elastic-load-balancing_DescribeTags_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Get-ELBResourceTag`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo lista as tags para os balanceadores de carga especificados.**  

```
Get-ELBResourceTag -LoadBalancerName @("my-load-balancer","my-internal-load-balancer")
```
**Saída**:  

```
LoadBalancerName             Tags
----------------             ----
my-load-balancer             {project, department}
my-internal-load-balancer    {project, department}
```
**Exemplo 2: esse exemplo descreve as tags para o balanceador de carga especificado.**  

```
(Get-ELBResourceTag -LoadBalancerName my-load-balancer).Tags
```
**Saída**:  

```
Key           Value
---           -----
project       lima
department    digital-media
```
+  Para obter detalhes da API, consulte [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Join-ELBSecurityGroupToLoadBalancer`
<a name="elastic-load-balancing_ApplySecurityGroupsToLoadBalancer_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Join-ELBSecurityGroupToLoadBalancer`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo substitui o grupo de segurança atual do balanceador de carga especificado pelo grupo de segurança especificado.**  

```
Join-ELBSecurityGroupToLoadBalancer -LoadBalancerName my-load-balancer -SecurityGroup sg-87654321
```
**Saída**:  

```
sg-87654321
```
**Exemplo 2: para manter o grupo de segurança atual e especificar um grupo de segurança adicional, especifique os grupos de segurança existentes e os novos.**  

```
Join-ELBSecurityGroupToLoadBalancer -LoadBalancerName my-load-balancer -SecurityGroup @("sg-12345678", "sg-87654321")
```
**Saída**:  

```
sg-12345678
sg-87654321
```
+  Para obter detalhes da API, consulte [ApplySecurityGroupsToLoadBalancer](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-ELBAppCookieStickinessPolicy`
<a name="elastic-load-balancing_CreateAppCookieStickinessPolicy_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `New-ELBAppCookieStickinessPolicy`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo cria uma política de permanência com os tempos de vida de sessão persistente do cookie gerado pela aplicação.**  

```
New-ELBAppCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-app-cookie-policy -CookieName my-app-cookie
```
+  Para obter detalhes da API, consulte [CreateAppCookieStickinessPolicy](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-ELBLBCookieStickinessPolicy`
<a name="elastic-load-balancing_CreateLbCookieStickinessPolicy_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `New-ELBLBCookieStickinessPolicy`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo gera uma política de persistência com tempos de duração de sessão persistente controlados por um período de validade especificado (em segundos).**  

```
New-ELBLBCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy -CookieExpirationPeriod 60
```
**Exemplo 2: esse exemplo cria uma política de persistência em que o tempo de vida da sessão persistente é controlado pelo tempo de vida do navegador (usuário-agente).**  

```
New-ELBLBCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy
```
+  Para obter detalhes da API, consulte [CreateLbCookieStickinessPolicy](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-ELBLoadBalancer`
<a name="elastic-load-balancing_CreateLoadBalancer_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `New-ELBLoadBalancer`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo cria um balanceador de carga com um receptor HTTP em uma 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
```
**Exemplo 2: Este exemplo cria um balanceador de carga com um ouvinte HTTP em EC2 -Classic.**  

```
New-ELBLoadBalancer -LoadBalancerName my-classic-load-balancer -AvailabilityZone us-west-2a` -Listener $httpListener
```
**Saída**:  

```
my-classic-load-balancer-123456789.us-west-2.elb.amazonaws.com
```
**Exemplo 3: esse exemplo cria um balanceador de carga com um receptor 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
```
+  Para obter detalhes da API, consulte [CreateLoadBalancer](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-ELBLoadBalancerListener`
<a name="elastic-load-balancing_CreateLoadBalancerListeners_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `New-ELBLoadBalancerListener`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo adiciona um receptor HTTPS ao balanceador 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
```
+  Para obter detalhes da API, consulte [CreateLoadBalancerListeners](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-ELBLoadBalancerPolicy`
<a name="elastic-load-balancing_CreateLoadBalancerPolicy_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `New-ELBLoadBalancerPolicy`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo cria uma política de protocolo de proxy para um balanceador 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
```
+  Para obter detalhes da API, consulte [CreateLoadBalancerPolicy](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Register-ELBInstanceWithLoadBalancer`
<a name="elastic-load-balancing_RegisterInstancesWithLoadBalancer_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Register-ELBInstanceWithLoadBalancer`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: Esse exemplo registra a EC2 instância especificada com o balanceador de carga especificado.**  

```
Register-ELBInstanceWithLoadBalancer -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Saída**:  

```
InstanceId
----------
i-12345678
i-87654321
```
+  Para obter detalhes da API, consulte [RegisterInstancesWithLoadBalancer](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-ELBInstanceFromLoadBalancer`
<a name="elastic-load-balancing_DeregisterInstancesFromLoadBalancer_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Remove-ELBInstanceFromLoadBalancer`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: Esse exemplo remove a EC2 instância especificada do balanceador de carga especificado. Você recebe uma solicitação de confirmação antes de prosseguir com a operação, a menos que também especifique o parâmetro Force.**  

```
Remove-ELBInstanceFromLoadBalancer -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Saída**:  

```
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
```
+  Para obter detalhes da API, consulte [DeregisterInstancesFromLoadBalancer](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-ELBLoadBalancer`
<a name="elastic-load-balancing_DeleteLoadBalancer_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Remove-ELBLoadBalancer`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo exclui o balanceador de carga especificado. Você recebe uma solicitação de confirmação antes de prosseguir com a operação, a menos que também especifique o parâmetro Force.**  

```
Remove-ELBLoadBalancer -LoadBalancerName my-load-balancer
```
**Saída**:  

```
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"):
```
+  Para obter detalhes da API, consulte [DeleteLoadBalancer](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-ELBLoadBalancerListener`
<a name="elastic-load-balancing_DeleteLoadBalancerListeners_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Remove-ELBLoadBalancerListener`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo exclui o receptor da porta 80 do balanceador de carga especificado. Você recebe uma solicitação de confirmação antes de prosseguir com a operação, a menos que também especifique o parâmetro Force.**  

```
Remove-ELBLoadBalancerListener -LoadBalancerName my-load-balancer -LoadBalancerPort 80
```
**Saída**:  

```
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"):
```
+  Para obter detalhes da API, consulte [DeleteLoadBalancerListeners](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-ELBLoadBalancerPolicy`
<a name="elastic-load-balancing_DeleteLoadBalancerPolicy_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Remove-ELBLoadBalancerPolicy`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo exclui a política especificada do balanceador de carga especificado. Você recebe uma solicitação de confirmação antes de prosseguir com a operação, a menos que também especifique o parâmetro Force.**  

```
Remove-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy
```
**Saída**:  

```
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"):
```
+  Para obter detalhes da API, consulte [DeleteLoadBalancerPolicy](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-ELBResourceTag`
<a name="elastic-load-balancing_RemoveTags_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Remove-ELBResourceTag`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo remove a tag especificada do balanceador de carga especificado. Você recebe uma solicitação de confirmação antes de prosseguir com a operação, a menos que também especifique o parâmetro Force. A sintaxe usada neste exemplo requer a PowerShell versão 3 ou posterior.**  

```
Remove-ELBResourceTag -LoadBalancerName my-load-balancer -Tag @{ Key="project" }
```
**Saída**:  

```
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"):
```
**Exemplo 2: com o PowerShell versão 2, é necessário usar New-Object para criar a tag para o parâmetro de Tag.**  

```
$tag = New-Object Amazon.ElasticLoadBalancing.Model.TagKeyOnly
$tag.Key = "project"
Remove-ELBResourceTag -Tag $tag -Force
```
+  Para obter detalhes da API, consulte [RemoveTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Set-ELBHealthCheck`
<a name="elastic-load-balancing_ConfigureHealthCheck_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Set-ELBHealthCheck`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo define as configurações de verificação de integridade do balanceador 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
```
**Saída**:  

```
HealthyThreshold   : 2
Interval           : 30
Target             : HTTP:80/ping
Timeout            : 3
UnhealthyThreshold : 2
```
+  Para obter detalhes da API, consulte [ConfigureHealthCheck](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Set-ELBLoadBalancerListenerSSLCertificate`
<a name="elastic-load-balancing_SetLoadBalancerListenerSslCertificate_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Set-ELBLoadBalancerListenerSSLCertificate`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo substitui o certificado que encerra as conexões SSL para o receptor especificado.**  

```
Set-ELBLoadBalancerListenerSSLCertificate -LoadBalancerName my-load-balancer `
>> -LoadBalancerPort 443 `
>> -SSLCertificateId "arn:aws:iam::123456789012:server-certificate/new-server-cert"
```
+  Para obter detalhes da API, consulte [SetLoadBalancerListenerSslCertificate](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Set-ELBLoadBalancerPolicyForBackendServer`
<a name="elastic-load-balancing_SetLoadBalancerPoliciesForBackendServer_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Set-ELBLoadBalancerPolicyForBackendServer`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo substitui as políticas da porta especificada pela política especificada.**  

```
Set-ELBLoadBalancerPolicyForBackendServer -LoadBalancerName my-load-balancer -InstancePort 80 -PolicyName my-ProxyProtocol-policy
```
**Exemplo 2: esse exemplo remove todas as políticas associadas à porta especificada.**  

```
Set-ELBLoadBalancerPolicyForBackendServer -LoadBalancerName my-load-balancer -InstancePort 80
```
+  Para obter detalhes da API, consulte [SetLoadBalancerPoliciesForBackendServer](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Set-ELBLoadBalancerPolicyOfListener`
<a name="elastic-load-balancing_SetLoadBalancerPoliciesOfListener_powershell_topic"></a>

O código de exemplo a seguir mostra como usar `Set-ELBLoadBalancerPolicyOfListener`.

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo substitui as políticas do receptor especificado pela política especificada.**  

```
Set-ELBLoadBalancerPolicyOfListener -LoadBalancerName my-load-balancer -LoadBalancerPort 443 -PolicyName my-SSLNegotiation-policy
```
**Exemplo 2: esse exemplo remove todas as políticas associadas ao receptor especificado.**  

```
Set-ELBLoadBalancerPolicyOfListener -LoadBalancerName my-load-balancer -LoadBalancerPort 443
```
+  Para obter detalhes da API, consulte [SetLoadBalancerPoliciesOfListener](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 