Remove-AzRmStorageShare

參考

模組:: Az.Storage

拿掉記憶體檔案共用。

語法

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

New-AzRmStorageShare Cmdlet 會移除記憶體檔案共用。

範例

範例 1：使用記憶體帳戶名稱和共用名稱移除記憶體檔案共用

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

此命令會移除具有記憶體帳戶名稱和共用名稱的記憶體檔案共用。

範例 2：使用記憶體帳戶對象和共用名稱移除記憶體檔案共用

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

此命令會移除記憶體檔案共用與記憶體帳戶對象和共享名稱。

範例 3：使用管線移除記憶體帳戶中的所有記憶體檔案共用

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

此命令會移除記憶體帳戶中具有管線的所有記憶體檔案共用。

範例 4：移除單一記憶體檔案共用快照集

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

此命令會移除具有特定共享名稱和快照集時間的單一記憶體檔案共用快照集

範例 5：移除記憶體檔案共用及其快照集

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

此命令會移除記憶體檔案共用，而且預設為快照集，如果檔案共用具有不含 “-include” 參數的快照集，Cmdlet 將會失敗。

範例 6：移除記憶體檔案共用及其所有快照集（包括租用的快照集）

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

此命令會移除記憶體檔案共用及其所有快照集，包括已租用和未租用的快照集。根據預設，如果檔案共享有沒有 “-include” 參數的快照集，Cmdlet 將會失敗。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

強制移除共用（快照集）及其中的所有內容

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Include

有效值為：快照集、租用快照集、無。預設值為 none。若沒有共用快照集，則會刪除檔案共用。如果檔案共用包含任何快照集（租用或未發行），則刪除會失敗。針對「快照集」，檔案共用會遭到刪除，包括其所有檔案共用快照集。如果檔案共用包含租用的快照集，則刪除會失敗。若為「leased-snapshots」，則會刪除檔案共用，並包含其所有檔案共用快照集（leased / unleased）。

類型:	String
接受的值:	None, Snapshots, Leased-Snapshots
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

Storage Share 物件

類型:	PSShare
別名:	Share
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

共用名稱

類型:	String
別名:	N, ShareName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PassThru

指出此 Cmdlet 會傳回反映作業成功的 布爾值。根據預設，此 Cmdlet 不會傳回值。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源組名。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceId

輸入檔案共用資源標識碼。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-SnapshotTime

Share SnapshotTime

類型:	Nullable<T>[DateTime]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-StorageAccount

記憶體帳戶物件

類型:	PSStorageAccount
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-StorageAccountName

儲存體帳戶名稱。

類型:	String
別名:	AccountName
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

PSStorageAccount

PSShare

輸出

Boolean

共用方式為