다음을 통해 공유


Get-AzureStorageContainer

스토리지 컨테이너를 나열합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

Get-AzureStorageContainer
   [[-Name] <String>]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageContainer
   -Prefix <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

Get-AzureStorageContainer cmdlet은 Azure의 스토리지 계정과 연결된 스토리지 컨테이너를 나열합니다.

예제

예제 1: 이름으로 Azure Storage Blob 가져오기

PS C:\>Get-AzureStorageContainer -Name container*

이 예제에서는 와일드카드 문자를 사용하여 컨테이너로 시작하는 이름의 모든 컨테이너 목록을 반환합니다.

예제 2: 컨테이너 이름 접두사로 Azure Storage 컨테이너 가져오기

PS C:\>Get-AzureStorageContainer -Prefix "container"

이 예제에서는 접두사 매개 변수를 사용하여 컨테이너로 시작하는 이름의 모든 컨테이너 목록을 반환합니다.

매개 변수

-ClientTimeoutPerRequest

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

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

-ConcurrentTaskCount

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

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

-Context

스토리지 컨텍스트를 지정합니다. 만들려면 New-AzureStorageContext cmdlet을 사용할 수 있습니다. 쿼리 컨테이너 권한에는 스토리지 계정 키 권한이 필요하기 때문에 SAS 토큰에서 만든 스토리지 컨텍스트를 사용하는 경우 컨테이너 권한이 검색되지 않습니다.

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

-ContinuationToken

Blob 목록에 대한 연속 토큰을 지정합니다.

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

-DefaultProfile

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

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

-MaxCount

이 cmdlet이 반환하는 최대 개체 수를 지정합니다.

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

-Name

컨테이너 이름을 지정합니다. 컨테이너 이름이 비어 있으면 cmdlet은 모든 컨테이너를 나열합니다. 그렇지 않으면 지정된 이름 또는 일반 이름 패턴과 일치하는 모든 컨테이너가 나열됩니다.

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

-Prefix

가져올 컨테이너 또는 컨테이너의 이름에 사용되는 접두사를 지정합니다. 이를 사용하여 "my" 또는 "test"와 같은 동일한 문자열로 시작하는 모든 컨테이너를 찾을 수 있습니다.

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

-ServerTimeoutPerRequest

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

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

입력

String

IStorageContext

출력

AzureStorageContainer