Get-AzStorageContainer
스토리지 컨테이너를 나열합니다.
구문
Get-AzStorageContainer
[[-Name] <String>]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-IncludeDeleted]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>] 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] |
| 별칭: | 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
스토리지 컨텍스트를 지정합니다. 만들려면 New-AzStorageContext 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 |
-IncludeDeleted
삭제된 컨테이너 포함, 기본적으로 목록 컨테이너에는 삭제된 컨테이너가 포함되지 않습니다.
| 형식: | SwitchParameter |
| 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 |
| 와일드카드 문자 허용: | True |
-Prefix
가져올 컨테이너 또는 컨테이너의 이름에 사용되는 접두사를 지정합니다. 이를 사용하여 "my" 또는 "test"와 같은 동일한 문자열로 시작하는 모든 컨테이너를 찾을 수 있습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ServerTimeoutPerRequest
요청에 대한 서비스 쪽 제한 시간 간격(초)을 지정합니다. 서비스에서 요청을 처리하기 전에 지정된 간격이 경과하면 스토리지 서비스가 오류를 반환합니다.
| 형식: | Nullable<T>[Int32] |
| 별칭: | ServerTimeoutPerRequestInSeconds |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |