PowerShell Logo Small

Get-StoragePool



This is the built-in help made by Microsoft for the command 'Get-StoragePool', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets a specific storage pool, or a set of StoragePool objects either from all storage subsystems across all storage providers, or optionally a filtered subset based on specific parameters.

SYNTAX


Get-StoragePool [[-FriendlyName] <String[]>] [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-ThrottleLimit <Int32>]
[-Usage <Usage[]>] [<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-Name <String[]>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-StorageNode <CimInstance>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-ThrottleLimit <Int32>] [-VirtualDisk <CimInstance>]
[<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-StorageJob <CimInstance>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-StorageTier <CimInstance>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-ResiliencySetting <CimInstance>] [-ThrottleLimit
<Int32>] [<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-StorageSubSystem <CimInstance>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-PhysicalDisk <CimInstance>] [-ThrottleLimit <Int32>]
[<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-OtherUsageDescription <String[]>] [-ThrottleLimit
<Int32>] [-Usage <Usage[]>] [<CommonParameters>]
Get-StoragePool [-AsJob] [-CimSession <CimSession[]>] [-HealthStatus <HealthStatus[]>] [-IsPrimordial <Boolean[]>] [-ThrottleLimit <Int32>] [-UniqueId <String[]>]
[<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-StoragePool cmdlet returns either a specific storage pool, or a set of StoragePool objects either from all storage subsystems across all storage providers, or
optionally a filtered subset based on specific parameters.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=298360
New-StoragePool
Remove-StoragePool
Set-StoragePool
Get-StorageJob
Get-StorageNode
Get-StorageTier

REMARKS

<

Examples


Example 1: Get all storage pools

PS C:\>Get-StoragePool
FriendlyName OperationalStatus HealthStatus IsPrimordial IsReadOnly
------------ ----------------- ------------ ------------ ----------
CompanyData OK Healthy False False
Primordial OK Healthy True False



This example lists all storage pools, (when run without parameter) from all Storage Management Providers, from all storage subsystems. This list may optionally be filtered
using one or more parameters.




Example 2: Get all storage pools (not including primordial pools)

PS C:\>Get-StoragePool -IsPrimordial $False
FriendlyName OperationalStatus HealthStatus IsPrimordial IsReadOnly
------------ ----------------- ------------ ------------ ----------
CompanyData OK Healthy False False



This example lists all (concrete) storage pools, excluding primordial pools (which store physical disks that have yet to be added to a concrete storage pool).




Example 3: Get all storage pools that support the Mirror resiliency setting

PS C:\>Get-ResiliencySetting -Name Mirror | Get-StoragePool
FriendlyName OperationalStatus HealthStatus IsPrimordial IsReadOnly
------------ ----------------- ------------ ------------ ----------
CompanyData OK Healthy False False
Primordial OK Healthy True False



This example uses the Get-ResiliencySetting cmdlet to retrieve ResiliencySetting objects that represent each storage pool that supports the specified resiliency setting
(also known as storage layout), in this case Mirror, and then pipes the array of objects to the Get-StoragePool cmdlet.