다음을 통해 공유


New-AzStorageContainer

Azure Storage 컨테이너를 만듭니다.

구문

New-AzStorageContainer
   [-Name] <String>
   [[-Permission] <BlobContainerPublicAccessType>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
New-AzStorageContainer
   [-Name] <String>
   [[-Permission] <BlobContainerPublicAccessType>]
   -DefaultEncryptionScope <String>
   -PreventEncryptionScopeOverride <Boolean>
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

New-AzStorageContainer cmdlet은 Azure Storage 컨테이너를 만듭니다.

예제

예제 1: Azure Storage 컨테이너 만들기

New-AzStorageContainer -Name "ContainerName" -Permission Off

이 명령은 스토리지 컨테이너를 만듭니다.

예제 2: 여러 Azure Storage 컨테이너 만들기

"container1 container2 container3".split() | New-AzStorageContainer -Permission Container

이 예제에서는 여러 스토리지 컨테이너를 만듭니다. .NET 문자열 클래스의 Split 메서드를 사용한 다음 파이프라인에 이름을 전달합니다.

예제 3: 암호화 범위를 사용하여 Azure Storage 컨테이너 만들기

$container = New-AzStorageContainer  -Name "mycontainer" -DefaultEncryptionScope "myencryptscope" -PreventEncryptionScopeOverride $true 

$container.BlobContainerProperties.DefaultEncryptionScope
myencryptscope

$container.BlobContainerProperties.PreventEncryptionScopeOverride
True

이 명령은 기본 암호화 범위를 myencryptscope로 사용하여 스토리지 컨테이너를 만들고, 다른 암호화 범위를 사용하여 Blob 업로드를 이 컨테이너로 미리 변환합니다.

매개 변수

-ClientTimeoutPerRequest

하나의 서비스 요청에 대한 클라이언트 쪽 제한 시간 간격(초)을 지정합니다. 이전 호출이 지정된 간격으로 실패하면 이 cmdlet은 요청을 다시 시도합니다. 이 cmdlet이 간격이 경과하기 전에 성공적인 응답을 받지 못하면 이 cmdlet은 오류를 반환합니다.

형식:Nullable<T>[Int32]
별칭:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ConcurrentTaskCount

최대 동시 네트워크 호출을 지정합니다. 이 매개 변수를 사용하여 동시 네트워크 호출의 최대 수를 지정하여 로컬 CPU 및 대역폭 사용을 제한하는 동시성을 제한할 수 있습니다. 지정된 값은 절대 개수이며 코어 수를 곱하지 않습니다. 이 매개 변수는 초당 100킬로비트와 같은 낮은 대역폭 환경에서 네트워크 연결 문제를 줄이는 데 도움이 될 수 있습니다. 기본값은 10입니다.

형식:Nullable<T>[Int32]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Context

새 컨테이너의 컨텍스트를 지정합니다.

형식:IStorageContext
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DefaultEncryptionScope

모든 쓰기에 대해 지정된 암호화 범위를 사용하도록 컨테이너의 기본값입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

새 컨테이너의 이름을 지정합니다.

형식:String
별칭:N, Container
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Permission

이 컨테이너에 대한 공용 액세스 수준을 지정합니다. 기본적으로 컨테이너 및 컨테이너의 모든 Blob은 스토리지 계정 소유자만 액세스할 수 있습니다. 익명 사용자에게 컨테이너 및 해당 Blob에 대한 읽기 권한을 부여하려면 컨테이너 권한을 설정하여 공용 액세스를 사용하도록 설정할 수 있습니다. 익명 사용자는 요청을 인증하지 않고 공개적으로 사용 가능한 컨테이너에서 Blob을 읽을 수 있습니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 컨테이너. 컨테이너 및 해당 Blob에 대한 전체 읽기 권한을 제공합니다. 클라이언트는 익명 요청을 통해 컨테이너의 Blob을 열거할 수 있지만 스토리지 계정의 컨테이너를 열거할 수는 없습니다.
  • Blob. 익명 요청을 통해 컨테이너 전체에서 Blob 데이터에 대한 읽기 액세스를 제공하지만 컨테이너 데이터에 대한 액세스는 제공하지 않습니다. 클라이언트는 익명 요청을 사용하여 컨테이너의 Blob을 열거할 수 없습니다.
  • 해제. 스토리지 계정 소유자에 대한 액세스만 제한합니다.
형식:Nullable<T>[BlobContainerPublicAccessType]
별칭:PublicAccess
허용되는 값:Off, Container, Blob, Unknown
Position:1
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PreventEncryptionScopeOverride

컨테이너 기본값에서 암호화 범위의 재정의를 차단합니다.

형식:Boolean
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServerTimeoutPerRequest

요청에 대한 서비스 쪽 제한 시간 간격(초)을 지정합니다. 서비스에서 요청을 처리하기 전에 지정된 간격이 경과하면 스토리지 서비스가 오류를 반환합니다.

형식:Nullable<T>[Int32]
별칭:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

IStorageContext

출력

AzureStorageContainer