Get-AzRmStorageShare

  • Referencia
Módulo:
Az.Storage

Obtiene o enumera recursos compartidos de archivos de almacenamiento.

Sintaxis

Get-AzRmStorageShare
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   [-Name <String>]
   [-SnapshotTime <DateTime>]
   [-GetShareUsage]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzRmStorageShare
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   [-IncludeDeleted]
   [-IncludeSnapshot]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   -Name <String>
   [-SnapshotTime <DateTime>]
   [-GetShareUsage]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   [-IncludeDeleted]
   [-IncludeSnapshot]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzRmStorageShare
   [-ResourceId] <String>
   [-GetShareUsage]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Get-AzRmStorageShare obtiene o enumera los recursos compartidos de archivos de Storage.

Ejemplos

Ejemplo 1: Obtener un recurso compartido de archivos de almacenamiento con el nombre de la cuenta de almacenamiento y el nombre del recurso compartido

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120

Este comando obtiene un recurso compartido de archivos de almacenamiento con el nombre de la cuenta de almacenamiento y el nombre del recurso compartido.

Ejemplo 2: Enumeración de todos los recursos compartidos de archivos de almacenamiento de una cuenta de almacenamiento

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes
----     -------- ---------------- ----------           ------- ------- ---------------
share1   5120                     TransactionOptimized
share2   5120                     TransactionOptimized

Este comando enumera todos los recursos compartidos de archivos de almacenamiento de una cuenta de almacenamiento con el nombre de la cuenta de almacenamiento.

Ejemplo 3: Obtención de un contenedor de blobs de Storage con el objeto de cuenta de Storage y el nombre del contenedor.

Get-AzStorageAccount -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Get-AzRmStorageShare -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120

Este comando obtiene un contenedor de blobs de Storage con el objeto de cuenta de Storage y el nombre del contenedor.

Ejemplo 4: Obtener un recurso compartido de archivos de almacenamiento con el uso del recurso compartido en bytes

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -GetShareUsage

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120                                                2097152

Este comando obtiene un recurso compartido de archivos de almacenamiento con el nombre de la cuenta de almacenamiento y el nombre del recurso compartido, e incluye el uso del recurso compartido en bytes.

Ejemplo 5: Enumerar todos los recursos compartidos de archivos de almacenamiento de una cuenta de almacenamiento, incluir los recursos compartidos eliminados, incluir las instantáneas de recurso compartido

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -IncludeDeleted -IncludeSnapshot

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version          ShareUsageBytes snapshotTime       
----       -------- ---------------- ----------           ------- -------          --------------- ------------       
testshare1 5120                     TransactionOptimized                                          2021-05-10T08:04:08Z
testshare1 5120                     TransactionOptimized                                                      
share1     100                      TransactionOptimized True    01D61FD1FC5498B6

Este comando enumera todos los recursos compartidos de archivos de storage incluyen los recursos compartidos eliminados y las instantáneas de recurso compartido.

Ejemplo 6: Obtención de una sola instantánea de recurso compartido

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "testshare1" -SnapshotTime "2021-05-10T08:04:08Z"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes snapshotTime       
----       -------- ---------------- ----------           ------- ------- --------------- ------------       
testshare1 5120                     TransactionOptimized                                 2021-05-10T08:04:08Z

Este comando obtiene una única instantánea de recurso compartido de archivos con el nombre del recurso compartido y la hora de la instantánea.

Ejemplo 7: Enumerar recursos compartidos de archivos de almacenamiento de una cuenta de almacenamiento con un filtro

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Filter "startswith(name, test)"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes snapshotTime
----       -------- ---------------- ----------           ------- ------- --------------- ------------
testshare1 5120     SMB              TransactionOptimized
testshare2 5120     SMB              TransactionOptimized

Este comando enumera todos los recursos compartidos de archivos de Storage con nombres que comienzan por "test".

Parámetros

-DefaultProfile

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

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

-Filter

Filtro del nombre del recurso compartido. Cuando se especifica, solo se mostrarán los nombres de recurso compartido a partir del filtro. El filtro debe estar en formato: startswith(name, <prefix>)

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

-GetShareUsage

Especifique este parámetro para obtener el uso compartido en bytes.

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

-IncludeDeleted

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

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

-IncludeSnapshot

Incluir instantáneas de recurso compartido; de forma predeterminada, los recursos compartidos de lista no incluirán instantáneas de recurso compartido.

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

-Name

Nombre del recurso compartido

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

-ResourceGroupName

Nombre del grupo de recursos.

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

-ResourceId

Escriba un identificador de recurso del recurso compartido de archivos.

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

-SnapshotTime

Uso compartido de SnapshotTime

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

-StorageAccount

Objeto de cuenta de almacenamiento

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

-StorageAccountName

Nombre de la cuenta de almacenamiento.

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

Entradas

PSStorageAccount

String

Salidas

PSShare