다음을 통해 공유

MSFT_StorageSubSystem 클래스의 CreateStoragePool 메서드

  • 아티클

공통 기본 풀 내에 포함된 사용 가능한 실제 디스크에서 스토리지 풀을 만듭니다.

MSFT_PhysicalDisk 개체의CanPool 속성이 TRUE인 경우 스토리지 풀을 만드는 데 실제 디스크를 사용할 수 있습니다.

스토리지 풀 만들기는 스토리지 하위 시스템의 MSFT_StorageSubSystem 개체의 SupportsStoragePoolCreation 속성이 TRUE인 경우에만 사용할 수 있습니다.

구문

UInt32 CreateStoragePool(
  [in]  String              FriendlyName,
  [in]  UInt16              Usage,
  [in]  String              OtherUsageDescription,
  [in]  String              PhysicalDisks[],
  [in]  String              ResiliencySettingNameDefault,
  [in]  UInt16              ProvisioningTypeDefault,
  [in]  UInt64              LogicalSectorSizeDefault,
  [in]  Boolean             EnclosureAwareDefault,
  [in]  UInt64              WriteCacheSizeDefault,
  [in]  Boolean             AutoWriteCacheSize,
  [in]  Boolean             RunAsJob,
  [out] String              CreatedStoragePool,
  [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)

OtherUsageDescription [in]

사용자가 새 MSFT_StoragePool 개체에 대한 사용자 지정 사용 유형을 설정할 수 있습니다. 이 매개 변수는 Usage 매개 변수가 Other로 설정된 경우에만 지정할 수 있습니다.

PhysicalDisks [in]

각각 MSFT_PhysicalDisk 클래스의 포함된 instance 포함하는 문자열 배열입니다.

이 매개 변수는 새로 만든 스토리지 풀의 백업 데이터 스토리지로 사용할 MSFT_PhysicalDisk 개체의 배열을 지정하는 데 사용됩니다. 실제 디스크는 이 풀을 만드는 하위 시스템의 기본 풀에서 와야 합니다. 모든 실제 디스크는 동일한 원시 풀에서 와야 합니다.

이 매개 변수는 필수이며 NULL일 수 없습니다.

ResiliencySettingNameDefault [in]

이 스토리지 풀에서 새 가상 디스크를 만들 때 기본적으로 사용할 원하는 복원력 설정입니다. 하위 시스템의 SupportsMultipleResiliencySettingsPerStoragePool 속성이 FALSE로 설정된 경우 이 매개 변수는 이 스토리지 풀에서 복원력 설정을 상속해야 하는 스토리지 관리 공급자에 대한 힌트 역할을 합니다. 값이 지정되지 않은 경우 스토리지 관리 공급자는 가장 적절한 복원력 설정을 선택할 책임이 있습니다.

ProvisioningTypeDefault [in]

이 스토리지 풀에 새 가상 디스크를 만들 때 기본적으로 사용할 원하는 프로비전 유형입니다. 이 매개 변수가 0이면 기본 프로비전 형식이 기본 풀에서 상속됩니다.

얇음 (1)

수정됨 (2)

LogicalSectorSizeDefault [in]

기본 논리 섹터 크기(바이트)입니다. 스토리지 풀에 에뮬레이트된 512 바이트와 4K 바이트 네이티브 또는 512 바이트 네이티브 물리적 디스크가 혼합되어 있을 수 있는 경우에 유용합니다.

EnclosureAwareDefault [in]

인클로저 인식 스토리지 풀에서 만든 가상 디스크에 대한 기본 할당 정책입니다. 예를 들어 엔클로저 인식 하위 시스템은 각 엔클로저에 가상 디스크의 전체 데이터 복사본이 포함되도록 여러 개의 실제 엔클로저에서 가상 디스크의 각 데이터 복사본 균형을 조정할 수 있습니다.

WriteCacheSizeDefault [in]

가상 디스크를 만들기 위한 쓰기 캐시의 기본 크기입니다.

AutoWriteCacheSize [in]

TRUE이면 공급자가 자동 쓰기 캐시 크기를 선택해야 합니다.

RunAsJob [in]

TRUE이면 요청이 서비스에 오래 걸리는 경우 이 메서드는 CreatedStorageJob 매개 변수를 사용합니다. 작업을 추적하기 위해 스토리지 작업을 만든 경우 이 메서드는 메서드 매개 변수 선택됨 - 작업이 시작된 것을 반환합니다.

참고

RunAsJob이 TRUE인 경우에도 이 메서드는 충분한 시간 내에 완료된 경우에도 결과를 반환할 수 있습니다.

FALSE 또는 NULL인 경우 이 메서드는 호출에 대한 클라이언트의 메서드에 의해 결정되는 기본 WMI 비동기 동작을 따릅니다. 즉, 달리 요청하지 않는 한 동기적입니다.

CreatedStoragePool [out]

스토리지 풀이 성공적으로 만들어지면 이 매개 변수는 포함된 MSFT_StoragePool 개체가 포함된 문자열을 받습니다.

CreatedStorageJob [out]

RunAsJob이 TRUE로 설정되어 있고 이 메서드를 실행하는 데 시간이 오래 걸리는 경우 이 매개 변수는 장기 실행 작업을 추적하는 데 사용되는 스토리지 작업 개체에 대한 참조를 받습니다.

ExtendedStatus [out]

포함된 MSFT_StorageExtendedStatus 개체를 포함하는 문자열입니다.

이 매개 변수를 사용하면 스토리지 공급자가 확장(구현별) 오류 정보를 반환할 수 있습니다.

반환 값

성공 (0)

지원되지 않음 (1)

지정되지 않은 오류 (2)

시간 제한 (3)

실패( 4)

잘못된 매개 변수 (5)

개체를 찾을 수 없음 (8)

메서드 매개 변수 선택됨 - 작업 시작 됨(4096)

액세스 거부됨 (40001)

작업을 완료하는 데 충분한 리소스가 없습니다. (40002)

캐시 만료 (40003)

예기치 않은 I/O 오류가 발생했습니다 (40004).

심각한 디바이스 하드웨어 오류로 인해 요청이 실패했습니다. (40007)

스토리지 공급자에 연결할 수 없습니다. (46000)

스토리지 공급자는 스토리지 하위 시스템에 연결할 수 없습니다. (46001)

이 스토리지 개체에 대해 장애 조치(failover) 클러스터링 사용할 수 없습니다. (46008)

해당 이름의 복원력 설정이 없습니다. (49000)

WriteCacheSize 값이 지원되는 값 범위를 벗어났습니다. (50005)

지정된 실제 디스크 중 하나는 이 작업에서 지원되지 않습니다. (51000)

작업을 성공적으로 완료할 수 있는 실제 디스크가 충분하지 않습니다. (51001)

지정된 실제 디스크 중 하나가 이미 사용 중입니다. (51002)

지정된 실제 디스크 중 하나는 이 스토리지 풀에서 지원되지 않는 섹터 크기를 사용합니다. (51003)

하나 이상의 실제 디스크가 풀을 만드는 노드에 연결되지 않습니다. (51005)

설명

스토리지 풀을 지원하지 않는 하위 시스템은 다음과 같이 이 메서드를 구현해야 합니다.

스토리지 풀을 지원하지만 스토리지 풀 선택(가상 디스크가 만들어진 풀의 관리자 선택), 만들기, 수정 또는 삭제를 허용하지 않는 하위 시스템은 다음과 같이 이 메서드를 구현해야 합니다.

스토리지 풀 및 스토리지 풀 선택을 지원하지만 스토리지 풀 만들기, 수정 또는 삭제를 지원하지 않는 하위 시스템은 다음과 같이 이 메서드를 구현해야 합니다.

스토리지 풀 및 스토리지 풀 선택을 지원하고 스토리지 풀 만들기, 수정 또는 삭제를 지원하는 하위 시스템은 다음과 같이 이 메서드를 구현해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
네임스페이스 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

추가 정보

MSFT_StorageSubSystem