Get-AzStorageContainer
구문
ContainerName (기본값)
Get-AzStorageContainer
[[-Name] <String>]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-IncludeDeleted]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
ContainerPrefix
Get-AzStorageContainer
-Prefix <String>
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-IncludeDeleted]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Description
Get-AzStorageContainer cmdlet은 Azure의 스토리지 계정과 연결된 스토리지 컨테이너를 나열합니다.
예제
예제 1: 이름으로 Azure Storage 컨테이너 가져오기
Get-AzStorageContainer -Name container*
이 예제에서는 와일드카드 문자를 사용하여 컨테이너로 시작하는 이름의 모든 컨테이너 목록을 반환합니다.
예제 2: 컨테이너 이름 접두사로 Azure Storage 컨테이너 가져오기
Get-AzStorageContainer -Prefix "container"
이 예제에서는 접두사 매개 변수를 사용하여 컨테이너로 시작하는 이름의 모든 컨테이너 목록을 반환합니다.
예제 3: Azure Storage 컨테이너 나열, 삭제된 컨테이너 포함
$containers = Get-AzStorageContainer -IncludeDeleted -Context $ctx
$containers
Storage Account Name: storageaccountname
Name PublicAccess LastModified IsDeleted VersionId
---- ------------ ------------ --------- ---------
testcon Off 8/28/2020 10:18:13 AM +00:00
testcon2 9/4/2020 12:52:37 PM +00:00 True 01D67D248986B6DA
$c[1].BlobContainerProperties
LastModified : 9/4/2020 12:52:37 PM +00:00
LeaseStatus : Unlocked
LeaseState : Expired
LeaseDuration :
PublicAccess :
HasImmutabilityPolicy : False
HasLegalHold : False
DefaultEncryptionScope : $account-encryption-key
PreventEncryptionScopeOverride : False
DeletedOn : 9/8/2020 4:29:59 AM +00:00
RemainingRetentionDays : 299
ETag : "0x8D850D167059285"
Metadata : {}
이 예제에서는 스토리지 계정의 모든 컨테이너를 나열하고 삭제된 컨테이너를 포함합니다.
그런 다음 삭제된 컨테이너 속성을 표시합니다. DeletedOn, RemainingRetentionDays를 포함합니다.
삭제된 컨테이너는 Enable-AzStorageBlobDeleteRetentionPolicy를 사용하여 컨테이너 softdelete를 사용하도록 설정한 후에만 존재합니다.
매개 변수
-ClientTimeoutPerRequest
하나의 서비스 요청에 대한 클라이언트 쪽 제한 시간 간격(초)을 지정합니다.
이전 호출이 지정된 간격으로 실패하면 이 cmdlet은 요청을 다시 시도합니다.
이 cmdlet이 간격이 경과하기 전에 성공적인 응답을 받지 못하면 이 cmdlet은 오류를 반환합니다.
매개 변수 속성
형식: Nullable<T> [ Int32 ]
Default value: None 와일드카드 지원: False DontShow: False 별칭: ClientTimeoutPerRequestInSeconds
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-ConcurrentTaskCount
최대 동시 네트워크 호출을 지정합니다.
이 매개 변수를 사용하여 동시 네트워크 호출의 최대 수를 지정하여 로컬 CPU 및 대역폭 사용을 제한하는 동시성을 제한할 수 있습니다.
지정된 값은 절대 개수이며 코어 수를 곱하지 않습니다.
이 매개 변수는 초당 100킬로비트와 같은 낮은 대역폭 환경에서 네트워크 연결 문제를 줄이는 데 도움이 될 수 있습니다.
기본값은 10입니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Context
스토리지 컨텍스트를 지정합니다.
만들려면 New-AzStorageContext cmdlet을 사용할 수 있습니다.
쿼리 컨테이너 권한에는 스토리지 계정 키 권한이 필요하기 때문에 SAS 토큰에서 만든 스토리지 컨텍스트를 사용하는 경우 컨테이너 권한이 검색되지 않습니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: True 속성 이름별 파이프라인의 값: True 나머지 인수의 값: False
-ContinuationToken
Blob 목록에 대한 연속 토큰을 지정합니다.
매개 변수 속성
형식: Microsoft.Azure.Storage.Blob.BlobContinuationToken
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-IncludeDeleted
삭제된 컨테이너 포함, 기본적으로 목록 컨테이너에는 삭제된 컨테이너가 포함되지 않습니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-MaxCount
이 cmdlet이 반환하는 최대 개체 수를 지정합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Name
컨테이너 이름을 지정합니다.
컨테이너 이름이 비어 있으면 cmdlet은 모든 컨테이너를 나열합니다.
그렇지 않으면 지정된 이름 또는 일반 이름 패턴과 일치하는 모든 컨테이너가 나열됩니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: True DontShow: False 별칭: N, 컨테이너
매개 변수 집합
ContainerName
Position: 0 필수: False 파이프라인의 값: True 속성 이름별 파이프라인의 값: True 나머지 인수의 값: False
-Prefix
가져올 컨테이너 또는 컨테이너의 이름에 사용되는 접두사를 지정합니다.
이를 사용하여 "my" 또는 "test"와 같은 동일한 문자열로 시작하는 모든 컨테이너를 찾을 수 있습니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
ContainerPrefix
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-ServerTimeoutPerRequest
요청에 대한 서비스 쪽 제한 시간 간격(초)을 지정합니다.
서비스에서 요청을 처리하기 전에 지정된 간격이 경과하면 스토리지 서비스가 오류를 반환합니다.
매개 변수 속성
형식: Nullable<T> [ Int32 ]
Default value: None 와일드카드 지원: False DontShow: False 별칭: ServerTimeoutPerRequestInSeconds
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters 를 참조하세요.
출력