Remove-AzRmStorageShare

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

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

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 zobrazí výzvu k potvrzení.

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

-DefaultProfile

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

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

-Force

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

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

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

-InputObject

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

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

-Name

Název sdílené složky

Type:String
Aliases:N, ShareName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

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

-ResourceGroupName

Název skupiny prostředků

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

-ResourceId

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

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

-SnapshotTime

Share SnapshotTime

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

-StorageAccount

Objekt účtu úložiště

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

-StorageAccountName

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

String

PSStorageAccount

PSShare

Výstupy

Boolean