Remove-AzRmStorageShare

Referenz

Modul:: Az.Storage

Entfernt eine Speicherdateifreigabe.

Syntax

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

Beschreibung

Das Cmdlet New-AzRmStorageShare entfernt eine Speicherdateifreigabe.

Beispiele

Beispiel 1: Entfernen einer Speicherdateifreigabe mit dem Namen des Speicherkontos und des Freigabenamens

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

Mit diesem Befehl wird eine Speicherdateifreigabe mit dem Namen des Speicherkontos und dem Freigabenamen entfernt.

Beispiel 2: Entfernen einer Speicherdateifreigabe mit Speicherkontoobjekt und Freigabename

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

Mit diesem Befehl wird eine Speicherdateifreigabe mit dem Speicherkontoobjekt und dem Freigabenamen entfernt.

Beispiel 3: Entfernen aller Speicherdateifreigaben in einem Speicherkonto mit Pipeline

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

Mit diesem Befehl werden alle Speicherdateifreigaben in einem Speicherkonto mit Pipeline entfernt.

Beispiel 4: Entfernen einer einzelnen Speicherdateifreigabe Momentaufnahme

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

Dieser Befehl entfernt eine einzelne Speicherdateifreigabe Momentaufnahme mit dem spezifischen Freigabenamen und Momentaufnahme Zeit.

Beispiel 5: Entfernen einer Speicherdateifreigabe und Momentaufnahme

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

Mit diesem Befehl wird eine Speicherdateifreigabe entfernt, die standardmäßig Momentaufnahme s ist, schlägt das Cmdlet fehl, wenn die Dateifreigabe Momentaufnahme ohne Parameter "-include" aufweist.

Beispiel 6: Entfernen einer Speicherdateifreigabe und aller Momentaufnahme (einschließlich geleaste Momentaufnahme s)

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

Mit diesem Befehl wird eine Speicherdateifreigabe entfernt, und es sind alle Momentaufnahme, einschließlich geleaste und nicht geleaste Momentaufnahme s. Standardmäßig schlägt das Cmdlet fehl, wenn die Dateifreigabe Momentaufnahme ohne Parameter "-include" aufweist.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Erzwingen, dass die Freigabe(Momentaufnahme) und alle darin enthaltenen Inhalte entfernt werden

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Include

Gültige Werte sind: Momentaufnahme s, leased-Momentaufnahme s, none. Der Standardwert ist keine. Bei "none" wird die Dateifreigabe gelöscht, wenn sie keine Freigabe Momentaufnahme s hat.Wenn die Dateifreigabe Momentaufnahme s(leased oder unleased) enthält, schlägt der Löschvorgang fehl. Bei "Momentaufnahme s" wird die Dateifreigabe einschließlich aller dateifreigaben Momentaufnahme gelöscht. Wenn die Dateifreigabe leasete Momentaufnahme enthält, schlägt der Löschvorgang fehl. Bei "leased-Momentaufnahme s" wird die Dateifreigabe gelöscht, einschließlich aller Dateifreigaben Momentaufnahme s (geleast/entleaset).

Typ:	String
Zulässige Werte:	None, Snapshots, Leased-Snapshots
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Storage Share-Objekt

Typ:	PSShare
Aliase:	Share
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Freigabename

Typ:	String
Aliase:	N, ShareName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PassThru

Gibt an, dass dieses Cmdlet einen Wert vom Typ Boolean zurückgibt, der den Erfolg des Vorgangs widerspiegelt. Standardmäßig gibt dieses Cmdlet keinen Wert zurück.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Ressourcengruppenname.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceId

Geben Sie eine Ressourcen-ID für dateifreigaben ein.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-SnapshotTime

SnapshotTime freigeben

Typ:	Nullable<T>[DateTime]
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-StorageAccount

Speicherkontoobjekt

Typ:	PSStorageAccount
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-StorageAccountName

Speicherkontoname.

Typ:	String
Aliase:	AccountName
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

PSStorageAccount

PSShare

Ausgaben

Boolean

Freigeben über