Get-AzRmStorageShare

Módulo:: Az.Storage Module

Obtém ou lista compartilhamentos de arquivos de armazenamento.

Sintaxe

AccountNameSingle (Predefinição)

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

O cmdlet Get-AzRmStorageShare obtém ou lista compartilhamentos de arquivos de armazenamento.

Exemplos

Exemplo 1: Obter um compartilhamento de arquivos de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

Este comando obtém um compartilhamento de arquivos de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento.

Exemplo 2: Listar todos os compartilhamentos de arquivos de armazenamento de uma conta de armazenamento

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 lista todos os compartilhamentos de arquivos de armazenamento de uma conta de armazenamento com o nome da conta de armazenamento.

Exemplo 3: Obtenha um contêiner de blob de armazenamento com o objeto da conta de armazenamento e o nome do contêiner.

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 obtém um contêiner de blob de armazenamento com o objeto de conta de armazenamento e o nome do contêiner.

Exemplo 4: Obter um compartilhamento de arquivos de armazenamento com o uso de compartilhamento em 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 obtém um compartilhamento de arquivos de armazenamento com nome de conta de armazenamento e nome de compartilhamento e inclui o uso de compartilhamento em bytes.

Exemplo 5: Listar todos os compartilhamentos de arquivos de armazenamento de uma conta de armazenamento, incluir os compartilhamentos excluídos, incluir os instantâneos de compartilhamento

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 lista todos os compartilhamentos de arquivos de armazenamento, incluindo os compartilhamentos excluídos e instantâneos de compartilhamento.

Exemplo 6: Obter um instantâneo de compartilhamento único

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 obtém um único instantâneo de compartilhamento de arquivos com nome de compartilhamento e tempo de instantâneo.

Exemplo 7: Listar compartilhamentos de arquivos de armazenamento de uma conta de armazenamento com um 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 lista todos os compartilhamentos de arquivos de armazenamento com nomes que começam com "test".

Parâmetros

-DefaultProfile

As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:	IAzureContextContainer
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Filter

O filtro do nome do compartilhamento. Quando especificado, apenas os nomes de compartilhamento que começam com o filtro serão listados. O filtro deve estar no formato: startswith(name, <prefix>)

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AccountName

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

AccountObject

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-GetShareUsage

Especifique esse parâmetro para obter o uso de compartilhamento em bytes.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AccountNameSingle

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

AccountObjectSingle

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

ShareResourceId

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-IncludeDeleted

Incluir compartilhamentos excluídos, por padrão os compartilhamentos de lista não incluirão compartilhamentos excluídos

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AccountName

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

AccountObject

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-IncludeSnapshot

Inclua instantâneos de compartilhamento, por padrão, os compartilhamentos de lista não incluirão instantâneos de compartilhamento.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AccountName

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

AccountObject

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Name

Nome da Partilha

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	N, Nome_do_compartilhamento

Conjuntos de parâmetros

AccountNameSingle

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ResourceGroupName

Nome do Grupo de Recursos.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AccountNameSingle

Position:	0
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

AccountName

Position:	0
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ResourceId

Insira uma ID de recurso de compartilhamento de arquivos.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

ShareResourceId

Position:	0
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-SnapshotTime

Compartilhar SnapshotTime

Propriedades dos parâmetros

Tipo:	Nullable<T>[DateTime]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AccountNameSingle

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

AccountObjectSingle

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-StorageAccount

Objeto da conta de armazenamento

Propriedades dos parâmetros

Tipo:	PSStorageAccount
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

AccountObjectSingle

Position:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

AccountObject

Position:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-StorageAccountName

Nome da conta de armazenamento.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Nome da Conta

Conjuntos de parâmetros

AccountNameSingle

Position:	1
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

AccountName

Position:	1
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Partilhar via

Get-AzRmStorageShare

Sintaxe

AccountNameSingle (Predefinição)

AccountName

AccountObjectSingle

AccountObject

ShareResourceId

Description

Exemplos

Exemplo 1: Obter um compartilhamento de arquivos de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento

Exemplo 2: Listar todos os compartilhamentos de arquivos de armazenamento de uma conta de armazenamento

Exemplo 3: Obtenha um contêiner de blob de armazenamento com o objeto da conta de armazenamento e o nome do contêiner.

Exemplo 4: Obter um compartilhamento de arquivos de armazenamento com o uso de compartilhamento em bytes

Exemplo 5: Listar todos os compartilhamentos de arquivos de armazenamento de uma conta de armazenamento, incluir os compartilhamentos excluídos, incluir os instantâneos de compartilhamento

Exemplo 6: Obter um instantâneo de compartilhamento único

Exemplo 7: Listar compartilhamentos de arquivos de armazenamento de uma conta de armazenamento com um filtro

Parâmetros

-DefaultProfile

Propriedades dos parâmetros

Conjuntos de parâmetros

-Filter

Propriedades dos parâmetros

Conjuntos de parâmetros

-GetShareUsage

Propriedades dos parâmetros

Conjuntos de parâmetros

-IncludeDeleted

Propriedades dos parâmetros

Conjuntos de parâmetros

-IncludeSnapshot

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceGroupName

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceId

Propriedades dos parâmetros

Conjuntos de parâmetros

-SnapshotTime

Propriedades dos parâmetros

Conjuntos de parâmetros

-StorageAccount

Propriedades dos parâmetros

Conjuntos de parâmetros

-StorageAccountName

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

PSStorageAccount

String

Saídas

PSShare

Comentários