Get-AzRmStorageShare
Obtém ou lista compartilhamentos de arquivos de armazenamento.
Syntax
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
O cmdlet Get-AzRmStorageShare obtém ou lista compartilhamentos de arquivos de armazenamento.
Exemplos
Exemplo 1: Obter um compartilhamento de arquivo 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 5120Esse comando obtém um compartilhamento de arquivo 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 TransactionOptimizedEste comando lista todos os compartilhamentos de arquivos de armazenamento de uma conta de armazenamento com o nome da conta de armazenamento.
Exemplo 3: Obter um contêiner de blob de armazenamento com o objeto de 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 5120Esse 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 arquivo 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 2097152Esse comando obtém um compartilhamento de arquivo de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento e inclui o uso do 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 01D61FD1FC5498B6Este comando lista todos os compartilhamentos de arquivos de armazenamento, incluindo os compartilhamentos excluídos e os instantâneos de compartilhamento.
Exemplo 6: Obter um único instantâneo de compartilhamento
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:08ZEsse comando obtém um único instantâneo de compartilhamento de arquivos com o nome do compartilhamento e a hora do 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 TransactionOptimizedEste comando lista todos os compartilhamentos de arquivos de armazenamento com nomes que começam com "test".
Parâmetros
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
O filtro do nome do compartilhamento. Quando especificado, somente os nomes de compartilhamento iniciados com o filtro serão listados. O filtro deve estar no formato: startswith(name, <prefix>)
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GetShareUsage
Especifique esse parâmetro para obter o uso de compartilhamento em bytes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeDeleted
Incluir compartilhamentos excluídos, por padrão, os compartilhamentos de lista não incluirão compartilhamentos excluídos
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeSnapshot
Inclua instantâneos de compartilhamento, por padrão, os compartilhamentos de lista não incluirão instantâneos de compartilhamento.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Nome do compartilhamento
| Type: | String |
| Aliases: | N, ShareName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
Nome do grupo de recursos.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceId
Insira uma ID de recurso de compartilhamento de arquivos.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SnapshotTime
Compartilhar SnapshotTime
| Type: | Nullable<T>[DateTime] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccount
Objeto de conta de armazenamento
| Type: | PSStorageAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountName
Nome da conta de armazenamento.
| Type: | String |
| Aliases: | AccountName |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Saídas
Azure PowerShell
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de