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á. # Migrando da Ferramentas da AWS para PowerShell versão 4 para a versão 5 Ferramentas da AWS para PowerShell a versão 5 (V5) tem alterações significativas, o que pode fazer com que seus scripts existentes parem de funcionar. Este tópico descreve as mudanças importantes na V5 e o possível trabalho que talvez você precise fazer para migrar seu ambiente ou código da V4. Para obter informações adicionais sobre mudanças notáveis no, consulte Ferramentas da AWS para PowerShell também os seguintes recursos: + A postagem do blog [Ferramentas da AWS para PowerShell V5 agora está disponível ao público em geral](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v5-now-generally-available/). + O [problema do V5 Development Tracker](https://github.com/aws/aws-tools-for-powershell/issues/357) em. GitHub Além da lista de alterações importantes, não deixe de conferir os detalhes de cada prévia. + A postagem do blog [Prévia 1 da Ferramentas da AWS para PowerShell V5](https://aws.amazon.com/blogs/developer/preview-1-of-aws-tools-for-powershell-v5/) **nota** Como Ferramentas da AWS para PowerShell dependem do AWS SDK para .NET, algumas das mudanças relacionadas à V4 do SDK também podem afetar a V5 do Tools for. PowerShell Para ver o que mudou na V4 do AWS SDK para .NET, consulte as [informações de migração](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html) no [Guia do AWS SDK para .NET desenvolvedor](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/). ## PowerShell Versão mínima Para a versão antiga, específica para Windows, de módulo único e grande do Ferramentas da AWS para PowerShell, chamada *AWSPowerShell*, a versão mínima suportada PowerShell do módulo foi atualizada para 5.1. Isso deve corresponder à AWS SDK para .NET nova versão mínima do.NET Framework 4.7.2. Para obter mais informações sobre o módulo AWSPower Shell legado, consulte[Instalar no Windows](pstools-getting-set-up-windows.md). ## Instale ou atualize a `AWS.Tools` V4 Ao instalar ou atualizar a versão modularizada dos `Update-AWSToolsModule` cmdlets Ferramentas da AWS para PowerShell, chamada, the `Install-AWSToolsModule` e`AWS.Tools`, naturalmente, usará a versão 5 do por padrão. `AWS.Tools` Se, por algum motivo, você precisar instalar ou atualizar a versão 4 do`AWS.Tools`, poderá fazer isso usando os seguintes comandos, respectivamente: ``` Install-AWSToolsModule -MaximumVersion '4.9.999' Update-AWSToolsModule -MaximumVersion '4.9.999' ``` Para obter informações adicionais sobre a instalação e atualização do Tools for PowerShell, consulte [Conceitos básicos](pstools-getting-set-up.md) ## Cancelar a execução do cmdlet com CTRL\$1C A versão 5 do Ferramentas da AWS para PowerShell permite cancelar a execução do cmdlet usando um atalho de teclado, como CTRL\$1C. ## Tipos de valores anuláveis Os tipos adotados do AWS SDK para .NET foram atualizados para usar as novas alterações anuláveis do SDK. Por exemplo, propriedades do tipo `int` foram alteradas para`Nullable[int]`. Essa alteração não afeta a forma como os valores dos parâmetros de entrada são especificados para os cmdlets da AWS porque esses parâmetros de tipo de valor já foram modelados como anuláveis. No entanto, os tipos anuláveis para a saída do cmdlet são uma alteração importante porque as propriedades na saída do cmdlet conterão, `$null` em vez dos vários valores padrão dos tipos. O exemplo a seguir demonstra o comportamento na V4 do Tools for. PowerShell Neste exemplo, a `MissingMeta` propriedade é definida como 0 porque esse é o valor padrão do tipo`int`. ``` # In V4 PS > Get-S3ObjectMetadata -BucketName amzn-s3-demo-bucket -Key 'test' | >> Select LastModified, MissingMeta, ObjectLockRetainUntilDate, BucketKeyEnabled LastModified MissingMeta ObjectLockRetainUntilDate BucketKeyEnabled ------------ ----------- ------------------------- ---------------- 8/29/2023 10:20:44 PM 0 1/1/0001 12:00:00 AM ``` O exemplo a seguir demonstra o comportamento na V5 do Tools for. PowerShell Neste exemplo, a `MissingMeta` propriedade está definida como`$null`. ``` # In V5 PS > Get-S3ObjectMetadata -BucketName amzn-s3-demo-bucket -Key 'test' | >> Select LastModified, MissingMeta, ObjectLockRetainUntilDate, BucketKeyEnabled LastModified MissingMeta ObjectLockRetainUntilDate BucketKeyEnabled ------------ ----------- ------------------------- ---------------- 8/29/2023 10:20:44 PM ``` Na maioria dos casos, nenhuma alteração de código é necessária porque PowerShell tem conversão implícita de tipos de valores anuláveis para tipos de valores não anuláveis. No entanto, essa é uma alteração importante no código de lógica de comparação que verifica explicitamente o valor padrão de um tipo de valor anulável. A lógica de comparação que verifica o valor padrão de um tipo não anulável deve ser modificada para verificação. `$null` Para alguns desses tipos, os exemplos a seguir mostram como atualizar o código escrito para a V4 que verifica se nada foi retornado: ``` #Type int: # In V4, if you were checking whether an int is 0... if($s3Metadata.MissingMeta -eq 0){} # In V5, check if the int is null instead: if($s3Metadata.MissingMeta -eq $null) {} # Type datetime: # In V4, if you were checking whether a datetime is '0001-01-01'... if($s3Metadata.ObjectLockRetainUntilDate -eq '0001-01-01'){} # In V5, check if the datetime is null instead: if($s3Metadata.ObjectLockRetainUntilDate -eq $null){} # Type boolean: # In V4, if you were checking whether a boolean is $false... if($s3Metadata.BucketKeyEnabled -eq $false){} # In V5, check if the boolean is null instead: if($s3Metadata.BucketKeyEnabled -eq $null) ``` Como Ferramentas da AWS para PowerShell dependem do AWS SDK para .NET, pode ser útil examinar como mudanças semelhantes afetaram a versão 4 do SDK. Para encontrar essas informações, consulte o conteúdo [de migração de tipos de valor](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html#net-dg-v4-value-types) no [Guia do AWS SDK para .NET desenvolvedor](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/). ## Coleções Algumas saídas de cmdlet foram alteradas para retornar `$null` em vez de coleções vazias do tipo `List` ou. `Dictionary` Para obter informações adicionais, incluindo como reverter para o comportamento legado, consulte o conteúdo de migração para [Coleções](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html#net-dg-v4-collections) no [Guia do AWS SDK para .NET Desenvolvedor](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/). ## DateTime versus UTC DateTime Alguns cmdlets V4 definem DateTime parâmetros que são obsoletos, bem como parâmetros UTC alternativos. DateTime Esses DateTime parâmetros obsoletos foram removidos dos cmdlets V5 e o nome dos parâmetros UTC foi alterado para o nome original dos DateTime parâmetros não UTC. DateTime A seguir estão alguns exemplos de cmdlets para os quais essa alteração foi implementada. + `Get-ASScheduledAction`(cmdlet [V4 e cmdlet](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-ASScheduledAction.html) [V5](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-ASScheduledAction.html)): + O `StartTime` parâmetro foi removido e o nome do `UtcStartTime` parâmetro foi alterado para "StartTime”. + O `EndTime` parâmetro foi removido e o nome do `UtcEndTime` parâmetro foi alterado para "EndTime”. + `Copy-S3Object`(cmdlet [V4 e cmdlet](https://docs.aws.amazon.com/powershell/v4/reference/items/Copy-S3Object.html) [V5](https://docs.aws.amazon.com/powershell/v5/reference/items/Copy-S3Object.html)): + O `ModifiedSinceDate` parâmetro foi removido e o nome do `UtcModifiedSinceDate` parâmetro foi alterado para "ModifiedSinceDate”. + O `UnmodifiedSinceDate` parâmetro foi removido e o nome do `UtcUnmodifiedSinceDate` parâmetro foi alterado para "UnmodifiedSinceDate”. A seguir está uma lista completa dos cmdlets afetados por essa alteração. ### Abrir para ver itens + [Get- ASScheduled Action](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-ASScheduledAction.html) + [Escreva- ASScheduled UpdateGroupAction](https://docs.aws.amazon.com/powershell/v5/reference/items/Write-ASScheduledUpdateGroupAction.html) + [Obtenha o CWAlarm histórico](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-CWAlarmHistory.html) + [Obter CWMetric dados](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-CWMetricData.html) + [Get- CWMetric Statistic](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-CWMetricStatistic.html) (também conhecido como Get- CWMetric Statistics) + [New-EC2Fleet](https://docs.aws.amazon.com/powershell/v5/reference/items/New-EC2Fleet.html) + [Get-EC2FleetHistory](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2FleetHistory.html) + [Get-EC2ScheduledInstance](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2ScheduledInstance.html) + [Get-EC2ScheduledInstanceAvailability](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2ScheduledInstanceAvailability.html) + [Get-EC2SpotFleetRequestHistory](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2SpotFleetRequestHistory.html) + [Get-EC2SpotPriceHistory](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2SpotPriceHistory.html) + [Import-EC2Image](https://docs.aws.amazon.com/powershell/v5/reference/items/Import-EC2Image.html) + [Import-EC2Snapshot](https://docs.aws.amazon.com/powershell/v5/reference/items/Import-EC2Snapshot.html) + [Request-EC2SpotFleet](https://docs.aws.amazon.com/powershell/v5/reference/items/Request-EC2SpotFleet.html) + [Request-EC2SpotInstance](https://docs.aws.amazon.com/powershell/v5/reference/items/Request-EC2SpotInstance.html) + [Send-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/v5/reference/items/Send-EC2InstanceStatus.html) + [Obtenha- ECEvent](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-ECEvent.html) + [Obtenha- EBEnvironment](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EBEnvironment.html) + [Obtenha- EBEvent](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EBEvent.html) + [Obter uma IOTTask lista](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-IOTTaskList.html) + [Obtenha- IOTViolation EventList](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-IOTViolationEventList.html) + [Obtenha- RDSEvent](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-RDSEvent.html) + [Reiniciar- RDSDBCluster](https://docs.aws.amazon.com/powershell/v5/reference/items/Reset-RDSDBCluster.html) + [Restaurar- RDSDBCluster ToPointInTime](https://docs.aws.amazon.com/powershell/v5/reference/items/Restore-RDSDBClusterToPointInTime.html) + [Restaurar- RDSDBInstance ToPointInTime](https://docs.aws.amazon.com/powershell/v5/reference/items/Restore-RDSDBInstanceToPointInTime.html) + [Get- RSCluster Snapshot](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-RSClusterSnapshot.html) (também conhecido como Get- RSCluster Snapshots) + [Get- RSEvent](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-RSEvent.html) (também conhecido como Get-) RSEvents + [Copy-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Copy-S3Object.html) + [Read-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Read-S3Object.html) + [Get-S3ObjectMetadata](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3ObjectMetadata.html) + [Enviar- SESBounce](https://docs.aws.amazon.com/powershell/v5/reference/items/Send-SESBounce.html) + [Obtenha- WDActivity](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-WDActivity.html) ## Tubulação e `$AWSHistory` Nas versões Ferramentas da AWS para PowerShell anteriores à V4, `$AWSHistory` foi introduzida uma variável de sessão chamada que mantém um registro das invocações de AWS cmdlet e das respostas de serviço recebidas para cada invocação. Na V4 do Tools for PowerShell, essa variável de sessão foi descontinuada em favor do `-Select *` parâmetro e do argumento, que podem ser usados para retornar toda a resposta do serviço. O `-Select *` parâmetro é descrito em[Pipelining, saída e iteração](pstools-pipelines.md). Na V5 do Tools for PowerShell, a variável de `$AWSHistory` sessão foi removida completamente. Como consequência, os `Set-AWSHistoryConfiguration` cmdlets `Clear-AWSHistory` e também foram removidos. ## O parâmetro `-PassThru` O `-PassThru` parâmetro foi removido. Quando um cmdlet não retorna nenhuma saída por padrão, os usuários podem solicitar um valor de parâmetro retornado usando. `-Select ^ParameterName` Para obter mais detalhes e exemplos, consulte a postagem do blog [Preview 1 of Ferramentas da AWS para PowerShell V5](https://aws.amazon.com/blogs/developer/preview-1-of-aws-tools-for-powershell-v5/). ## Alguns cmdlets do DynamoDB foram movidos e renomeados Os `Get-DDBStreamList` cmdlets `Get-DDBStream` e foram movidos do módulo Dynamo para um novo DBV2 módulo chamado Dynamo. DBStreams Eles também foram renomeados para [Get- DDBSStream](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-DDBSStream.html) e [Get- DDBSStream List](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-DDBSStreamList.html), respectivamente. ## Armazenamento em log de informações sensíveis O comportamento de registro foi alterado para que informações potencialmente confidenciais tenham menos probabilidade de serem incluídas na saída do cmdlet, especialmente em CI/CD situações. Para obter mais informações e instruções sobre como reverter para o comportamento V4, consulte. [Armazenamento em log de informações sensíveis](additional-security-considerations.md#add-sec-cons-sensitive-logs) ## Resolução de perfil e credenciais Eles Ferramentas da AWS para PowerShell foram atualizados para usar determinadas variáveis de ambiente ao resolver as credenciais de um cmdlet:`AWS_PROFILE`,,, e. `AWS_ACCESS_KEY_ID` `AWS_SECRET_ACCESS_KEY` `AWS_SESSION_TOKEN` Além disso, houve algumas mudanças na ordem de resolução de credenciais e perfis. Para obter mais informações, consulte [Resolução de perfil e credenciais](creds-assign.md). ## Mensagem de erro de credencial A mensagem de erro que ele Ferramentas da AWS para PowerShell retorna se não conseguir obter as credenciais apropriadas foi alterada. Na v4 das ferramentas, a mensagem era semelhante à seguinte: ``` Get-SFNExecutionList -Region us-west-2 Get-SFNExecutionList: No credentials specified or obtained from persisted/shell defaults. ``` Na V5 das ferramentas, a mensagem é semelhante à seguinte: ``` Get-SFNExecutionList -Region us-west-2 Get-SFNExecutionList: Failed to resolve AWS credentials. The credential providers used to search for credentials returned the following errors: ... ``` ## Iteração automática consistente Todos os cmdlets paginados foram atualizados para iterar automaticamente todos os dados por padrão. Você pode reverter esse comportamento usando o AWSAuto IterationMode cmdlet [Set-](https://docs.aws.amazon.com/powershell/v5/reference/items/Set-AWSAutoIterationMode.html). Se você executar`Set-AWSAutoIterationMode -IterationMode v4`, as operações que foram iteradas automaticamente na v4 ainda serão iteradas automaticamente, mas o resto será revertido para iteração manual. Para determinar em qual modo a iteração automática está definida, use o cmdlet [Get- AWSAuto IterationMode](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSAutoIterationMode.html). [Para ver um exemplo de um cmdlet que foi atualizado dessa forma, consulte o cmdlet (cmdlet [V4 e `Get-CWLLogEvent` cmdlet V5](https://docs.aws.amazon.com/powershell/v4/reference/index.html?page=Get-CWLLogEvent.html&tocid=Get-CWLLogEvent)).](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Get-CWLLogEvent.html&tocid=Get-CWLLogEvent) Para obter detalhes sobre a iteração automática, consulte. [Iteração por meio de dados paginados](pstools-pipelines.md#pstools-iteration) ## Cmdlets do S3 obsoletos e substituídos [Para o Amazon S3, os cmdlets [Get-S3Acl e Set-S3Acl](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3ACL.html) foram descontinuados.](https://docs.aws.amazon.com/powershell/v5/reference/items/Set-S3ACL.html) [https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3ObjectACL.html](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3ObjectACL.html) ## Parâmetros-chave de limpeza e corte do S3 Alguns cmdlets do Amazon S3 aceitam parâmetros chamados e. `Key` `KeyPrefix` A V4 do Ferramentas da AWS para PowerShell limparia e cortaria esses parâmetros das seguintes maneiras: removeria espaços iniciais, barras avançadas (“/”) e barras invertidas (“\$1”), converteria todas as outras barras invertidas em barras e removeria espaços finais. Na V5 do Tools for PowerShell, esse não é mais o comportamento padrão. Você pode reverter esse comportamento especificando o `-EnableLegacyKeyCleaning` parâmetro. Essas informações se aplicam aos seguintes cmdlets: + [Copy-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Copy-S3Object.html) + [Get-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3Object.html) + [Get-S3ObjectV2](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3ObjectV2.html) + [Read-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Read-S3Object.html) + [Remove-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Remove-S3Object.html) + [Conjuntos S3ACL](https://docs.aws.amazon.com/powershell/v5/reference/items/Set-S3ACL.html) + [Write-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Write-S3Object.html) ## Capacidades de sessão interativa Os recursos de sessão interativa foram adicionados ao SSMSession cmdlet [Start-](https://docs.aws.amazon.com/powershell/v5/reference/items/Start-SSMSession.html), que se alinha ao comportamento. AWS CLI Por exemplo: ``` Start-SSMSession -Target 'i-1234567890abcdef0' ``` Se você precisar de um comportamento legado, inclua o `-DisablePluginInvocation` parâmetro no `Start-SSMSession` comando. ## CloudWatch alarmes O CWAlarm cmdlet [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-CWAlarm.html) foi atualizado para retornar alarmes métricos e compostos da CloudWatch Amazon por padrão. Para limitar a saída a alarmes métricos ou compostos, você deve especificar o `-AlarmType` parâmetro: `Get-CWAlarm -AlarmType 'MetricAlarms'` ou`Get-CWAlarm -AlarmType 'CompositeAlarms'`, respectivamente. ## `LitJson` Eles Ferramentas da AWS para PowerShell foram atualizados para uso `System.Text.Json` em vez `LitJson` de serialização. `LitJson`foi removido da V5 das ferramentas. ## A propriedade `LoggedAt` de saída A propriedade `LoggedAt` de saída foi removida. Na V4 das ferramentas, essa propriedade foi retornada por padrão em alguns cmdlets (por exemplo `Get-SSMCommandInvocationDetail` e). `Invoke-LMFunction` Se precisar replicar as informações fornecidas pela propriedade de `LoggedAt` saída, você pode incluir algo semelhante ao seguinte em seus scripts: ``` $loggedAt = (Get-Date).ToUniversalTime().ToString('s') ``` ## Elementos de programação que foram removidos Vários elementos de programação foram removidos da V5 do Tools for PowerShell. Eles estão listados abaixo, se ainda não foram abordados anteriormente, junto com as possíveis etapas que você pode tomar para acomodar sua remoção, se houver. + O `Invoke-LMFunctionAsync` cmdlet. + O `Get-EC2ImageByName` cmdlet. Em vez disso, use o cmdlet [Get- SSMLatest EC2 Image](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-SSMLatestEC2Image.html). + O `CalculateContentMD5Header` parâmetro do [Write-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Write-S3Object.html)cmdlet.