Pure Storage PowerShell Toolkit - latest release 2.0.0.0
[ 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 (2.0.0.0 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 (V2.0.0.0).
Compatibility / Release Notes
Version 2.0.0.0 requires PowerShell 3.0 or later.
Version 2.0.0.0 requires .NET 4.5.
Version 2.0.0.0 is compatible with PowerShell SDK 1.7.4.0 and later, however:
Version 2.0.0.0 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
Toolkit operations
The newly integrated cmdlets are:
Get-AllHostVolumeInfo
Get-FlashArrayConfig
Get-FlashArrayDisconnectedVolumes
Get-FlashArrayHierarchy
Get-FlashArraySpace
Get-FlashArrayStaleSnapshots
Get-MPIODiskLBPolicy
New-HypervClusterVolumeReport
Remove-FlashArrayPendingDeletes
Set-MPIODiskLBPolicy
Set-TlsVersion
Set-WindowsPowerScheme
Show-FlashArrayPgroupsConfig
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:
Get-Help <cmdlet_name>
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".
Contributors
[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
See also: "PURE STORAGE POWERSHELL TOOLKIT V2.0 RELEASED!" at @8arkz by Rob Barker
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
WEB: Pure Storage OFFICIAL blog