MSFT_StorageSubSystem 클래스의 CreateVirtualDisk 메서드
새 가상 디스크를 만듭니다.
구문
UInt32 CreateVirtualDisk(
[in] String FriendlyName,
[in] UInt16 Usage,
[in] String OtherUsageDescription,
[in, out] UInt64 Size,
[in] Boolean UseMaximumSize,
[in] UInt16 NumberOfDataCopies,
[in] UInt16 PhysicalDiskRedundancy,
[in] UInt16 NumberOfColumns,
[in] UInt64 Interleave,
[in] UInt16 ParityLayout,
[in] Boolean RequestNoSinglePointOfFailure,
[in] Boolean IsEnclosureAware,
[in] UInt16 ProvisioningType,
[in] Boolean RunAsJob,
[out] String CreatedVirtualDisk,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
매개 변수
FriendlyName [in]
가상 디스크의 이름입니다.
친숙한 이름은 설명이 필요하지만 고유할 필요는 없습니다. 일부 스토리지 하위 시스템은 가상 디스크를 만드는 동안 친숙한 이름을 설정할 수 없습니다. 하위 시스템이 이를 지원하지 않는 경우 가상 디스크 만들기는 여전히 성공해야 하지만 디스크에 다른 이름이 할당되어 있을 수 있습니다.
이 매개 변수는 필수이며 NULL일 수 없습니다.
사용량 [in]
가상 디스크의 용도를 지정합니다.
미리 정의된 설명 또는 사용자 지정 설명을 지정할 수 있습니다. 미리 정의된 설명을 지정하려면 Other 이외의 값을 사용합니다.
사용자 지정 설명을 지정하려면 Other를 사용하고 OtherUsageDescription 매개 변수에 NULL이 아닌 값을 지정합니다.
기타 (1)
무제한 (2)
ComputerSystem(블록 서버)용으로 예약됨 (3)
복제 서비스로 예약됨 (4)
Migration Services에서 예약됨 (5)
로컬 복제본 원본 (6)
원격 복제본 원본 (7)
로컬 복제본 대상 (8)
원격 복제본 대상 (9)
로컬 복제본 원본 또는 대상 (10)
원격 복제본 원본 또는 대상 (11)
델타 복제본 대상 (12)
요소 구성 요소 (13)
풀 기여자로 예약 됨(14)
복합 볼륨 멤버 (15)
Composite VirtualDisk 멤버 (16)
스파링 예약 (17)
OtherUsageDescription [in]
새 가상 디스크에 대한 공급업체별 사용량입니다. 이 매개 변수는 Usage 매개 변수가 Other로 설정된 경우에만 지정할 수 있습니다.
크기 [in, out]
가상 디스크의 원하는 크기(바이트)입니다. 일부 스토리지 하위 시스템은 크기를 할당 단위 크기의 배수로 반올림합니다.
스토리지 하위 시스템은 UseMaximumSize 매개 변수가 FALSE 또는 NULL인 경우에만 이 매개 변수를 사용합니다.
UseMaximumSize 매개 변수가 TRUE이면 이 매개 변수는 무시됩니다.
이 매개 변수는 필수이며 0일 수 없습니다.
UseMaximumSize [in]
TRUE이면 가상 디스크를 만드는 데 사용할 수 있는 최대 크기를 사용합니다.
이 매개 변수는 Size 매개 변수와 함께 사용할 수 없습니다.
NumberOfDataCopies [in]
이 가상 디스크에 대해 유지 관리할 전체 데이터 복사본 수입니다.
PhysicalDiskRedundancy [in]
데이터 손실이 발생하기 전에 가상 디스크가 견딜 수 있어야 하는 실제 디스크 오류 수입니다.
NumberOfColumns [in]
데이터를 스트라이프해야 하는 기본 실제 디스크의 수입니다. 이 매개 변수는 필수입니다.
인터리브 [in]
일반적인 스트라이프 기반 복원력 설정의 스트립에 대해 수행해야 하는 바이트 수입니다. 스트립은 하나의 실제 디스크에 있는 스트라이프 부분의 크기로 정의됩니다. 따라서 인터리브 * NumberOfColumns 는 한 줄무늬의 크기를 생성합니다. 이 매개 변수는 필수입니다.
ParityLayout [in]
패리티 기반 복원력 설정이 필요한 경우 이 매개 변수를 다음 값 중 하나로 설정합니다.
원하는 복원력 설정이 패리티 기반이 아닌 경우 이 속성은 NULL이어야 합니다.
회전되지 않는 패리티 (1)
회전 패리티 (2)
RequestNoSinglePointOfFailure [in]
단일 실패 지점을 요청하지 않으면 TRUE 로 설정합니다.
IsEnclosureAware [in]
이 가상 디스크에 대한 할당 동작입니다. 인클로저 인식 가상 디스크는 중복성에 사용할 실제 디스크를 지능적으로 선택합니다. TRUE이면 가상 디스크는 서로 다른 인클로저의 실제 디스크를 사용하여 두 개 이상의 물리적 인클로저 간의 내결함성을 분산하려고 시도합니다.
ProvisioningType [in]
가상 디스크에 대한 프로비전 유형입니다.
얇음 (1)
수정됨 (2)
RunAsJob [in]
TRUE이면 요청이 서비스에 오래 걸리는 경우 이 메서드는 CreatedStorageJob 매개 변수를 사용합니다. 작업을 추적하기 위해 스토리지 작업을 만든 경우 이 메서드는 메서드 매개 변수 선택됨 - 작업이 시작된 것을 반환합니다.
참고
RunAsJob이 TRUE인 경우에도 이 메서드는 충분한 시간 내에 완료된 경우에도 결과를 반환할 수 있습니다.
FALSE 또는 NULL인 경우 이 메서드는 호출에 대한 클라이언트의 메서드에 의해 결정되는 기본 WMI 비동기 동작을 따릅니다. 즉, 달리 요청하지 않는 한 동기적입니다.
CreatedVirtualDisk [out]
가상 디스크가 성공적으로 만들어지면 이 매개 변수는 포함된 MSFT_VirtualDisk 개체가 포함된 문자열을 받습니다.
CreatedStorageJob [out]
RunAsJob이 TRUE로 설정되어 있고 이 메서드를 실행하는 데 시간이 오래 걸리는 경우 이 매개 변수는 장기 실행 작업을 추적하는 데 사용되는 스토리지 작업 개체에 대한 참조를 받습니다.
ExtendedStatus [out]
포함된 MSFT_StorageExtendedStatus 개체를 포함하는 문자열입니다.
이 매개 변수를 사용하면 스토리지 공급자가 확장(구현별) 오류 정보를 반환할 수 있습니다.
반환 값
성공 (0)
지원되지 않음 (1)
지정되지 않은 오류 (2)
시간 제한 (3)
실패( 4)
잘못된 매개 변수 (5)
메서드 매개 변수 선택됨 - 작업 시작 됨(4096)
크기가 지원되지 않음 (4097)
여유 공간이 부족 함(40000)
액세스 거부됨 (40001)
작업을 완료하는 데 충분한 리소스가 없습니다. (40002)
캐시 만료 (40003)
Size 또는 UseMaximumSize 매개 변수를 사용하여 크기를 지정해야 합니다. 이러한 매개 변수 중 하나만 한 번에 지정할 수 있습니다. (40005)
스토리지 공급자에 연결할 수 없습니다. (46000)
스토리지 공급자는 스토리지 하위 시스템에 연결할 수 없습니다. (46001)
이 가상 디스크 구성을 지원할 수 있는 스토리지 풀을 찾을 수 없습니다. (47000)
NoSinglePointOfFailure 값은 지원되지 않습니다. (49001)
PhysicalDiskRedundancy 값이 지원되는 값 범위를 벗어났습니다. (49002)
NumberOfDataCopies 값이 지원되는 값 범위를 벗어났습니다. (49003)
ParityLayout 값이 지원되는 값 범위를 벗어났습니다. (49004)
Interleave 값이 지원되는 값 범위를 벗어났습니다. (49005)
NumberOfColumns 값이 지원되는 값 범위를 벗어났습니다. (49006)
설명
이 메서드는 일반적으로 다음 중 하나가 true인 경우에 사용됩니다.
- 스토리지 하위 시스템의 스토리지 풀은 가상 디스크를 직접 만들 수 없습니다.
- 스토리지 하위 시스템은 스토리지 풀을 지원하지 않습니다.
스토리지 관리 공급자는 사용자에 대한 스토리지 풀을 "지능적으로" 선택하도록 이 방법을 구현하도록 선택할 수도 있습니다. 이 메서드가 지원되는 경우 하위 시스템의 SupportsAutomaticStoragePoolSelection 속성을 TRUE로 설정해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 네임스페이스 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |