release_notes.txt
|
Pure Storage PowerShell SDK 1.6 Release Notes
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, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7. 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. KNOWN ISSUES Get-PfaProtectionGroupVolumeSnapshots does not work if the array is connected using REST API 1.4. Get-PfaVolumeSpaceMetrics does not return the "size" property of a volume if the array is connected using REST API 1.0 or 1.1. ADDITIONS The last release for the Pure Storage PowerShell SDK was 1.5 The following cmdlets have been added since the last release to support REST 1.5 - Added Update-PfaArrayConnectionsThrottlingInformation. - Added Get-PfaArrayConnectionsThrottlingInformation. - Added Get-PfaAllHostIOMetrics. - Added Get-PfaHostIOMetrics. - Added Get-PfaAllHostGroupIOMetrics. - Added Get-PfaHostGroupIOMetrics. The following cmdlets have been added since the last release to support REST 1.6 - Added Get-PfaArraySpaceMetricsByTimeRange. - Added Get-PfaAllVolumeSpaceMetricsByTimeRange. - Added Get-PfaVolumeSpaceMetricsByTimeRange. The following cmdlets have been added since the last release to support REST 1.7 - Added Get-PfaArrayIOMetricsAverage. - Added Get-PfaAllHostIOMetricsTotal. - Added Get-PfaAllHostIOMetricsAverage. - Added Get-PfaHostIOMetricsAverage. - Added Get-PfaAllHostGroupIOMetricsTotal. - Added Get-PfaAllHostGroupIOMetricsAverage. - Added Get-PfaHostGroupIOMetricsAverage. - Added Get-PfaAllVolumeIOMetricsAverage. - Added Get-PfaAllVolumeIOMetricsTotal. - Added Get-PfaVolumeIOMetricsAverage. Other additions: - Added New-PfaCLICommand to be able to run any CLI command on the FlashArray - Added Get-PfaVolumeIOMetricsByTimeRange (old name was Get-PfaVolumeIOMetrics - see section CHANGES) - Added Get-PfaProtectionGroupSchedules. - Added Get-PfaSourceProtectionGroupSchedules. The following cmdlets related to Purity's integration with Active Directory to provide authentication. - Added Set-PfaDirectoryServiceStatus to enable/disable Active Directory integration. - Added Set-PfaDirectoryServiceAuthenticationStatus to enable/disable server authenticity enforcement using configured CA certificate. - Added Set-PfaDirectoryServiceGroupBase to set base OU for ArrayAdmin/StorageAdmin/Readonly security groups. CHANGES 1) Removed CheckPeer and Enabled switch parameters from Set-PfaDirectoryServiceConfiguration - the functionality is provided by new cmdlets Set-PfaDirectoryServviceAuthenticationStatus and Set-PfaDirectoryServiceStatus. 2) In 1.5 version of the SDK, Get-PfaVolumeIOMetrics would get historical performance data for the specified volume. This has been renamed to Get-PfaVolumeIOMetricsByTimeRange. A new cmdlet with the same name (Get-PfaVolumeIOMetrics) is added to list IO metrics attributes for the specified volume. 3) In 1.5 version of the SDK, Get-PfaAllVolumeIOMetrics would get IO metrics for a specific volume - this has been renamed to Get-PfaVolumeIOmetrics (see change#2 above) 4) Fixed bug with Get-PfaInitiatorPorts where it was only returning array ports. 5) Added the ability to connect to an array using API token (see help for New-PfaArray) 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. |