Remove-AzRmStorageShare

Referência

Módulo:: Az.Storage

Remove um compartilhamento de arquivos de armazenamento.

Sintaxe

Remove-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      -SnapshotTime <DateTime>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      -SnapshotTime <DateTime>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      [-ResourceId] <String>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzRmStorageShare
      -InputObject <PSShare>
      [-Force]
      [-Include <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet New-AzRmStorageShare remove um compartilhamento de arquivos de armazenamento.

Exemplos

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

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.

Exemplo 2: Remover um compartilhamento de arquivos de armazenamento com o objeto 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 da conta de armazenamento e o nome do compartilhamento.

Exemplo 3: Remover todos os compartilhamentos de arquivos de armazenamento em uma conta de armazenamento com pipeline

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 arquivos 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 e a hora do instantâneo específicos

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 seus instantâneos (incluindo instantâneos concedidos)

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -Include Leased-Snapshots

Esse comando remove um compartilhamento de arquivos de armazenamento e todos os seus instantâneos, incluindo instantâneos concedidos 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.

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Force

Força para remover o Share(snapshot) e todo o conteúdo nele

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Include

Os valores válidos são: snapshots, leased-snapshots, none. 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 (alugados ou não concedidos), a exclusão falhará. Para 'instantâneos', o compartilhamento de arquivos é excluído, incluindo todos os seus instantâneos de compartilhamento de arquivos. Se o compartilhamento de arquivos contiver snapshots concedidos, a exclusão falhará. Para 'snapshots alugados', o compartilhamento de arquivos é excluído, incluindo todos os seus instantâneos de compartilhamento de arquivos (alugados/não alugados).

Tipo:	String
Valores aceitos:	None, Snapshots, Leased-Snapshots
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Objeto de compartilhamento de armazenamento

Tipo:	PSShare
Aliases:	Share
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

Nome do compartilhamento

Tipo:	String
Aliases:	N, ShareName
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceGroupName

Nome do grupo de recursos.

Tipo:	String
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ResourceId

Insira uma ID de recurso de compartilhamento de arquivos.

Tipo:	String
Cargo:	0
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-SnapshotTime

Compartilhar SnapshotTime

Tipo:	Nullable<T>[DateTime]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StorageAccount

Objeto de conta de armazenamento

Tipo:	PSStorageAccount
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-StorageAccountName

Nome da Conta de Armazenamento.

Tipo:	String
Aliases:	AccountName
Cargo:	1
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

String

PSStorageAccount

PSShare

Saídas

Boolean

Compartilhar via