V5 Development Tracker

[afroz429]

V5 Development Tracker

This issue is for tracking the changes being made for V5 of the AWS Tools for PowerShell. Development of V5 is happening in the v5-development branch in this repository. V5 is an evolutionary major version change with minimal breaking changes so existing code can upgrade to V5 with low effort.

Breaking changes

• The monolithic AWSPowerShell module's minimum supported PowerShell version will be updated to 5.1. This is to match the AWS SDK for .NET new minimum of .NET Framework 4.7.2.
• The types adopted from the AWS SDK for .NET will use the SDK's new nullable changes. For example, properties of type int will change to Nullable[int]. Some cmdlet output will change to return $null instead of empty collections.
• The AWSHistory variable used for accessing the whole AWS API response will be removed in favor of using the -Select * feature, which has been added to AWS SDK for .NET 4.
• The AWS_PROFILE environment variable will be used when resolving credentials for a cmdlet.

Installing AWSPowerShell Preview Modules

Install-Module AWSPowerShell -AllowPrerelease -Repository PSGallery -Force

Installing AWS Tools Preview Modules

Install-Module -Name AWS.Tools.Common -AllowPrerelease -Repository PSGallery -Force


Install-Module -Name AWS.Tools.S3 -AllowPrerelease -Repository PSGallery -Force

Import AWS Tools for PowerShell Modules

Please note that you are required to import AWS.Tools.Common by invoking Import-Module -Name AWS.Tools.Common before importing any other AWS.Tools service modules. Normally, AWS.Tools.Common is automatically imported when importing a service module but there is a PowerShellGet bug preventing preview modules from specifying other preview modules as RequiredModules.

Import-Module -Name AWS.Tools.Common

Import-Module -Name AWS.Tools.S3

PS> Get-Module

ModuleType Version    PreRelease Name
---------- -------    ---------- ----
Binary     5.0.0      preview001 AWS.Tools.Common
Binary     5.0.0      preview001 AWS.Tools.S3

5.0.0-preview001

• The AWSPowerShell module’s minimum supported PowerShell version has been updated to 5.1. This is to match the AWS SDK for .NET new minimum of .NET Framework 4.7.2.
• The types adopted from the AWS SDK for .NET will use the SDK’s new nullable changes. For example, properties of type int will change to Nullable[int]. Some cmdlet output will change to return $null instead of empty collections.
• The AWSHistory variable, which is used to access the whole AWS API response, is removed in favor of using the -Select * feature.
• Removed obsolete -PassThru parameter from cmdlets.
• Get-DDBStream, Get-DDBStreamList cmdlets have been moved from DynamoDBV2 module to a new module DynamoDBStreams and renamed to Get-DDBSStream, Get-DDBSStreamList.
• Created Get-S3BucketACL, Set-S3BucketACL, Get-S3ObjectACL, Set-S3ObjectACL cmdlets and deprecated Get-S3ACL and Set-S3ACL
• Preview builds of AWS Tools for PowerShell are intended for developer testing/feedback and should not be installed in production environments.
• Please note that you are required to import AWS.Tools.Common before importing any other AWS.Tools service modules.
• Please use PowerShellGet commands (Install-Module, Update-Module, and Uninstall-Module) to install, update, and remove preview build modules.
• AWS.Tools.Installer may fail to install or update modules while preview build modules are installed. A backlog item has been created to address this bug.

[afroz429]

FYI - we released 5.0.0-preview001 today. Please see the issue description for release notes.