Compartir a través de


Get-AzStorageContainer

Especifica los contenedores de almacenamiento.

Sintaxis

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

El cmdlet Get-AzStorageContainer enumera los contenedores de almacenamiento asociados a la cuenta de almacenamiento en Azure.

Ejemplos

Ejemplo 1: Obtención del contenedor de Azure Storage por nombre

Get-AzStorageContainer -Name container*

En este ejemplo se usa un carácter comodín para devolver una lista de todos los contenedores con un nombre que comienza por el contenedor.

Ejemplo 2: Obtención del contenedor de Azure Storage por prefijo de nombre de contenedor

Get-AzStorageContainer -Prefix "container"

En este ejemplo se usa el parámetro Prefix para devolver una lista de todos los contenedores con un nombre que comienza por el contenedor.

Ejemplo 3: Enumerar el contenedor de Azure Storage, incluir contenedores eliminados

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

En este ejemplo se enumeran todos los contenedores de una cuenta de almacenamiento, se incluyen contenedores eliminados. A continuación, muestre las propiedades del contenedor eliminadas, como : DeletedOn, RemainingRetentionDays. Los contenedores eliminados solo existirán después de habilitar container softdelete con Enable-AzStorageBlobDeleteRetentionPolicy.

Parámetros

-ClientTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado cliente, en segundos, para una solicitud de servicio. Si se produce un error en la llamada anterior en el intervalo especificado, este cmdlet reintenta la solicitud. Si este cmdlet no recibe una respuesta correcta antes de que transcurre el intervalo, este cmdlet devuelve un error.

Tipo:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ConcurrentTaskCount

Especifica el número máximo de llamadas de red simultáneas. Puede usar este parámetro para limitar la simultaneidad para limitar el uso de ancho de banda y CPU local especificando el número máximo de llamadas de red simultáneas. El valor especificado es un recuento absoluto y no se multiplica por el recuento de núcleos. Este parámetro puede ayudar a reducir los problemas de conexión de red en entornos de ancho de banda bajo, como 100 kilobits por segundo. El valor predeterminado es 10.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Context

Especifica el contexto de almacenamiento. Para crearlo, puede usar el cmdlet New-AzStorageContext. Los permisos de contenedor no se recuperarán al usar un contexto de almacenamiento creado a partir del token de SAS, ya que los permisos de contenedor de consultas requieren permiso de clave de cuenta de almacenamiento.

Tipo:IStorageContext
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ContinuationToken

Especifica un token de continuación para la lista de blobs.

Tipo:BlobContinuationToken
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IncludeDeleted

Incluir contenedores eliminados, de forma predeterminada, los contenedores de lista no incluirán contenedores eliminados.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaxCount

Especifica el número máximo de objetos que devuelve este cmdlet.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre del contenedor. Si el nombre del contenedor está vacío, el cmdlet enumera todos los contenedores. De lo contrario, enumera todos los contenedores que coinciden con el nombre especificado o el patrón de nombre normal.

Tipo:String
Alias:N, Container
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-Prefix

Especifica un prefijo usado en el nombre del contenedor o contenedores que desea obtener. Puede usarlo para buscar todos los contenedores que comienzan con la misma cadena, como "my" o "test".

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServerTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado del servicio, en segundos, para una solicitud. Si el intervalo especificado transcurre antes de que el servicio procese la solicitud, el servicio de almacenamiento devuelve un error.

Tipo:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

IStorageContext

Salidas

AzureStorageContainer