New-FlashArrayCapacityReport cmdlet in Pure Storage PowerShell Toolkit 3.3.224.0

[Updated: 2/23/2017, 2/22/2017]

New-FlashArrayCapacityReport is a new cmdlet introduced in the Pure Storage PowerShell Toolkit 3.3.224.0. This reports provides a view of the FlashArray that includes the following:

  • Information about the FlashArray such as Name, Purity Version, ID, System Capacity and more.
  • Details about volumes such as Name, Size, Data Reduction, Thin Provisioning and Shared Space.
  • Volumes section has a Protected column to indicate if a volume is protected by a snapshot.
  • Details about individual FlashRecover Snapshots.

FlashArray Capacity Report example:

An additional cmdlet added is Update-DriveInformation which allows the updating of drive letters and drive labels easily.

Example to update existing mounted drive letter from T to S and set new drive label:

Example updating existing drive letter with new drive label:

 

Install the updated PowerShell Toolkit from the PowerShell Gallery as follows:

If there you have any feedback or feature additions for the New-FlashArrayCapacityReport cmdlet please add them here.

Thanks,
Barkz

  • Justin Wilamowski

    Love the idea of the Capacity report.. attempting to give it a try this morning but running into a few issues..

    1. Simple typo, the PS Command line listed above shows it as New-FlashArrayReport instead of New-FlashArrayCapacityReport.

    2. Running the report seems to generate repeated errors that seem to be related to the percentage complete (this might be a non-issue but after roughly 5 minutes of the same looping error i killed it):

    Write-Progress : Cannot validate argument on parameter ‘PercentComplete’. The 467 argument is greater than the ma
    allowed range of 100. Supply an argument that is less than or equal to 100 and then try the command again.
    At C:Program
    FilesWindowsPowerShellModulesPureStoragePowerShellToolkit3.2.0.0PureStoragePowerShellToolkit.psm1:190 char:9
    + … ng Pure Storage FlashArray report…” -PercentComplete $volumes.Count
    + ~~~~~~~~~~~~~~
    + CategoryInfo : InvalidData: (:) [Write-Progress], ParameterBindingValidationException
    + FullyQualifiedErrorId : ParameterArgumentValidationError,Microsoft.PowerShell.Commands.WriteProgressCommand

    • Hi Justin –

      First off thanks for the feedback. Nice to know there are people using the toolkit. I removed the Write-Progress updates as it really isn’t necessary, but if you have feedback on that feature let me know. I just updated the module on the PowerShell Gallery to 3.3.224.0 and also pushed the updated source code to GitHub. Check http://code.purestorage.com for the repo. I also update the blog post to reflect the correct cmdlet name, figured I’d at least get that one right 😉

      If you have requests for a feature log it on the Issues section of the GitHub repo (https://github.com/PureStorage-OpenConnect/powershell-toolkit/issues).

      Thanks,
      Barkz

    • Barkz

      Hi Justin –

      First off thanks for the feedback. Nice to know there are people using the toolkit. I removed the Write-Progress updates as it really isn’t necessary, but if you have feedback on that feature let me know. I just updated the module on the PowerShell Gallery to 3.3.224.0 and also pushed the updated source code to GitHub. Check http://code.purestorage.com for the repo. I also update the blog post to reflect the correct cmdlet name, figured I’d at least get that one right 😉

      If you have requests for a feature log it on the Issues section of the GitHub repo (https://github.com/PureStorage-OpenConnect/powershell-toolkit/issues).

      Thanks,
      Barkz

  • Garrick Dunkley

    The report shows overall data reduction but is it possible to get it to show the actual data reduction figure? (The one without thin provisioning)

    • Hi Garrick –

      The Volumes section contains the per volume actual data reduction value. Is this what you are looking for?

      Thanks,
      Barkz

    • Barkz

      Hi Garrick –

      The Volumes section contains the per volume actual data reduction value. Is this what you are looking for?

      Thanks,
      Barkz

      • TF

        Hi Barkz

        I’ve been playing with this cmdlet today and as per Garrick’s question above I too would like to see the actual “used” figure for each LUN.
        (To be clear…. the used figure I would like to see is found in the Pure Admin console under Storage/Volumes/ then to the right of the blue bar is a Used capacity figure which includes volumes and snapshots.)

        Is this possible?

        In my case this is required because I’d like to provide the “used capacity / volume” to our ESX Administrators who cannot see how much space a LUN is actually consuming within the VSphere console where the Vsphere plugin is not installed.

        Regards

        • Barkz

          Hi TF –

          This is possible and I’ll get the cmdlet updated with a “Used” detail. Stay tuned. I’m just getting back into the office from an extended leave so should get to this next week.

          Thanks for the feedback,
          Barkz

          • TF

            Hi Barkz

            Thanks for getting back to me.
            I have managed to add the “used” detail myself and in the process have learned a lot about powershell!
            I’ve also added a column to the LUN report to indicate whether a LUN is replicated off-site or not. At this point I just check to see if the LUN is in a Protection Group or not – there’s probably a better way of doing this….
            I have more scripting to do, so expect a few more questions in the coming weeks 🙂

            Cheers
            TF

  • Mamo

    Hi Barkz,

    I am unable to use the stored credentials for the below

    New-FlashArrayCapacityReport -EndPoint $FA -Credential $Creds

    As I am getting the below error

    PowerCLI D:Powercli> .Pure_Storage_Report.ps1
    New-FlashArrayCapacityReport : A parameter cannot be found that matches parameter name ‘Credential’.
    At D:MineKBPureCLIScriptsPowercliPure_Storage_Report.ps1:7 char:44
    + New-FlashArrayCapacityReport -EndPoint $FA -Credential $Creds -OutFil …
    + ~~~~~~~~~~~
    + CategoryInfo : InvalidArgument: (:) [New-FlashArrayCapacityReport], ParameterBindingException
    + FullyQualifiedErrorId : NamedParameterNotFound,New-FlashArrayCapacityReport

    Installed version of toolkit : 3.3.225.2 and SDK is 1.7.4.0

    Please help

    -Madhu

  • Mamo

    Provisioned Space (TB) shows zero in Capacity Report.

    I have installed the latest version of PureStoragePowerShellToolkit 3.4.512.0

    Still I am seeing the same error.

    -Madhu

    • Barkz

      Hi Madhu –

      Please contact me directly at barkz@purestorage.com. I can look at your FlashArray internally to get some details on what you are seeing, version of Purity, etc.

      Thanks,
      Barkz