Skip to content

Pure Storage PowerShell SDK 1.16.6.0

Compare
Choose a tag to compare
@barkz barkz released this 05 Aug 17:07
26459c2

Pure Storage PowerShell SDK 1.16.6.0

The Pure Storage PowerShell SDK provides integration with the Purity Operating Environment and FlashArray. It provides functionalities of Purity's REST API as PowerShell cmdlets.

RELEASE COMPATIBILITY

This release requires PowerShell 3.0 or higher.
This release requires .NET 4.5.
This release is compatible with Purity FlashArrays that support Pure Storage REST API 1.0 to 1.16 inclusive.
This release requires a 64-bit operating system.

INSTALLATION AND UNINSTALLATION

To install the PowerShell SDK, extract and run PurePowerShellSDKInstaller.msi, and follow the instructions. Administrator privilege is required to install. To verify the installation, run "Get-Command -Module PureStoragePowerShellSDK" in a new PowerShell prompt. The newly installed cmdlets should be listed. The PowerShell SDK can be uninstalled from "Programs and Features" of the Control Panel.

The PowerShell SDK can also be installed using the PowerShell Gallery. See https://www.powershellgallery.com/ for details on how to discover resources on the PowerShell Gallery.

KNOWN ISSUES

Get-PfaProtectionGroupVolumeSnapshots does not work if the array is connected using REST API 1.4.

RELEASE 1.16.0

Release 1.16.0 adds the following changes to Release 1.13.1.12
Added support for REST 1.14, 1.15 and 1.16. The following features are implemented.

Added support for NFS and S3 snapshot offload

  • Connect-PfaOffloadNFSTarget
  • Connect-PfaOffloadS3Target
  • Disconnect-PfaOffloadNFSTarget
  • Disconnect-PfaOffloadS3Target
  • Get-PfaAllProtectionGroupOffloadSnapshot
  • Get-PfaAllVolumeOffloadSnapshot
  • Get-PfaOffloadNFSTarget
  • Get-PfaOffloadS3Target
  • Get-PfaOffloadSnapshot
  • Get-PfaOffloadTarget
  • Get-PfaProtectionGroupOffloadSnapshot
  • Restore-PfaAllVolumeOffloadSnapshot

Added support for how directory service roles are modified

  • Get-PfaDirectoryServiceRole
  • New-PfaDirectoryServiceRole

Added support for maximum login attempts and user lockout

  • Get-PfaAdminSetting
  • Get-PfaAllLockedUser
  • Get-PfaLockedUser
  • Set-PfaAdminSetting
  • Unlock-PfaUser

Added support for host NQN's

  • Add-PfaHostNqn
  • Remove-PfaHostNqn
  • Set-PfaHostNqn

Added support for creating and deleting local user

  • New-PfaLocalUser
  • Remove-PfaLocalUser

Added support to view and manage software applications on Purity Array

  • New-PfaSoftware
  • Get-PfaSoftware
  • Disable-PfaSoftware
  • Enable-PfaSoftware
  • Remove-PfaSoftware
  • Get-PfaSoftwareAttribute

Added ability to view pods on remote array

  • Get-PfaAllRemotePod
  • Get-PfaRemotePod

Added the ability to list latency values when viewing performance data.

  • Get-PfaAllHostGroupIOLatencyMetrics
  • Get-PfaAllHostGroupIOLatencyMetricsMirrored
  • Get-PfaAllHostGroupIOLatencyMetricsTotal
  • Get-PfaAllHostIOLatencyMetrics
  • Get-PfaAllHostIOLatencyMetricsMirrored
  • Get-PfaAllHostIOLatencyMetricsTotal
  • Get-PfaAllPodIOLatencyMetricsMirrored
  • Get-PfaAllVolumeGroupIOLatencyMetrics
  • Get-PfaAllVolumeGroupIOLatencyMetricsByTimeRange
  • Get-PfaAllVolumeGroupsIOLatencyMetricsTotal
  • Get-PfaAllVolumeIOLatencyMetrics
  • Get-PfaAllVolumeIOLatencyMetricsByTimeRange
  • Get-PfaAllVolumeIOLatencyMetricsTotal
  • Get-PfaArrayIOLatencyMetrics
  • Get-PfaHostGroupIOLatencyMetrics
  • Get-PfaHostGroupIOLatencyMetricsMirrored
  • Get-PfaHostIOLatencyMetrics
  • Get-PfaHostIOLatencyMetricsMirrored
  • Get-PfaNamedVolumeGroupsIOLatencyMetricsByTimeRange
  • Get-PfaNamedVolumesIOLatencyMetricsByTimeRange
  • Get-PfaPodIOLatencyMetricsMirrored
  • Get-PfaVolumeGroupIOLatencyMetrics
  • Get-PfaVolumeGroupIOLatencyMetricsByTimeRange
  • Get-PfaVolumeIOLatencyMetrics
  • Get-PfaVolumeIOLatencyMetricsByTimeRange

Added the following new cmdlets:

  • Set-PfaHost
  • Set-PfaPod
  • Set-PfaVolumeBandwidthLimit
  • Set-PfaSmtpManagerAttribute
  • Get-PfaSmtpManagerAttribute

Updated the following cmdlets:

  • Get-PfaHost
  • Get-PfaHosts
  • Get-PfaPod
  • Get-PfaPods
  • Get-PfaVolume
  • Get-PfaVolumes
  • New-PfaHost
  • New-PfaPod
  • New-PfaVolume
  • Remove-PfaProtectionGroupOrSnapshot
  • Restore-PfaDestroyedProtectionGroup

The following cmdlets starting REST 1.16 do not return "san_usec_per_read_op", "san_usec_per_write_op". These values are part of new cmdlet mentioned above IOLatency.

  • Get-PfaAllHostIOMetrics
  • Get-PfaHostIOMetricsAverage
  • Get-PfaAllHostIOMetricsTotal
  • Get-PfaArrayIOMetrics
  • Get-PfaArrayIOMetricsAverage
  • Get-PfaAllVolumeIOMetricsByTimeRange
  • Get-PfaNamedVolumesIOMetricsByTimeRange
  • Get-PfaVolumeIOMetrics
  • Get-PfaVolumeIOMetricsByTimeRange
  • Get-PfaAllVolumeIOMetric

PERFORMANCE TESTING

No performance testing was done for this release.

OPEN SOURCE LICENSES

Json.NET:

The MIT License (MIT)
Copyright (c) 2007 James Newton-King
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

SSH.NET:

The MIT License (MIT)
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.