Remove-AzRmStorageShare

Modul:

Az.Storage

Odebere sdílenou složku úložiště.

Syntaxe

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

Rutina New-AzRmStorageShare odebere sdílenou složku úložiště.

Příklady

Příklad 1: Odebrání sdílené složky úložiště s názvem účtu úložiště a názvem sdílené složky

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

Tento příkaz odebere sdílenou složku úložiště s názvem účtu úložiště a názvem sdílené složky.

Příklad 2: Odebrání sdílené složky úložiště s objektem účtu úložiště a názvem sdílené složky

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

Tento příkaz odebere sdílenou složku úložiště s objektem účtu úložiště a názvem sdílené složky.

Příklad 3: Odebrání všech sdílených složek úložiště v účtu úložiště s kanálem

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

Tento příkaz odebere všechny sdílené složky úložiště v účtu úložiště s kanálem.

Příklad 4: Odebrání jednoho snímku sdílené složky úložiště

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

Tento příkaz odebere jeden snímek sdílené složky úložiště s konkrétním názvem sdílené složky a časem snímku.

Příklad 5: Odebrání sdílené složky úložiště a jeho snímků

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

Tento příkaz odebere sdílenou složku úložiště a ve výchozím nastavení se snímky nezdaří, pokud sdílená složka obsahuje snímky bez parametru -include.

Příklad 6: Odebrání sdílené složky úložiště a všech snímků (včetně zapůjčených snímků)

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

Tento příkaz odebere sdílenou složku úložiště a všechny její snímky, včetně zapůjčených a ne zapůjčených snímků. Rutina ve výchozím nastavení selže, pokud sdílená složka obsahuje snímky bez parametru -include.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

Vynucení odebrání sdílené složky (snímku) a veškerého obsahu v ní

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Include

Platné hodnoty jsou: snímky, zapůjčené snímky, žádné. Výchozí hodnota není žádná. V případě žádné sdílené složky se sdílená složka odstraní, pokud nemá žádné snímky sdílené složky. Pokud sdílená složka obsahuje nějaké snímky (zapůjčené nebo nezajedené), odstranění se nezdaří. U snímků se sdílená složka odstraní, včetně všech jeho snímků sdílené složky. Pokud sdílená složka obsahuje zapůjčené snímky, odstranění selže. U zapůjčených snímků se sdílená složka odstraní, včetně všech jeho snímků sdílené složky (zapůjčených nebo neležovaných).

Typ:	String
Přípustné hodnoty:	None, Snapshots, Leased-Snapshots
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

Objekt sdílené složky úložiště

Typ:	PSShare
Aliasy:	Share
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

Název sdílené složky

Typ:	String
Aliasy:	N, ShareName
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PassThru

Označuje, že tato rutina vrátí logickou, která odráží úspěch operace. Ve výchozím nastavení tato rutina nevrací hodnotu.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceGroupName

Název skupiny prostředků

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceId

Zadejte ID prostředku sdílené složky.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SnapshotTime

Share SnapshotTime

Typ:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StorageAccount

Objekt účtu úložiště

Typ:	PSStorageAccount
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-StorageAccountName

Název účtu úložiště

Typ:	String
Aliasy:	AccountName
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

PSStorageAccount

PSShare

Výstupy

Boolean