Update-AzRmStorageShare
Modifica um compartilhamento de arquivos de armazenamento.
Syntax
Update-AzRmStorageShare
[-ResourceGroupName] <String>
[-StorageAccountName] <String>
-Name <String>
[-QuotaGiB <Int32>]
[-Metadata <Hashtable>]
[-AccessTier <String>]
[-RootSquash <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzRmStorageShare
-Name <String>
-StorageAccount <PSStorageAccount>
[-QuotaGiB <Int32>]
[-Metadata <Hashtable>]
[-AccessTier <String>]
[-RootSquash <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzRmStorageShare
[-ResourceId] <String>
[-QuotaGiB <Int32>]
[-Metadata <Hashtable>]
[-AccessTier <String>]
[-RootSquash <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzRmStorageShare
-InputObject <PSShare>
[-QuotaGiB <Int32>]
[-Metadata <Hashtable>]
[-AccessTier <String>]
[-RootSquash <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet New-AzRmStorageShare modifica um compartilhamento de arquivos de armazenamento.
Exemplos
Exemplo 1: Modifica os metadados e a cota de compartilhamento de um compartilhamento de arquivos de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento
$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 200 -Metadata @{tag0="value0";tag1="value1"}
$share
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount
Name QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
---- -------- ---------------- ---------- ------- ------- ---------------
myshare 200
$share.Metadata
Key Value
--- -----
tag0 value0
tag1 value1Esse comando modifica os metadados e a cota de compartilhamento de arquivos de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento, além de mostrar o resultado da modificação com o objeto de compartilhamento de arquivos retornado.
Exemplo 2: Modifica metadados em um compartilhamento de arquivo de armazenamento com o objeto de conta de armazenamento e o nome do compartilhamento
$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
$share = Update-AzRmStorageShare -StorageAccount $accountObject -Name "myshare" -Metadata @{tag0="value0";tag1="value1"}Esse comando modifica metadados em um compartilhamento de arquivo de armazenamento com o objeto de conta de armazenamento e o nome do compartilhamento.
Exemplo 3: Modifica a cota de compartilhamento para todos os compartilhamentos de arquivos de armazenamento em uma conta de armazenamento com pipeline
Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Update-AzRmStorageShare -QuotaGiB 5000
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount
Name QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
---- -------- ---------------- ---------- ------- ------- ---------------
share1 5000
share2 5000Esse comando modifica a cota de compartilhamento como 5000 GiB para todos os compartilhamentos de arquivos de armazenamento em uma conta de armazenamento com pipeline.
Exemplo 4: Modificar um compartilhamento de arquivos de armazenamento com a camada de acesso como Cool
$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Cool
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount
Name QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
---- -------- ---------------- ---------- ------- ------- ---------------
myshare CoolEsse comando modifica um compartilhamento de arquivos de armazenamento com accesstier como Cool.
Exemplo 5: Modifica rootsquash para compartilhamentos de arquivos em uma conta de armazenamento
$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -RootSquash NoRootSquash
$share
ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount
Name QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
---- -------- ---------------- ---------- ------- ------- ---------------
myshare
$share.RootSquash
NoRootSquashEste comando modifica a propriedade Share RootSquash para NoRootSquash. A propriedade RootSquash só está disponível no compartilhamento com EnabledProtocol como NFS.
Parâmetros
-AccessTier
Camada de acesso para compartilhamento específico. A conta StorageV2 pode escolher entre TransactionOptimized (padrão), Quente e Legal. A conta FileStorage pode escolher Premium.
| Type: | String |
| Accepted values: | TransactionOptimized, Premium, Hot, Cool |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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 |
-InputObject
Objeto de compartilhamento de armazenamento
| Type: | PSShare |
| Aliases: | Share |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Metadata
Compartilhar metadados
| Type: | Hashtable |
| 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 |
-QuotaGiB
Cota de compartilhamento em gibibyte.
| Type: | Int32 |
| Aliases: | Quota |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-RootSquash
Define a redução dos direitos de acesso para o superusuário remoto. Os valores possíveis incluem: 'NoRootSquash', 'RootSquash', 'AllSquash'
| Type: | String |
| Accepted values: | NoRootSquash, RootSquash, AllSquash |
| 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 |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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