Partager via


Get-AzStorageContainer

Liste les conteneurs de stockage.

Syntaxe

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

L’applet de commande Get-AzStorageContainer répertorie les conteneurs de stockage associés au compte de stockage dans Azure.

Exemples

Exemple 1 : Obtenir Stockage Azure conteneur par nom

Get-AzStorageContainer -Name container*

Cet exemple utilise un caractère générique pour renvoyer une liste de tous les conteneurs avec un nom qui commence par le conteneur.

Exemple 2 : Obtenir Stockage Azure conteneur par préfixe de nom de conteneur

Get-AzStorageContainer -Prefix "container"

Cet exemple utilise le paramètre Prefix pour retourner une liste de tous les conteneurs avec un nom qui commence par le conteneur.

Exemple 3 : Répertorier Stockage Azure conteneur, inclure des conteneurs supprimés

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

Cet exemple répertorie tous les conteneurs d’un compte de stockage, y compris les conteneurs supprimés. Affichez ensuite les propriétés de conteneur supprimées, incluez : DeletedOn, RemainingRetentionDays. Les conteneurs supprimés existent uniquement après l’activation de la suppression réversible de conteneur avec Enable-AzStorageBlobDeleteRetentionPolicy.

Paramètres

-ClientTimeoutPerRequest

Spécifie l’intervalle de délai d’attente côté client, en secondes, pour une demande de service. Si l’appel précédent échoue dans l’intervalle spécifié, cette applet de commande retente la requête. Si cette applet de commande ne reçoit pas de réponse réussie avant l’expiration de l’intervalle, cette applet de commande retourne une erreur.

Type:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConcurrentTaskCount

Spécifie le nombre maximal d’appels réseau simultanés. Vous pouvez utiliser ce paramètre pour limiter l’accès concurrentiel pour limiter l’utilisation du processeur local et de la bande passante en spécifiant le nombre maximal d’appels réseau simultanés. La valeur spécifiée est un nombre absolu et n’est pas multipliée par le nombre de cœurs. Ce paramètre peut aider à réduire les problèmes de connexion réseau dans des environnements à faible bande passante, tels que 100 kilobits par seconde. La valeur par défaut est 10.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Context

Spécifie le contexte de stockage. Pour le créer, vous pouvez utiliser l’applet de commande New-AzStorageContext. Les autorisations de conteneur ne sont pas récupérées lorsque vous utilisez un contexte de stockage créé à partir du jeton SAP, car les autorisations de conteneur de requête nécessitent l’autorisation de clé de compte de stockage.

Type:IStorageContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ContinuationToken

Spécifie un jeton de continuation pour la liste d’objets blob.

Type:BlobContinuationToken
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IncludeDeleted

Inclure des conteneurs supprimés, par défaut, les conteneurs de liste n’incluent pas les conteneurs supprimés

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxCount

Spécifie le nombre maximal d’objets retournés par cette applet de commande.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom du conteneur. Si le nom du conteneur est vide, l’applet de commande répertorie tous les conteneurs. Sinon, il répertorie tous les conteneurs qui correspondent au nom spécifié ou au modèle de nom normal.

Type:String
Alias:N, Container
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Prefix

Spécifie un préfixe utilisé dans le nom du conteneur ou des conteneurs que vous souhaitez obtenir. Vous pouvez l’utiliser pour rechercher tous les conteneurs qui commencent par la même chaîne, par exemple « my » ou « test ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerTimeoutPerRequest

Spécifie l’intervalle de délai d’expiration côté service, en secondes, pour une demande. Si l’intervalle spécifié s’écoule avant que le service traite la requête, le service de stockage retourne une erreur.

Type:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

IStorageContext

Sorties

AzureStorageContainer