Condividi tramite


Remove-AzRmStorageShare

Rimuove una condivisione file di archiviazione.

Sintassi

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>]

Descrizione

Il cmdlet New-AzRmStorageShare rimuove una condivisione file di archiviazione.

Esempio

Esempio 1: Rimuovere una condivisione file di archiviazione con il nome dell'account di archiviazione e il nome della condivisione

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare"

Questo comando rimuove una condivisione file di archiviazione con il nome dell'account di archiviazione e il nome della condivisione.

Esempio 2: Rimuovere una condivisione file di archiviazione con l'oggetto account di archiviazione e il nome della condivisione

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

Questo comando rimuove una condivisione file di archiviazione con l'oggetto account di archiviazione e il nome della condivisione.

Esempio 3: Rimuovere tutte le condivisioni file di archiviazione in un account di archiviazione con pipeline

Get-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" | Remove-AzRmStorageShare -Force

Questo comando rimuove tutte le condivisioni file di archiviazione in un account di archiviazione con pipeline.

Esempio 4: Rimuovere un singolo snapshot di condivisione file di archiviazione

Remove-AzRmStorageShare -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount" -Name "myshare" -SnapshotTime "2021-05-10T08:04:08Z"

Questo comando rimuove un singolo snapshot di condivisione file di archiviazione con il nome e l'ora dello snapshot di condivisione specifici

Esempio 5: Rimuovere una condivisione file di archiviazione ed è uno snapshot

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

Questo comando rimuove una condivisione file di archiviazione ed è snapshot Per impostazione predefinita, il cmdlet avrà esito negativo se la condivisione file include snapshot senza parametro "-include".

Esempio 6: Rimuovere una condivisione file di archiviazione e tutti gli snapshot (inclusi gli snapshot con lease)

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

Questo comando rimuove una condivisione file di archiviazione e tutti gli snapshot, includono snapshot in lease e non con lease. Per impostazione predefinita, il cmdlet avrà esito negativo se la condivisione file include snapshot senza parametro "-include".

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Forzare la rimozione di Share(snapshot) e di tutto il contenuto

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Include

I valori validi sono: snapshot, snapshot con lease, nessuno. Il valore predefinito non è nessuno. Per 'none', la condivisione file viene eliminata se non contiene snapshot di condivisione. Se la condivisione file contiene snapshot (con lease o non aggiornati), l'eliminazione non riesce. Per gli snapshot, la condivisione file viene eliminata includendo tutti gli snapshot della condivisione file. Se la condivisione file contiene snapshot in lease, l'eliminazione ha esito negativo. Per gli "snapshot con lease", la condivisione file viene eliminata include tutti gli snapshot della condivisione file (leased/unleased).

Tipo:String
Valori accettati:None, Snapshots, Leased-Snapshots
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Oggetto Condivisione di archiviazione

Tipo:PSShare
Alias:Share
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Nome condivisione

Tipo:String
Alias:N, ShareName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Indica che questo cmdlet restituisce un booleano che riflette l'esito positivo dell'operazione. Per impostazione predefinita, questo cmdlet non restituisce un valore.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Nome gruppo di risorse.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceId

Immettere un ID risorsa condivisione file.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SnapshotTime

Share SnapshotTime

Tipo:Nullable<T>[DateTime]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StorageAccount

Oggetto account di archiviazione

Tipo:PSStorageAccount
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-StorageAccountName

Nome account di archiviazione.

Tipo:String
Alias:AccountName
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Output