Get-AzStorageContainer
Listet die Speichercontainer auf.
Syntax
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>] Beschreibung
Das Cmdlet "Get-AzStorageContainer " listet die Speichercontainer auf, die dem Speicherkonto in Azure zugeordnet sind.
Beispiele
Beispiel 1: Abrufen des Azure Storage-Containers anhand des Namens
Get-AzStorageContainer -Name container*In diesem Beispiel wird ein Wild Karte Zeichen verwendet, um eine Liste aller Container mit einem Namen zurückzugeben, der mit container beginnt.
Beispiel 2: Abrufen des Azure Storage-Containers nach Containernamenpräfix
Get-AzStorageContainer -Prefix "container"In diesem Beispiel wird der Parameter "Prefix" verwendet, um eine Liste aller Container mit einem Namen zurückzugeben, der mit container beginnt.
Beispiel 3: Azure Storage-Container auflisten, gelöschte Container einschließen
$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 : {}In diesem Beispiel werden alle Container eines Speicherkontos aufgelistet, einschließlich gelöschter Container. Zeigen Sie dann die gelöschten Containereigenschaften an: DeletedOn, Re Standard ingRetentionDays. Gelöschte Container sind nur nach aktiviertem Container softdelete mit Enable-AzStorageBlobDeleteRetentionPolicy vorhanden.
Parameter
-ClientTimeoutPerRequest
Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.
| Typ: | Nullable<T>[Int32] |
| Aliase: | ClientTimeoutPerRequestInSeconds |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ConcurrentTaskCount
Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert ist 10.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Context
Gibt den Speicherkontext an. Zum Erstellen können Sie das Cmdlet New-AzStorageContext verwenden. Die Containerberechtigungen werden nicht abgerufen, wenn Sie einen speicherkontext verwenden, der aus SAS-Token erstellt wurde, da Abfragecontainerberechtigungen Speicherkontoschlüsselberechtigungen erfordern.
| Typ: | IStorageContext |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ContinuationToken
Gibt ein Fortsetzungstoken für die Blobliste an.
| Typ: | BlobContinuationToken |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
| Typ: | IAzureContextContainer |
| Aliase: | AzureRmContext, AzureCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-IncludeDeleted
Gelöschte Container einschließen, standardmäßig enthalten Listencontainer keine gelöschten Container.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MaxCount
Gibt die maximale Anzahl von Objekten an, die dieses Cmdlet zurückgibt.
| Typ: | Nullable<T>[Int32] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den Containernamen an. Wenn der Containername leer ist, listet das Cmdlet alle Container auf. Andernfalls werden alle Container aufgelistet, die dem angegebenen Namen oder dem regulären Namensmuster entsprechen.
| Typ: | String |
| Aliase: | N, Container |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | True |
-Prefix
Gibt ein Präfix an, das im Namen des Containers oder der Container verwendet wird, die Sie abrufen möchten. Sie können dies verwenden, um alle Container zu finden, die mit derselben Zeichenfolge beginnen, z. B. "my" oder "test".
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ServerTimeoutPerRequest
Gibt das Dienstseitige Timeoutintervall in Sekunden für eine Anforderung an. Wenn das angegebene Intervall verstrichen ist, bevor der Dienst die Anforderung verarbeitet, gibt der Speicherdienst einen Fehler zurück.
| Typ: | Nullable<T>[Int32] |
| Aliase: | ServerTimeoutPerRequestInSeconds |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |