top of page

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 community

WEB: Pure Storage OFFICIAL blog

The blog lives from your questions, wishes and suggestions...every comment is welcome. I am very grateful for feedback.

428 views0 comments
bottom of page