Get-AzStorageContainer
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.
| Typ: | Nullable<T>[Int32] |
| Aliasy: | ClientTimeoutPerRequestInSeconds |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | IStorageContext |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ContinuationToken
Określa token kontynuacji dla listy obiektów blob.
| Typ: | BlobContinuationToken |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzureRmContext, AzureCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-IncludeDeleted
Dołączanie usuniętych kontenerów domyślnie kontenerów listy nie będzie zawierać usuniętych kontenerów
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-MaxCount
Określa maksymalną liczbę obiektów zwracanych przez to polecenie cmdlet.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Aliasy: | N, Container |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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".
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Nullable<T>[Int32] |
| Aliasy: | ServerTimeoutPerRequestInSeconds |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |