Compartir a través de


Get-AzRmStorageShare

Obtiene o enumera recursos compartidos de archivos de almacenamiento.

Sintaxis

AccountNameSingle (valor predeterminado)

Get-AzRmStorageShare
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    [-Name <String>]
    [-SnapshotTime <DateTime>]
    [-GetShareUsage]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

AccountName

Get-AzRmStorageShare
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    [-IncludeDeleted]
    [-IncludeSnapshot]
    [-Filter <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

AccountObjectSingle

Get-AzRmStorageShare
    -StorageAccount <PSStorageAccount>
    -Name <String>
    [-SnapshotTime <DateTime>]
    [-GetShareUsage]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

AccountObject

Get-AzRmStorageShare
    -StorageAccount <PSStorageAccount>
    [-IncludeDeleted]
    [-IncludeSnapshot]
    [-Filter <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ShareResourceId

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.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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>)

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountObject
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-GetShareUsage

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountNameSingle
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountObjectSingle
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ShareResourceId
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeDeleted

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountObject
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IncludeSnapshot

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountObject
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Nombre del recurso compartido

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:N, ShareName

Conjuntos de parámetros

AccountNameSingle
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

Nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountNameSingle
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountName
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceId

Escriba un identificador de recurso del recurso compartido de archivos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ShareResourceId
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-SnapshotTime

Uso compartido de SnapshotTime

Propiedades de parámetro

Tipo:

Nullable<T>[DateTime]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountNameSingle
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountObjectSingle
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StorageAccount

Objeto de cuenta de almacenamiento

Propiedades de parámetro

Tipo:PSStorageAccount
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountObjectSingle
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountObject
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StorageAccountName

Nombre de la cuenta de almacenamiento.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Nombre de la cuenta

Conjuntos de parámetros

AccountNameSingle
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AccountName
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSStorageAccount

String

Salidas

PSShare