Partilhar via

Remove-AzRmStorageShare

Módulo:
Az.Storage Module

Remove um compartilhamento de arquivos de armazenamento.

Sintaxe

AccountName (Predefinição) 

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

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"

Este 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 de conta de armazenamento e o nome do compartilhamento

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
Remove-AzRmStorageShare -StorageAccount $accountObject -Name "myshare"

Este comando remove um compartilhamento de arquivos de armazenamento com o objeto de 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

Este 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"

Este comando remove um único instantâneo de compartilhamento de arquivos de armazenamento com o nome de compartilhamento e o tempo de 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

Este 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 (incluir instantâneos alugados)

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

Este comando remove um compartilhamento de arquivos de armazenamento e todos os seus instantâneos, incluindo 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 confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

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

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

-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

-Force

Forçar a remoção do compartilhamento (instantâneo) e todo o conteúdo nele

Propriedades dos parâmetros

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

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

-Include

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:None, Snapshots, Leased-Snapshots
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
ShareResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ShareObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputObject

Objeto de compartilhamento de armazenamento

Propriedades dos parâmetros

Tipo:PSShare
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Partilhar

Conjuntos de parâmetros

ShareObject
Position:Named
Obrigatório:True
Valor do pipeline:True
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

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

-PassThru

Indica que esse cmdlet retorna um Boolean que reflete o sucesso da operação. Por padrão, esse cmdlet não retorna um valor.

Propriedades dos parâmetros

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

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

-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

AccountName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
AccountNameSnapshot
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

AccountNameSnapshot
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
AccountObjectSnapshot
Position:Named
Obrigatório:True
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

AccountObject
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
AccountObjectSnapshot
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

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

-WhatIf

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

Propriedades dos parâmetros

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

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

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.

Entradas

String

PSStorageAccount

PSShare

Saídas

Boolean