Get-AzStorageContainer

  • Odwołanie
Moduł:
Az.Storage

Wyświetla listę kontenerów magazynu.

Składnia

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>]

Opis

Polecenie cmdlet Get-AzStorageContainer wyświetla kontenery magazynu skojarzone z kontem magazynu na platformie Azure.

Przykłady

Przykład 1. Pobieranie kontenera usługi Azure Storage według nazwy

Get-AzStorageContainer -Name container*

W tym przykładzie użyto symbolu wieloznakowego, aby zwrócić listę wszystkich kontenerów o nazwie rozpoczynającej się od kontenera.

Przykład 2. Pobieranie kontenera usługi Azure Storage według prefiksu nazwy kontenera

Get-AzStorageContainer -Prefix "container"

W tym przykładzie użyto parametru Prefix , aby zwrócić listę wszystkich kontenerów o nazwie rozpoczynającej się od kontenera.

Przykład 3. Wyświetlanie listy kontenerów usługi Azure Storage, w tym usuniętych kontenerów

$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                       : {}

W tym przykładzie wymieniono wszystkie kontenery konta magazynu, w tym usunięte kontenery. Następnie pokaż usunięte właściwości kontenera, takie jak : DeletedOn, RemainingRetentionDays. Usunięte kontenery będą istnieć tylko po włączeniu funkcji softdelete kontenera z poleceniem Enable-AzStorageBlobDeleteRetentionPolicy.

Parametry

-ClientTimeoutPerRequest

Określa interwał limitu czasu po stronie klienta w sekundach dla jednego żądania obsługi. Jeśli poprzednie wywołanie zakończy się niepowodzeniem w określonym interwale, to polecenie cmdlet ponawia próbę żądania. Jeśli to polecenie cmdlet nie otrzyma pomyślnej odpowiedzi przed upływem interwału, to polecenie cmdlet zwróci błąd.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Określa maksymalne współbieżne wywołania sieciowe. Tego parametru można użyć, aby ograniczyć współbieżność w celu ograniczenia użycia lokalnego procesora CPU i przepustowości, określając maksymalną liczbę współbieżnych wywołań sieciowych. Określona wartość jest liczbą bezwzględną i nie jest mnożona przez liczbę rdzeni. Ten parametr może pomóc w zmniejszeniu problemów z połączeniem sieciowym w środowiskach o niskiej przepustowości, takich jak 100 kilobitów na sekundę. Wartość domyślna to 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Określa kontekst magazynu. Aby go utworzyć, możesz użyć polecenia cmdlet New-AzStorageContext. Uprawnienia kontenera nie zostaną pobrane podczas korzystania z kontekstu magazynu utworzonego na podstawie tokenu SAS, ponieważ uprawnienia kontenera zapytań wymagają uprawnienia klucza konta magazynu.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

Określa token kontynuacji dla listy obiektów blob.

Type:BlobContinuationToken
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

Dołączanie usuniętych kontenerów domyślnie kontenerów listy nie będzie zawierać usuniętych kontenerów

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxCount

Określa maksymalną liczbę obiektów zwracanych przez to polecenie cmdlet.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę kontenera. Jeśli nazwa kontenera jest pusta, polecenie cmdlet wyświetla listę wszystkich kontenerów. W przeciwnym razie wyświetla listę wszystkich kontenerów, które są zgodne z określoną nazwą lub zwykłym wzorcem nazw.

Type:String
Aliases:N, Container
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Prefix

Określa prefiks używany w nazwie kontenera lub kontenerów, które chcesz uzyskać. Można go użyć do znalezienia wszystkich kontenerów rozpoczynających się od tego samego ciągu, takiego jak "my" lub "test".

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Określa interwał limitu czasu po stronie usługi w sekundach dla żądania. Jeśli określony interwał upłynie, zanim usługa przetworzy żądanie, usługa magazynu zwróci błąd.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String

IStorageContext

Dane wyjściowe

AzureStorageContainer