< Back

Get-ResiliencySetting

Wed Jan 30, 2019 6:02 pm

NAME Get-ResiliencySetting



SYNOPSIS

Gets the resiliency settings (also known as storage layouts) available for creating virtual disks on the specified storage subsystem.





SYNTAX

Get-ResiliencySetting [-CimSession <CimSession[]>] [-Name <String[]>] [-StoragePool <CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-ResiliencySetting [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-UniqueId <String[]>] [<CommonParameters>]





DESCRIPTION

The Get-ResiliencySetting cmdlet gets the resiliency settings (storage layouts) available for creating virtual disks on the specified storage subsystem.

The resiliency settings vary depending on the storage subsystem; the Windows Storage subsystem supports the Simple, Mirror, and Parity resiliency

settings.





PARAMETERS

-CimSession [<CimSession[]>]

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or

Get-CimSession cmdlet. The default is the current session on the local computer.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Name [<String[]>]

Specifies the name of the resiliency setting or settings to get. The supported resiliency setting names vary by storage subsystem; the Windows

Storage subsystem supports the following values: Simple, Mirror, or Parity.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-StoragePool [<CimInstance>]

Specifies the storage pool object for which to get resiliency settings. Enter a StoragePool CIM object. The Storage Pool CIM object is exposed by

the Get-StoragePool cmdlet.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-ThrottleLimit [<Int32>]

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is

entered, then Windows PowerShell???? calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the

computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-UniqueId [<String[]>]

Specifies the UniqueID of the resiliency setting object to get. If the UniqueID includes brackets, enclose the string in quotation marks.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool

http://msdn.microsoft.com/library/windo ... 30551.aspx





You can pipe an MSFT_StoragePool object to the StoragePool parameter to get the resiliency setting associated with the StoragePool object.





OUTPUTS

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_ResiliencySetting

http://msdn.microsoft.com/library/windo ... 30538.aspx





The Get-ResiliencySetting cmdlet returns objects representing resiliency settings for a particular storage pool.





Example 1: Get all resiliency setting objects



PS C:\\> Get-ResiliencySetting

Name NumberOfDataCopies PhysicalDiskRedundancy NumberOfColumns Interleave

---- ------------------ ---------------------- --------------- ----------

Simple 1 0 8 65536

Mirror 2 1 4 65536

Parity 1 1 8 65536



This example gets all resiliency setting objects for each storage pool, showing which resiliency settings are available for use when creating virtual

disks. If there are multiple storage pools, the same resiliency setting might appear more than once, with each object representing the resiliency

setting support for a particular storage pool.





Example 2: Get only Mirror, Parity, and Simple resiliency setting objects



PS C:\\> Get-ResiliencySetting -Name Mirror,Parity,Simple



This example displays only the resiliency settings for the types Mirror, Parity and Simple. Other defined resiliency settings are not displayed.





Example 3: Get a resiliency setting object by UniqueID



PS C:\\>Get-ResiliencySetting -UniqueId "{5d792e9b-ca00-11e1-9350-00155db7aa01}:1"



This example displays one particular resiliency setting object by specifying its UniqueID value, enclosed in quotation marks.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=816396

Get-StoragePool

New-VirtualDisk

Set-ResiliencySetting

Set-StoragePool