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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String
Accepted values:	None, Snapshots, Leased-Snapshots
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Storage Share-Objekt

Type:	PSShare
Aliases:	Share
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Freigabename

Type:	String
Aliases:	N, ShareName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Ressourcengruppenname.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SnapshotTime

SnapshotTime freigeben

Type:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccount

Speicherkontoobjekt

Type:	PSStorageAccount
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccountName

Speicherkontoname.

Type:	String
Aliases:	AccountName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

String

PSStorageAccount

PSShare

Ausgaben

Boolean

Share via