< Back

Get-VirtualDiskSupportedSize

Wed Jan 30, 2019 6:02 pm

NAME Get-VirtualDiskSupportedSize



SYNOPSIS

Returns all sizes supported by a storage pool for virtual disk creation based on the specified resiliency setting name.





SYNTAX

Get-VirtualDiskSupportedSize [-StoragePoolFriendlyName] <String[]> [-CimSession <CimSession[]>] [-FaultDomainAwareness {PhysicalDisk | StorageEnclosure

| StorageScaleUnit | StorageChassis | StorageRack}] [-ResiliencySettingName <String>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-VirtualDiskSupportedSize [-CimSession <CimSession[]>] [-FaultDomainAwareness {PhysicalDisk | StorageEnclosure | StorageScaleUnit | StorageChassis |

StorageRack}] [-ResiliencySettingName <String>] [-ThrottleLimit <Int32>] [<CommonParameters>]



Get-VirtualDiskSupportedSize [-CimSession <CimSession[]>] [-FaultDomainAwareness {PhysicalDisk | StorageEnclosure | StorageScaleUnit | StorageChassis |

StorageRack}] [-ResiliencySettingName <String>] [-ThrottleLimit <Int32>] -StoragePoolUniqueId <String[]> [<CommonParameters>]



Get-VirtualDiskSupportedSize [-CimSession <CimSession[]>] [-FaultDomainAwareness {PhysicalDisk | StorageEnclosure | StorageScaleUnit | StorageChassis |

StorageRack}] [-ResiliencySettingName <String>] [-ThrottleLimit <Int32>] -StoragePoolName <String[]> [<CommonParameters>]





DESCRIPTION

The Get-VirtualDiskSupportedSize cmdlet returns all sizes supported by a storage pool for virtual disk creation based on the specified resiliency

setting name.





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



-FaultDomainAwareness [<FaultDomainType>]

Specifies the desired level of fault tolerance. The acceptable values for this parameter are:



-- PhysicalDisk

-- StorageScaleUnit

-- StorageChassis

-- StorageEnclosure

-- StorageRack



For example, specify StorageScaleUnit if data copies should be stored on separate nodes of a Storage Spaces Direct cluster. This cmdlet refers to

nodes of a Storage Spaces Direct cluster as storage scale units because you can expand the scale of the cluster by adding more nodes.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-ResiliencySettingName [<String>]

Specifies the name of the desired resiliency setting, for example Simple, Mirror, or Parity.



Required? false

Position? named

Default value none

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-StoragePoolFriendlyName <String[]>

Specifies an array of friendly names of storage pools. The cmdlet returns all sizes supported by the storage pools that you specify.



Required? true

Position? 1

Default value none

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-StoragePoolName <String[]>

Specifies an array of names of storage pools. The cmdlet returns all sizes supported by the storage pools that you specify.



Required? true

Position? named

Default value none

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-StoragePoolUniqueId <String[]>

Specifies an array of unique IDs of storage pools, as strings. The cmdlet returns all sizes supported by the storage pools that you specify.



Required? true

Position? named

Default value none

Accept pipeline input? True (ByPropertyName)

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



<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 use the pipeline operator to pass an MSFT_StoragePool object to the InputObject parameter.





OUTPUTS

System.Management.Automation.PSCustomObject



This cmdlet returns an object that lists the minimum and maximum size for creating a virtual disk in the specified pool with the specified

resiliency setting.





EXAMPLE 1



PS C:\\>Get-VirtualDiskSupportedSize -ResiliencySettingsName Mirror



This example lists the minimum and maximum supported sizes for virtual disk creation using the specified resiliency settings name.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=816422

Get-ResiliencySetting

New-VirtualDisk

Get-StorageTierSupportedSize

Set-ResiliencySetting