Set-StoragePool

Windows Server 2012 R2 and Windows 8.1

Set-StoragePool

Modifies the properties of the specified storage pool.

구문

Parameter Set: ByUniqueId
Set-StoragePool -UniqueId <String> [-AsJob] [-CimSession <CimSession[]> ] [-ClearOnDeallocate <Boolean> ] [-IsPowerProtected <Boolean> ] [-NewFriendlyName <String> ] [-OtherUsageDescription <String> ] [-RepairPolicy <RepairPolicy> ] [-RetireMissingPhysicalDisks <RetireMissingPhysicalDisks> ] [-ThinProvisioningAlertThresholds <UInt16[]> ] [-ThrottleLimit <Int32> ] [-Usage <Usage> ] [ <CommonParameters>]

Parameter Set: ByFriendlyName
Set-StoragePool [-FriendlyName] <String> [-AsJob] [-CimSession <CimSession[]> ] [-ClearOnDeallocate <Boolean> ] [-IsPowerProtected <Boolean> ] [-NewFriendlyName <String> ] [-OtherUsageDescription <String> ] [-RepairPolicy <RepairPolicy> ] [-RetireMissingPhysicalDisks <RetireMissingPhysicalDisks> ] [-ThinProvisioningAlertThresholds <UInt16[]> ] [-ThrottleLimit <Int32> ] [-Usage <Usage> ] [ <CommonParameters>]

Parameter Set: ByFriendlyNameAttributes
Set-StoragePool [-FriendlyName] <String> [-AsJob] [-CimSession <CimSession[]> ] [-IsReadOnly <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByFriendlyNameDefaults
Set-StoragePool [-FriendlyName] <String> [-AsJob] [-AutoWriteCacheSize <Boolean> ] [-CimSession <CimSession[]> ] [-EnclosureAwareDefault <Boolean> ] [-ProvisioningTypeDefault <ProvisioningType> ] [-ResiliencySettingNameDefault <String> ] [-ThrottleLimit <Int32> ] [-WriteCacheSizeDefault <UInt64> ] [ <CommonParameters>]

Parameter Set: ByName
Set-StoragePool -Name <String> [-AsJob] [-CimSession <CimSession[]> ] [-ClearOnDeallocate <Boolean> ] [-IsPowerProtected <Boolean> ] [-NewFriendlyName <String> ] [-OtherUsageDescription <String> ] [-RepairPolicy <RepairPolicy> ] [-RetireMissingPhysicalDisks <RetireMissingPhysicalDisks> ] [-ThinProvisioningAlertThresholds <UInt16[]> ] [-ThrottleLimit <Int32> ] [-Usage <Usage> ] [ <CommonParameters>]

Parameter Set: ByNameAttributes
Set-StoragePool -Name <String> [-AsJob] [-CimSession <CimSession[]> ] [-IsReadOnly <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByNameDefaults
Set-StoragePool -Name <String> [-AsJob] [-AutoWriteCacheSize <Boolean> ] [-CimSession <CimSession[]> ] [-EnclosureAwareDefault <Boolean> ] [-ProvisioningTypeDefault <ProvisioningType> ] [-ResiliencySettingNameDefault <String> ] [-ThrottleLimit <Int32> ] [-WriteCacheSizeDefault <UInt64> ] [ <CommonParameters>]

Parameter Set: ByObject
Set-StoragePool [-InputObject] <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-ClearOnDeallocate <Boolean> ] [-IsPowerProtected <Boolean> ] [-NewFriendlyName <String> ] [-OtherUsageDescription <String> ] [-RepairPolicy <RepairPolicy> ] [-RetireMissingPhysicalDisks <RetireMissingPhysicalDisks> ] [-ThinProvisioningAlertThresholds <UInt16[]> ] [-ThrottleLimit <Int32> ] [-Usage <Usage> ] [ <CommonParameters>]

Parameter Set: ByObjectAttributes
Set-StoragePool [-InputObject] <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-IsReadOnly <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByObjectDefaults
Set-StoragePool [-InputObject] <CimInstance[]> [-AsJob] [-AutoWriteCacheSize <Boolean> ] [-CimSession <CimSession[]> ] [-EnclosureAwareDefault <Boolean> ] [-ProvisioningTypeDefault <ProvisioningType> ] [-ResiliencySettingNameDefault <String> ] [-ThrottleLimit <Int32> ] [-WriteCacheSizeDefault <UInt64> ] [ <CommonParameters>]

Parameter Set: ByUniqueIdAttributes
Set-StoragePool -UniqueId <String> [-AsJob] [-CimSession <CimSession[]> ] [-IsReadOnly <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByUniqueIdDefaults
Set-StoragePool -UniqueId <String> [-AsJob] [-AutoWriteCacheSize <Boolean> ] [-CimSession <CimSession[]> ] [-EnclosureAwareDefault <Boolean> ] [-ProvisioningTypeDefault <ProvisioningType> ] [-ResiliencySettingNameDefault <String> ] [-ThrottleLimit <Int32> ] [-WriteCacheSizeDefault <UInt64> ] [ <CommonParameters>]




자세한 설명

The Set-StoragePool cmdlet modifies the properties of the specified storage pool.

매개 변수

-AsJob

별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-AutoWriteCacheSize<Boolean>

Indicates whether to set the size of the write-back cache to 1 GB for all types of storage spaces, which include simple, mirror, and parity, to create from the pool. If the number or size of the solid-state drives (SSDs) or journal disks in the storage pool is not sufficient and you specify a value of $True for this parameter, the cmdlet sets the write-back cache size to 0 for simple and mirror spaces, and to 32 MB for parity spaces.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-CimSession<CimSession[]>

원격 세션에서 또는 원격 컴퓨터에서 cmdlet을 실행합니다. New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 컴퓨터 이름이나 세션 개체를 입력합니다. 기본값은 로컬 컴퓨터의 현재 세션입니다.


별칭

Session

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ClearOnDeallocate<Boolean>

Clears all blocks on the physical disks in the storage pool upon deallocation. Clearing all blocks is more secure, but is much slower to deallocate.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-EnclosureAwareDefault<Boolean>

Specifies that the storage pool should use enclosure awareness by default when creating storage spaces.

To support deployments that require an added level of fault tolerance, Storage Spaces can associate each copy of data with a particular just-a-bunch-of-disk (JBOD) enclosure. This capability is known as enclosure awareness. With enclosure awareness, if one enclosure fails or goes offline, the data remains available in one or more alternate enclosures.

To use enclosure awareness, you must use JBODs that are certified for use with Storage Spaces and you must have a sufficient number of JBODs and disks to support the resiliency types of the storage spaces you create (generally you’ll need three or four JBODs). For a list of certified JBODs, see the Windows Server Catalog. For more information about enclosure awareness, see Storage Spaces Frequently Asked Questions.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-FriendlyName<String>

Specifies the friendly name of the storage pool on which you want to set attributes.


별칭

없음

필수 여부

true

위치

1

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-InputObject<CimInstance[]>

Accepts an array of storage pool objects from the pipeline as input.


별칭

없음

필수 여부

true

위치

1

기본값

없음

파이프라인 입력 적용 여부

True (ByValue)

와일드카드 문자 허용 여부

false

-IsPowerProtected<Boolean>

Indicates whether the physical disks that belong to the storage pool have backup power systems, such as battery backup. If you specify a value of $True for this parameter, the storage pool does not perform flush operations, and the pool removes write-through attributes from commands.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-IsReadOnly<Boolean>

Sets the object to be read-only (IsReadOnly $true) or read-write (IsReadOnly $false). Note: If the object is set to read-only (IsReadOnly $true), the object must be set to read-write (IsReadOnly $false) before using this cmdlet to set the PartitionStyle parameter.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-Name<String>

Specifies the name of the storage pool on which you want to set attributes.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-NewFriendlyName<String>

Specifies the new friendly name for the storage pool.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-OtherUsageDescription<String>

Specifies the OtherUsageDescription for the storage pool.


별칭

NewOtherUsageDescription

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ProvisioningTypeDefault<ProvisioningType>

Specifies the default type of provisioning to use for virtual disks created in the specified storage pool. The acceptable values for this parameter are: Fixed or Thin.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-RepairPolicy<RepairPolicy>

Specifies how the operating system proceeds with repairing virtual disks in the specified storage pool. 이 매개 변수에 허용되는 값은 다음과 같습니다.
--Sequential Repair processes one allocation slab at a time. Specifying this value results in longer repair times, but smaller impact on I/O load.
--Parallel Repair processes as many allocation slabs as it can in parallel.  Specifying this value results in the shortest repair time, but significantly impacts I/O load.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ResiliencySettingNameDefault<String>

Specifies the default resiliency setting (also known as storage layout) to use for virtual disks the created in the specified storage pool. The supported resiliency settings vary by storage subsystem. Acceptable values for the Storage Spaces subsystem are Mirror, Parity, and Simple.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-RetireMissingPhysicalDisks<RetireMissingPhysicalDisks>

Specifies when Windows should set the Usage property of physical disks missing from a storage pool to Retired. 이 매개 변수에 허용되는 값은 다음과 같습니다.
Auto This is the default setting for storage pools. When set to Auto, Windows retires missing disks, but doesn’t automatically rebuild affected virtual disks unless there are physical disks whose Usage value is set to HotSpare, in which case Windows rebuilds the virtual disks five minutes after the failed write operation.
Always This is the recommended setting when using free pool space to rebuild storage spaces instead of using hot-spare disks. When set to Always, Windows retires missing physical disks and automatically rebuilds affected virtual disks five minutes after the failed write operation.
Never When set to Never, Windows never retires missing physical disks.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ThinProvisioningAlertThresholds<UInt16[]>

Specifies how full a storage pool must get (in percent) before an alert is generated to add physical disks to the storage pool to support thinly provisioned virtual disks.


별칭

없음

필수 여부

false

위치

named

기본값

70

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ThrottleLimit<Int32>

이 cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수가 생략되거나 값 0이 입력되면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 제한 한도를 계산합니다. 제한 한도는 현재 cmdlet에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-UniqueId<String>

Specifies the UniqueID of the storage pool for which you want to set attributes.


별칭

Id

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-Usage<Usage>

Specifies the usage setting for the storage pool. 이 매개 변수에 허용되는 값은 다음과 같습니다. Other, ReservedAsDeltaReplicaContainer, ReservedForComputerSystem, ReservedForLocalReplicationServices, ReservedForMigrationServices, ReservedForRemoteReplicationServices, ReservedForSparing, and Unrestricted.


별칭

NewUsage

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-WriteCacheSizeDefault<UInt64>

Specifies the default write-back cache size for virtual disks in the storage pool.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(http://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

  • None

참고

  • Microsoft.Management.Infrastructure.CimInstance 개체는 WMI(Windows Management Instrumentation) 개체를 표시하는 래퍼 클래스입니다. 파운드 기호(#) 뒤에 오는 경로는 기본 WMI 개체의 네임스페이스 및 클래스 이름을 제공합니다.

예제

Example 1: Change the friendly name

This example changes the friendly name of StoragePool to StoragePool2.


PS C:\> Set-StoragePool -FriendlyName StoragePool -NewFriendlyName StoragePool2

Example 2: Make a read-only storage pool writeable

This example makes the storage pool named Storage Pool 1 writable when it is in a read-only state.


PS C:\> Set-StoragePool -FriendlyName "Storage Pool 1" -IsReadOnly $False

Example 3: Set the default resiliency and provisioning settings

This example makes any new virtual disks by default use the Mirror resiliency setting and thin provisioning.


PS C:\> Set-StoragePool -FriendlyName "Storage Pool 1" -ResiliencySettingsNameDefault Mirror -ProvisioningTypeDefault Thin

관련 항목

커뮤니티 추가 항목

추가
표시: