AWS powershell medium security documentation change
Summary
Added sections for installing AWS.Tools V4 and canceling cmdlet execution with keyboard shortcuts. Updated Start-SSMSession example and deprecated Get-EC2ImageByName in favor of Get-SSMLatestEC2Image.
Security assessment
The deprecation of Get-EC2ImageByName and recommendation to use Get-SSMLatestEC2Image suggests a move toward ensuring users retrieve the latest AMIs, which likely include security updates. Using outdated AMIs can expose systems to vulnerabilities, making this a security-related change.
Diff
diff --git a/powershell/v5/userguide/migrating-v5.md b/powershell/v5/userguide/migrating-v5.md index 3a2052853..419b13d97 100644 --- a//powershell/v5/userguide/migrating-v5.md +++ b//powershell/v5/userguide/migrating-v5.md @@ -5 +5 @@ -Minimum PowerShell versionNullable value typesCollectionsDateTime versus UTC DateTimePipelining and $AWSHistoryThe -PassThru parameterSome DynamoDB cmdlets moved and renamedLogging of sensitive informationCredential and profile resolutionConsistent Auto-IterationS3 cmdlets deprecated and replacedCleaning and trimming S3 key parametersInteractive session capabilitiesCloudWatch alarmsLitJsonProgramming elements that were removed +Minimum PowerShell versionInstall or update AWS.Tools V4Cancel cmdlet execution with CTRL+C and CMD+CNullable value typesCollectionsDateTime versus UTC DateTimePipelining and $AWSHistoryThe -PassThru parameterSome DynamoDB cmdlets moved and renamedLogging of sensitive informationCredential and profile resolutionConsistent Auto-IterationS3 cmdlets deprecated and replacedCleaning and trimming S3 key parametersInteractive session capabilitiesCloudWatch alarmsLitJsonProgramming elements that were removed @@ -24,0 +25,14 @@ For more information about the AWSPowerShell module, see [Installing on Windows] +## Install or update `AWS.Tools` V4 + +When installing or updating the modularized version of the AWS Tools for PowerShell, called `AWS.Tools`, the `Install-AWSToolsModule` and `Update-AWSToolsModule` cmdlets will naturally use version 5 of `AWS.Tools` by default. If for some reason you need to install or update version 4 of `AWS.Tools` instead, you can do so by using the following commands, respectively: + + + Install-AWSToolsModule -MaximumVersion '4.9.999' + Update-AWSToolsModule -MaximumVersion '4.9.999' + +For additional information about installing and updating the Tools for PowerShell, see [Get started](./pstools-getting-started.html) + +## Cancel cmdlet execution with CTRL+C and CMD+C + +Version 5 of the AWS Tools for PowerShell allows you to cancel cmdlet execution by using a keyboard shortcut such as CTRL+C or CMD+C. + @@ -230 +244,2 @@ This information applies to the following cmdlets: -Interactive session capabilities have been added to the [Start-SSMSession](https://docs.aws.amazon.com/powershell/v5/reference/items/Start-SSMSession.html) cmdlet, which aligns with the AWS CLI behavior. If you need legacy behavior, include the `-DisablePluginInvocation` parameter in the `Start-SSMSession` command. For example: +Interactive session capabilities have been added to the [Start-SSMSession](https://docs.aws.amazon.com/powershell/v5/reference/items/Start-SSMSession.html) cmdlet, which aligns with the AWS CLI behavior. For example: + @@ -231,0 +247 @@ Interactive session capabilities have been added to the [Start-SSMSession](https + Start-SSMSession -Target 'i-1234567890abcdef0' @@ -233 +249 @@ Interactive session capabilities have been added to the [Start-SSMSession](https - Start-SSMSession -Target 'i-1234567890abcdef0' -DisablePluginInvocation +If you need legacy behavior, include the `-DisablePluginInvocation` parameter in the `Start-SSMSession` command. @@ -249 +265 @@ A number of programming elements have been removed from V5 of the Tools for Powe - * The `Get-EC2ImageByName` cmdlet. + * The `Get-EC2ImageByName` cmdlet. Use the [Get-SSMLatestEC2Image](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-SSMLatestEC2Image.html) cmdlet instead.