Remove-AzRmStorageShare
Remove um compartilhamento de arquivo de armazenamento.
Sintaxe
AccountName (Default)
Remove-AzRmStorageShare
[-ResourceGroupName] <String>
[-StorageAccountName] <String>
-Name <String>
[-Force]
[-Include <String>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AccountNameSnapshot
Remove-AzRmStorageShare
[-ResourceGroupName] <String>
[-StorageAccountName] <String>
-Name <String>
-SnapshotTime <DateTime>
[-Force]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AccountObject
Remove-AzRmStorageShare
-Name <String>
-StorageAccount <PSStorageAccount>
[-Force]
[-Include <String>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AccountObjectSnapshot
Remove-AzRmStorageShare
-Name <String>
-StorageAccount <PSStorageAccount>
-SnapshotTime <DateTime>
[-Force]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ShareResourceId
Remove-AzRmStorageShare
[-ResourceId] <String>
[-Force]
[-Include <String>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ShareObject
Remove-AzRmStorageShare
-InputObject <PSShare>
[-Force]
[-Include <String>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Remove-AzRmStorageShare remove um compartilhamento de arquivos de armazenamento.
Exemplos
Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare"
Esse comando remove um compartilhamento de arquivos de armazenamento com o nome da conta de armazenamento e o nome do compartilhamento.
$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
Remove-AzRmStorageShare -StorageAccount $accountObject -Name "myshare"
Esse comando remove um compartilhamento de arquivos de armazenamento com o objeto de conta de armazenamento e o nome do compartilhamento.
Get-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" | Remove-AzRmStorageShare -Force
Esse comando remove todos os compartilhamentos de arquivos de armazenamento em uma conta de armazenamento com pipeline.
Exemplo 4: remover um único instantâneo de compartilhamento de arquivo de armazenamento
Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -SnapshotTime "2021-05-10T08:04:08Z"
Esse comando remove um único instantâneo de compartilhamento de arquivos de armazenamento com o nome de compartilhamento específico e o tempo de instantâneo
Exemplo 5: remover um compartilhamento de arquivos de armazenamento e seus instantâneos
Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -Include Snapshots
Esse comando remove um compartilhamento de arquivos de armazenamento e seus instantâneos por padrão, o cmdlet falhará se o compartilhamento de arquivos tiver instantâneos sem o parâmetro "-include".
Exemplo 6: remover um compartilhamento de arquivos de armazenamento e todos os instantâneos (incluir instantâneos alugados)
Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -Include Leased-Snapshots
Esse comando remove um compartilhamento de arquivos de armazenamento e todos os instantâneos, incluem instantâneos alugados e não concedidos.
Por padrão, o cmdlet falhará se o compartilhamento de arquivos tiver instantâneos sem o parâmetro "-include".
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: cf
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Propriedades do parâmetro
Tipo: IAzureContextContainer
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Force
Forçar a remoção do compartilhamento(instantâneo) e todo o conteúdo nele
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Include
Os valores válidos são: instantâneos, instantâneos alugados, nenhum. O valor padrão é nenhum.
Para 'none', o compartilhamento de arquivos será excluído se não tiver instantâneos de compartilhamento. Se o compartilhamento de arquivos contiver instantâneos (concedidos ou não salvos), a exclusão falhará.
Para 'instantâneos', o compartilhamento de arquivos é excluído, incluindo todos os instantâneos de compartilhamento de arquivos. Se o compartilhamento de arquivos contiver instantâneos concedidos, a exclusão falhará.
Para 'leased-snapshots', o compartilhamento de arquivos é excluído incluído em todos os seus instantâneos de compartilhamento de arquivos (concedidos/salvos).
Propriedades do parâmetro
Tipo: String
Valor padrão: None Valores aceitos: None, Snapshots, Leased-Snapshots Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AccountName
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountObject
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
ShareResourceId
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
ShareObject
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
Objeto Compartilhamento de Armazenamento
Tipo: PSShare
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: Share
ShareObject
Cargo: Named Obrigatório: True Valor do pipeline: True Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Name
Nome do Compartilhamento
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: N, ShareName
Conjuntos de parâmetros
AccountName
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameSnapshot
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountObject
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountObjectSnapshot
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-PassThru
Indica que esse cmdlet retorna um booliano que reflete o sucesso da operação.
Por padrão, esse cmdlet não retorna um valor.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ResourceGroupName
Nome do Grupo de Recursos.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AccountName
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameSnapshot
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ResourceId
Insira uma ID de recurso de compartilhamento de arquivo.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ShareResourceId
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-SnapshotTime
Share SnapshotTime
Propriedades do parâmetro
Conjuntos de parâmetros
AccountNameSnapshot
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountObjectSnapshot
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-StorageAccount
Objeto da conta de armazenamento
Propriedades do parâmetro
Tipo: PSStorageAccount
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AccountObject
Cargo: Named Obrigatório: True Valor do pipeline: True Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountObjectSnapshot
Cargo: Named Obrigatório: True Valor do pipeline: True Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-StorageAccountName
Nome da conta de armazenamento.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: Nome da Conta
Conjuntos de parâmetros
AccountName
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
AccountNameSnapshot
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: wi
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: 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 .
Saídas
