The Pure Storage PowerShell Toolkit 3.0 is a new beginning for the Toolkit. The original version was released in 2016 and was based on older versions of the Pure Storage PowerShell SDK 1.x release. The Toolkit provides useful cmdlets for customers and the Pure Storage Field Support to use in troubleshooting, monitoring, reporting, best practices, and configuration. The PowerShell Toolkit leverages the Pure Storage PowerShell SDK 2 for some of the cmdlets. All references to the PowerShell SDK 1.x have been removed.
The new release includes:
- Separate modules for specific functionality: Database Tools, Windows Administration, FlashArray and Exchange
- Update from SDK 1.x --> 2.x
- Improved error handling
- Updated Get-Help
- This release requires PowerShell 5.1 or higher.
- This release requires .NET 4.5 minimum.
- This release is compatible with the PowerShell SDK 2.16.12.0 and later. You can install the latest using
Install-Module PureStoragePowerShellSDK2 -force
- Database Tools module is compatible with dbatools 1.0.173 and later.
- This release requires a 64-bit operating system.
The very latest versions of the Toolkit are always available in this repository and in the PowerShell Gallery. There may be multiple branches that may contain alpha or beta code. The default "main" branch contains "stable" code. The Pure Storage PowerShell Toolkit is also distrbuted through the PowerShell Gallery.
The tookit requires the PureStoragePowerShellSDK2 module by default for any functions that connect to a FlashArray. Other modules are also used for further functionaility with SQL Server, Excel output, etc. A built-in global function will attempt to download and install them if they are not present when the cmdlet is launched.
- Pure Storage PowerShell SDK 2 (Required)
- dbatools (Required to use Database Tools module. Module will be automatically installed.)
To install the Pure Storage PowerShell Toolkit, open up an elevated Windows PowerShell session and type:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Install-Module -Name PureStoragePowerShellToolkit
To verify the installation:
Get-Module -Name PureStoragePowerShellToolkit
To load the module:
Import-Module -Name PureStoragePowerShellToolkit
To see the available cmdlets, you must either use a wildcard query or specify the module (flasharray, core, databasetools, exchange, windowsadministration:
Get-Command -Module PureStoragePowerShellToolkit*
or
Get-Command -Module PureStoragePowerShellToolkit.flasharray
To uninstall the module:
Uninstall-Module -Module PureStoragePowerShellToolkit
PowerShell Toolkit 2.0 issues will be triaged and moved to the Toolkit 3.0 issues as appropriate.
We welcome Pull Requests, issues, and open discussions around the toolkit. Help make the toolkit an invaluable tool!