[ NOTE: machine translation with the help of DeepL translator without additional proofreading and spell checking ]
The Pure Storage PowerShell Toolkit is an open source project (@GitHub PureStorage-OpenConnect / GitHub contributions from Pure Storage customers, architects, system engineers and developers), which provides cmdlets for Pure Storage FlashArray and Windows Server. The PowerShell Toolkit provides useful cmdlets for customers and Pure Storage Field Support that can be used in troubleshooting, monitoring, reporting, best practices and configuration. The PowerShell Toolkit leverages the Pure Storage PowerShell SDK. The latest version (188.8.131.52 from July 2021) of the Pure Storage PowerShell Toolkit adds more new cmdlets for FlashArrays and Windows Server, and improves tried-and-true functionality. A complete list of changes can be found in the Pure Storage PowerShell Toolkit GitHub repository in the CHANGELOG.md file.
Personally, I am especially happy about the new version of the toolkit. Mike Nelson and Rob Barker integrated parts of my PowerShell scripts into the new toolkit (V184.108.40.206).
Compatibility / Release Notes
Version 220.127.116.11 requires PowerShell 3.0 or later.
Version 18.104.22.168 requires .NET 4.5.
Version 22.214.171.124 is compatible with PowerShell SDK 126.96.36.199 and later, however:
Version 188.8.131.52 is not yet compatible with PowerShell SDK version 2.
a 64-bit operating system is required.
Installation of Toolkit
The Pure Storage PowerShell Toolkit is distributed via the PowerShell Gallery. The toolkit requires the Pure Storage PowerShell SDK (see above). If the PowerShell SDK is not already installed on the administrative system, an attempt will be made to download and install it (requires an internet connection). If you do not have a direct internet connection available, then the necessary MSI package for installing the Pure Storage PowerShell SDK v1 can be downloaded here. For further assistance, please refer to: "How-To: Install the FlashArray PowerShell SDK using the Microsoft Installer Package - MSI" on the Pure Storage Technical Services Portal.
HINT: Make sure that the correct TLS version is set for PSGallery
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
To install the Pure Storage PowerShell Toolkit, start a Windows PowerShell session with administrative privileges and enter:
Install-Module -Name PureStoragePowerShellToolkit
Verify successful installation:
Get-Module -Name PureStoragePowerShellToolkit
The newly integrated cmdlets are:
All available Toolkit cmdlets from version 2.0.0 can be retrieved with the command:
Get-Command -Module PureStoragePowerShellToolkit
Help for the individual cmdlets can be obtained with:
An example of help would be:
PS C:\Users\Administrator> Get-Help Get-Pfa2Array NAME Get-Pfa2Array SYNOPSIS List arrays SYNTAX Get-Pfa2Array [-ApiVersion <String>] [-Array <Rest2Api>] [-Filter <String>] [-Limit <Int32>] [-Offset <Int32>] [-Sort <List<String>>] [<CommonParameters>] DESCRIPTION Displays a list of arrays. RELATED LINKS REMARKS To see the examples, type: "get-help Get-Pfa2Array -examples". For more information, type: "get-help Get-Pfa2Array -detailed". For technical information, type: "get-help Get-Pfa2Array -full".
[Excerpt from the official PowerShellToolkit script module (.psm1)]
Contributors and many thanks go out to:
Rob "Barkz" Barker @purestorage
Robert "Q" Quimbey @purestorage
Mike "Chief" Nelson @purestorage
Julian "Doctor" Cates @purestorage
Marcel Dussil @purestorage - https://en.pureflash.blog/
Craig Dayton - https://github.com/cadayton
Jake Daniels - https://github.com/JakeDennis
Richard Raymond - https://github.com/data-sciences-corporation/PureStorage
More info - Links
All officially published setting options in the GUI but also CLI can be read via the "on-board" user guides of the Pure Storage systems.
Click on "Help" in the Purity main menu.
The User Guide is structured like the main menu and can be opened downwards. A search function is also integrated - within here you can also search for keywords.
WEB: Pure Storage (Pure1) support portal - Ticket system and support *(requires registered FlashSystems)
PHONE: Pure Storage phone support: GER - (+49) (0)800 7239467; INTERNATIONAL - (+1) 650 7294088