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á.
# CodeDeploy exemplos usando o Tools for PowerShell V5
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 CodeDeploy.
*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
### `Add-CDOnPremiseInstanceTag`
O código de exemplo a seguir mostra como usar `Add-CDOnPremiseInstanceTag`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo adiciona uma tag de instância on-premises com a chave e o valor especificados para a instância local especificada.**
```
Add-CDOnPremiseInstanceTag -InstanceName AssetTag12010298EX -Tag @{"Key" = "Name"; "Value" = "CodeDeployDemo-OnPrem"}
```
+ Para obter detalhes da API, consulte [AddTagsToOnPremisesInstances](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDApplication`
O código de exemplo a seguir mostra como usar `Get-CDApplication`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações sobre a aplicação especificada.**
```
Get-CDApplication -ApplicationName CodeDeployDemoApplication
```
**Saída**:
```
ApplicationId ApplicationName CreateTime LinkedToGitHub
------------- --------------- ---------- --------------
e07fb938-091e-4f2f-8963-4d3e8EXAMPLE CodeDeployDemoApplication 7/20/2015 9:49:48 PM False
```
+ Para obter detalhes da API, consulte [GetApplication](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDApplicationBatch`
O código de exemplo a seguir mostra como usar `Get-CDApplicationBatch`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações sobre as aplicações especificadas.**
```
Get-CDApplicationBatch -ApplicationName CodeDeployDemoApplication, CodePipelineDemoApplication
```
**Saída**:
```
ApplicationId ApplicationName CreateTime LinkedToGitHub
------------- --------------- ---------- --------------
e07fb938-091e-4f2f-8963-4d3e8EXAMPLE CodeDeployDemoApplication 7/20/2015 9:49:48 PM False
1ecfd602-62f1-4038-8f0d-06688EXAMPLE CodePipelineDemoApplication 8/13/2015 5:53:26 PM False
```
+ Para obter detalhes da API, consulte [BatchGetApplications](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDApplicationList`
O código de exemplo a seguir mostra como usar `Get-CDApplicationList`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém uma lista das aplicações disponíveis.**
```
Get-CDApplicationList
```
**Saída**:
```
CodeDeployDemoApplication
CodePipelineDemoApplication
```
+ Para obter detalhes da API, consulte [ListApplications](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDApplicationRevision`
O código de exemplo a seguir mostra como usar `Get-CDApplicationRevision`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações sobre a revisão da aplicação especificada.**
```
$revision = Get-CDApplicationRevision -ApplicationName CodeDeployDemoApplication -S3Location_Bucket amzn-s3-demo-bucket -Revision_RevisionType S3 -S3Location_Key 5xd27EX.zip -S3Location_BundleType zip -S3Location_ETag 4565c1ac97187f190c1a90265EXAMPLE
Write-Output ("Description = " + $revision.RevisionInfo.Description + ", RegisterTime = " + $revision.RevisionInfo.RegisterTime)
```
**Saída**:
```
Description = Application revision registered by Deployment ID: d-CX9CHN3EX, RegisterTime = 07/20/2015 23:46:42
```
+ Para obter detalhes da API, consulte [GetApplicationRevision](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDApplicationRevisionList`
O código de exemplo a seguir mostra como usar `Get-CDApplicationRevisionList`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações sobre as revisões disponíveis para a aplicação especificada.**
```
ForEach ($revision in (Get-CDApplicationRevisionList -ApplicationName CodeDeployDemoApplication -Deployed Ignore)) {
>> If ($revision.RevisionType -Eq "S3") {
>> Write-Output ("Type = S3, Bucket = " + $revision.S3Location.Bucket + ", BundleType = " + $revision.S3Location.BundleType + ", ETag = " + $revision.S3Location.ETag + ", Key = " + $revision.S3Location.Key)
>> }
>> If ($revision.RevisionType -Eq "GitHub") {
>> Write-Output ("Type = GitHub, CommitId = " + $revision.GitHubLocation.CommitId + ", Repository = " + $revision.GitHubLocation.Repository)
>> }
>> }
>>
```
**Saída**:
```
Type = S3, Bucket = amzn-s3-demo-bucket, BundleType = zip, ETag = 4565c1ac97187f190c1a90265EXAMPLE, Key = 5xd27EX.zip
Type = GitHub, CommitId = f48933c3...76405362, Repository = MyGitHubUser/CodeDeployDemoRepo
```
+ Para obter detalhes da API, consulte [ListApplicationRevisions](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDDeployment`
O código de exemplo a seguir mostra como usar `Get-CDDeployment`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações de resumo sobre a implantação especificada.**
```
Get-CDDeployment -DeploymentId d-QZMRGSTEX
```
**Saída**:
```
ApplicationName : CodeDeployDemoApplication
CompleteTime : 7/23/2015 11:26:04 PM
CreateTime : 7/23/2015 11:24:43 PM
Creator : user
DeploymentConfigName : CodeDeployDefault.OneAtATime
DeploymentGroupName : CodeDeployDemoFleet
DeploymentId : d-QZMRGSTEX
DeploymentOverview : Amazon.CodeDeploy.Model.DeploymentOverview
Description :
ErrorInformation :
IgnoreApplicationStopFailures : False
Revision : Amazon.CodeDeploy.Model.RevisionLocation
StartTime : 1/1/0001 12:00:00 AM
Status : Succeeded
```
**Exemplo 2: esse exemplo obtém informações sobre o status das instâncias que estão participando da implantação especificada.**
```
(Get-CDDeployment -DeploymentId d-QZMRGSTEX).DeploymentOverview
```
**Saída**:
```
Failed : 0
InProgress : 0
Pending : 0
Skipped : 0
Succeeded : 3
```
**Exemplo 3: esse exemplo obtém informações sobre a revisão da aplicação para a implantação especificada.**
```
(Get-CDDeployment -DeploymentId d-QZMRGSTEX).Revision.S3Location
```
**Saída**:
```
Bucket : amzn-s3-demo-bucket
BundleType : zip
ETag : cfbb81b304ee5e27efc21adaed3EXAMPLE
Key : clzfqEX
Version :
```
+ Para obter detalhes da API, consulte [GetDeployment](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDDeploymentBatch`
O código de exemplo a seguir mostra como usar `Get-CDDeploymentBatch`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações sobre as implantações especificadas.**
```
Get-CDDeploymentBatch -DeploymentId d-QZMRGSTEX, d-RR0T5KTEX
```
**Saída**:
```
ApplicationName : CodeDeployDemoApplication
CompleteTime : 7/23/2015 11:26:04 PM
CreateTime : 7/23/2015 11:24:43 PM
Creator : user
DeploymentConfigName : CodeDeployDefault.OneAtATime
DeploymentGroupName : CodeDeployDemoFleet
DeploymentId : d-QZMRGSTEX
DeploymentOverview : Amazon.CodeDeploy.Model.DeploymentOverview
Description :
ErrorInformation :
IgnoreApplicationStopFailures : False
Revision : Amazon.CodeDeploy.Model.RevisionLocation
StartTime : 1/1/0001 12:00:00 AM
Status : Succeeded
ApplicationName : CodePipelineDemoApplication
CompleteTime : 7/23/2015 6:07:30 PM
CreateTime : 7/23/2015 6:06:29 PM
Creator : user
DeploymentConfigName : CodeDeployDefault.OneAtATime
DeploymentGroupName : CodePipelineDemoFleet
DeploymentId : d-RR0T5KTEX
DeploymentOverview : Amazon.CodeDeploy.Model.DeploymentOverview
Description :
ErrorInformation :
IgnoreApplicationStopFailures : False
Revision : Amazon.CodeDeploy.Model.RevisionLocation
StartTime : 1/1/0001 12:00:00 AM
Status : Succeeded
```
+ Para obter detalhes da API, consulte [BatchGetDeployments](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDDeploymentConfig`
O código de exemplo a seguir mostra como usar `Get-CDDeploymentConfig`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações de resumo sobre a configuração da implantação especificada.**
```
Get-CDDeploymentConfig -DeploymentConfigName ThreeQuartersHealthy
```
**Saída**:
```
CreateTime DeploymentConfigId DeploymentConfigName MinimumHealthyHosts
---------- ------------------ -------------------- -------------------
10/3/2014 4:32:30 PM 518a3950-d034-46a1-9d2c-3c949EXAMPLE ThreeQuartersHealthy Amazon.CodeDeploy.Model.MinimumHealthyHosts
```
**Exemplo 2: esse exemplo obtém informações sobre a configuração da implantação especificada.**
```
Write-Output ((Get-CDDeploymentConfig -DeploymentConfigName ThreeQuartersHealthy).MinimumHealthyHosts)
```
**Saída**:
```
Type Value
---- -----
FLEET_PERCENT 75
```
+ Para obter detalhes da API, consulte [GetDeploymentConfig](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDDeploymentConfigList`
O código de exemplo a seguir mostra como usar `Get-CDDeploymentConfigList`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém uma lista das configurações de implantação disponíveis.**
```
Get-CDDeploymentConfigList
```
**Saída**:
```
ThreeQuartersHealthy
CodeDeployDefault.OneAtATime
CodeDeployDefault.AllAtOnce
CodeDeployDefault.HalfAtATime
```
+ Para obter detalhes da API, consulte [ListDeploymentConfigs](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDDeploymentGroup`
O código de exemplo a seguir mostra como usar `Get-CDDeploymentGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações sobre o grupo de implantação especificado.**
```
Get-CDDeploymentGroup -ApplicationName CodeDeployDemoApplication -DeploymentGroupName CodeDeployDemoFleet
```
**Saída**:
```
ApplicationName : CodeDeployDemoApplication
AutoScalingGroups : {}
DeploymentConfigName : CodeDeployDefault.OneAtATime
DeploymentGroupId : 7d7c098a-b444-4b27-96ef-22791EXAMPLE
DeploymentGroupName : CodeDeployDemoFleet
Ec2TagFilters : {Name}
OnPremisesInstanceTagFilters : {}
ServiceRoleArn : arn:aws:iam::80398EXAMPLE:role/CodeDeploySampleStack-4ph6EX-CodeDeployTrustRole-O9MWP7XTL8EX
TargetRevision : Amazon.CodeDeploy.Model.RevisionLocation
```
+ Para obter detalhes da API, consulte [GetDeploymentGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDDeploymentGroupList`
O código de exemplo a seguir mostra como usar `Get-CDDeploymentGroupList`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém uma lista de grupos de implantação para a aplicação especificada.**
```
Get-CDDeploymentGroupList -ApplicationName CodeDeployDemoApplication
```
**Saída**:
```
ApplicationName DeploymentGroups NextToken
--------------- ---------------- ---------
CodeDeployDemoApplication {CodeDeployDemoFleet, CodeDeployProductionFleet}
```
+ Para obter detalhes da API, consulte [ListDeploymentGroups](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDDeploymentInstance`
O código de exemplo a seguir mostra como usar `Get-CDDeploymentInstance`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações sobre a instância especificada para a implantação especificada.**
```
Get-CDDeploymentInstance -DeploymentId d-QZMRGSTEX -InstanceId i-254e22EX
```
**Saída**:
```
DeploymentId : d-QZMRGSTEX
InstanceId : arn:aws:ec2:us-east-1:80398EXAMPLE:instance/i-254e22EX
LastUpdatedAt : 7/23/2015 11:25:24 PM
LifecycleEvents : {ApplicationStop, DownloadBundle, BeforeInstall, Install...}
Status : Succeeded
```
+ Para obter detalhes da API, consulte [GetDeploymentInstance](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDDeploymentInstanceList`
O código de exemplo a seguir mostra como usar `Get-CDDeploymentInstanceList`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo obtém uma lista de instâncias IDs para a implantação especificada.**
```
Get-CDDeploymentInstanceList -DeploymentId d-QZMRGSTEX
```
**Saída**:
```
i-254e22EX
i-274e22EX
i-3b4e22EX
```
+ Para obter detalhes da API, consulte [ListDeploymentInstances](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDDeploymentList`
O código de exemplo a seguir mostra como usar `Get-CDDeploymentList`.
**Ferramentas para PowerShell V5**
**Exemplo 1: Este exemplo obtém uma lista de implantações IDs para o aplicativo e o grupo de implantação especificados.**
```
Get-CDDeploymentList -ApplicationName CodeDeployDemoApplication -DeploymentGroupName CodeDeployDemoFleet
```
**Saída**:
```
d-QZMRGSTEX
d-RR0T5KTEX
```
+ Para obter detalhes da API, consulte [ListDeployments](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDOnPremiseInstance`
O código de exemplo a seguir mostra como usar `Get-CDOnPremiseInstance`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações sobre a instância on-premises especificada.**
```
Get-CDOnPremiseInstance -InstanceName AssetTag12010298EX
```
**Saída**:
```
DeregisterTime : 1/1/0001 12:00:00 AM
IamUserArn : arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser
InstanceArn : arn:aws:codedeploy:us-east-1:80398EXAMPLE:instance/AssetTag12010298EX_rDH556dxEX
InstanceName : AssetTag12010298EX
RegisterTime : 4/3/2015 6:36:24 PM
Tags : {Name}
```
+ Para obter detalhes da API, consulte [GetOnPremisesInstance](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDOnPremiseInstanceBatch`
O código de exemplo a seguir mostra como usar `Get-CDOnPremiseInstanceBatch`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém informações sobre as instâncias on-premises especificadas.**
```
Get-CDOnPremiseInstanceBatch -InstanceName AssetTag12010298EX, AssetTag12010298EX-2
```
**Saída**:
```
DeregisterTime : 1/1/0001 12:00:00 AM
IamUserArn : arn:aws:iam::80398EXAMPLE:user/CodeDeployFRWUser
InstanceArn : arn:aws:codedeploy:us-east-1:80398EXAMPLE:instance/AssetTag12010298EX-2_XmeSz18rEX
InstanceName : AssetTag12010298EX-2
RegisterTime : 4/3/2015 6:38:52 PM
Tags : {Name}
DeregisterTime : 1/1/0001 12:00:00 AM
IamUserArn : arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser
InstanceArn : arn:aws:codedeploy:us-east-1:80398EXAMPLE:instance/AssetTag12010298EX_rDH556dxEX
InstanceName : AssetTag12010298EX
RegisterTime : 4/3/2015 6:36:24 PM
Tags : {Name}
```
+ Para obter detalhes da API, consulte [BatchGetOnPremisesInstances](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Get-CDOnPremiseInstanceList`
O código de exemplo a seguir mostra como usar `Get-CDOnPremiseInstanceList`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo obtém uma lista de nomes de instâncias on-premises disponíveis.**
```
Get-CDOnPremiseInstanceList
```
**Saída**:
```
AssetTag12010298EX
AssetTag12010298EX-2
```
+ Para obter detalhes da API, consulte [ListOnPremisesInstances](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-CDApplication`
O código de exemplo a seguir mostra como usar `New-CDApplication`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo cria uma aplicação com o nome especificado.**
```
New-CDApplication -ApplicationName MyNewApplication
```
**Saída**:
```
f19e4b61-2231-4328-b0fd-e57f5EXAMPLE
```
+ Para obter detalhes da API, consulte [CreateApplication](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-CDDeployment`
O código de exemplo a seguir mostra como usar `New-CDDeployment`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo cria uma implantação para a aplicação e o grupo de implantação especificados com a configuração de implantação e a revisão da aplicação especificadas.**
```
New-CDDeployment -ApplicationName MyNewApplication -S3Location_Bucket amzn-s3-demo-bucket -S3Location_BundleType zip -DeploymentConfigName CodeDeployDefault.OneAtATime -DeploymentGroupName MyNewDeploymentGroup -IgnoreApplicationStopFailures $True -S3Location_Key aws-codedeploy_linux-master.zip -RevisionType S3
```
**Saída**:
```
d-ZHROG7UEX
```
**Exemplo 2: Este exemplo mostra como especificar grupos de tags de EC2 instância pelos quais uma instância deve ser identificada para que seja incluída no ambiente substituto de uma blue/green implantação.**
```
New-CDDeployment -ApplicationName MyNewApplication -S3Location_Bucket amzn-s3-demo-bucket -S3Location_BundleType zip -DeploymentConfigName CodeDeployDefault.OneAtATime -DeploymentGroupName MyNewDeploymentGroup -IgnoreApplicationStopFailures $True -S3Location_Key aws-codedeploy_linux-master.zip -RevisionType S3 -Ec2TagSetList @(@{Key="key1";Type="KEY_ONLY"},@{Key="Key2";Type="KEY_AND_VALUE";Value="Value2"}),@(@{Key="Key3";Type="VALUE_ONLY";Value="Value3"})
```
**Saída**:
```
d-ZHROG7UEX
```
+ Para obter detalhes da API, consulte [CreateDeployment](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-CDDeploymentConfig`
O código de exemplo a seguir mostra como usar `New-CDDeploymentConfig`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo cria uma configuração de implantação com o nome e o comportamento especificados.**
```
New-CDDeploymentConfig -DeploymentConfigName AtLeastTwoHealthyHosts -MinimumHealthyHosts_Type HOST_COUNT -MinimumHealthyHosts_Value 2
```
**Saída**:
```
0f3e8187-44ef-42da-aeed-b6823EXAMPLE
```
+ Para obter detalhes da API, consulte [CreateDeploymentConfig](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `New-CDDeploymentGroup`
O código de exemplo a seguir mostra como usar `New-CDDeploymentGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo cria um grupo de implantação com o nome, o grupo do Auto Scaling, a configuração de implantação, a tag e o perfil de serviço especificados para a aplicação especificada.**
```
New-CDDeploymentGroup -ApplicationName MyNewApplication -AutoScalingGroup CodeDeployDemo-ASG -DeploymentConfigName CodeDeployDefault.OneAtATime -DeploymentGroupName MyNewDeploymentGroup -Ec2TagFilter @{Key="Name"; Type="KEY_AND_VALUE"; Value="CodeDeployDemo"} -ServiceRoleArn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo
```
**Saída**:
```
16bbf199-95fd-40fc-a909-0bbcfEXAMPLE
```
**Exemplo 2: Este exemplo mostra como especificar grupos de tags de EC2 instância pelos quais uma instância deve ser identificada para que seja incluída no ambiente substituto de uma blue/green implantação.**
```
New-CDDeploymentGroup -ApplicationName MyNewApplication -AutoScalingGroup CodeDeployDemo-ASG -DeploymentConfigName CodeDeployDefault.OneAtATime -DeploymentGroupName MyNewDeploymentGroup -Ec2TagFilter @{Key="Name"; Type="KEY_AND_VALUE"; Value="CodeDeployDemo"} -ServiceRoleArn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo -Ec2TagSetList @(@{Key="key1";Type="KEY_ONLY"},@{Key="Key2";Type="KEY_AND_VALUE";Value="Value2"}),@(@{Key="Key3";Type="VALUE_ONLY";Value="Value3"})
```
**Saída**:
```
16bbf199-95fd-40fc-a909-0bbcfEXAMPLE
```
+ Para obter detalhes da API, consulte [CreateDeploymentGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Register-CDApplicationRevision`
O código de exemplo a seguir mostra como usar `Register-CDApplicationRevision`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo registra uma revisão da aplicação com o local do Amazon S3 especificado para a aplicação especificada.**
```
Register-CDApplicationRevision -ApplicationName MyNewApplication -S3Location_Bucket amzn-s3-demo-bucket -S3Location_BundleType zip -S3Location_Key aws-codedeploy_linux-master.zip -Revision_RevisionType S3
```
+ Para obter detalhes da API, consulte [RegisterApplicationRevision](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Register-CDOnPremiseInstance`
O código de exemplo a seguir mostra como usar `Register-CDOnPremiseInstance`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo registra uma instância on-premises com o nome e o usuário do IAM especificados.**
```
Register-CDOnPremiseInstance -IamUserArn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser -InstanceName AssetTag12010298EX
```
+ Para obter detalhes da API, consulte [RegisterOnPremisesInstance](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-CDApplication`
O código de exemplo a seguir mostra como usar `Remove-CDApplication`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo exclui a aplicação com o nome especificado. O comando solicitará a confirmação antes de continuar. Adicione o parâmetro -Force para excluir a aplicação sem um aviso.**
```
Remove-CDApplication -ApplicationName MyNewApplication
```
+ Para obter detalhes da API, consulte [DeleteApplication](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-CDDeploymentConfig`
O código de exemplo a seguir mostra como usar `Remove-CDDeploymentConfig`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo exclui a configuração de implantação com o nome especificado. O comando solicitará a confirmação antes de continuar. Adicione o parâmetro -Force para excluir a configuração de implantação sem um aviso.**
```
Remove-CDDeploymentConfig -DeploymentConfigName AtLeastTwoHealthyHosts
```
+ Para obter detalhes da API, consulte [DeleteDeploymentConfig](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-CDDeploymentGroup`
O código de exemplo a seguir mostra como usar `Remove-CDDeploymentGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo exclui o grupo de implantação com o nome especificado para a aplicação especificada. O comando solicitará a confirmação antes de continuar. Adicione o parâmetro -Force para excluir o grupo de implantação sem um aviso.**
```
Remove-CDDeploymentGroup -ApplicationName MyNewApplication -DeploymentGroupName MyNewDeploymentGroup
```
+ Para obter detalhes da API, consulte [DeleteDeploymentGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Remove-CDOnPremiseInstanceTag`
O código de exemplo a seguir mostra como usar `Remove-CDOnPremiseInstanceTag`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo exclui a tag especificada para a instância on-premises com o nome especificado. O comando solicitará a confirmação antes de continuar. Adicione o parâmetro -Force para excluir a tag sem um aviso.**
```
Remove-CDOnPremiseInstanceTag -InstanceName AssetTag12010298EX -Tag @{"Key" = "Name"; "Value" = "CodeDeployDemo-OnPrem"}
```
+ Para obter detalhes da API, consulte [RemoveTagsFromOnPremisesInstances](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Stop-CDDeployment`
O código de exemplo a seguir mostra como usar `Stop-CDDeployment`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo tenta interromper a implantação com o ID de implantação especificado.**
```
Stop-CDDeployment -DeploymentId d-LJQNREYEX
```
**Saída**:
```
Status StatusMessage
------ -------------
Pending Stopping Pending. Stopping to schedule commands in the deployment instances
```
+ Para obter detalhes da API, consulte [StopDeployment](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Unregister-CDOnPremiseInstance`
O código de exemplo a seguir mostra como usar `Unregister-CDOnPremiseInstance`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo cancela o registro de uma instância on-premises com o nome especificado.**
```
Unregister-CDOnPremiseInstance -InstanceName AssetTag12010298EX
```
+ Para obter detalhes da API, consulte [DeregisterOnPremisesInstance](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Update-CDApplication`
O código de exemplo a seguir mostra como usar `Update-CDApplication`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo altera o nome da aplicação especificada.**
```
Update-CDApplication -ApplicationName MyNewApplication -NewApplicationName MyNewApplication-2
```
+ Para obter detalhes da API, consulte [UpdateApplication](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.
### `Update-CDDeploymentGroup`
O código de exemplo a seguir mostra como usar `Update-CDDeploymentGroup`.
**Ferramentas para PowerShell V5**
**Exemplo 1: esse exemplo altera o nome do grupo de implantação especificado para a aplicação especificada.**
```
Update-CDDeploymentGroup -ApplicationName MyNewApplication -CurrentDeploymentGroupName MyNewDeploymentGroup -NewDeploymentGroupName MyNewDeploymentGroup-2
```
**Exemplo 2: Este exemplo mostra como especificar grupos de tags de EC2 instância pelos quais uma instância deve ser identificada para que seja incluída no ambiente substituto de uma blue/green implantação.**
```
Update-CDDeploymentGroup -ApplicationName MyNewApplication -CurrentDeploymentGroupName MyNewDeploymentGroup -NewDeploymentGroupName MyNewDeploymentGroup-2 -Ec2TagSetList @(@{Key="key1";Type="KEY_ONLY"},@{Key="Key2";Type="KEY_AND_VALUE";Value="Value2"}),@(@{Key="Key3";Type="VALUE_ONLY";Value="Value3"})
```
+ Para obter detalhes da API, consulte [UpdateDeploymentGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.