你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

说明

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。 对于“none”，如果文件共享没有共享快照，则会删除文件共享。如果文件共享包含任何快照（已租用或未发布），则删除将失败。 对于“snapshots”，文件共享将被删除，包括其所有文件共享快照。 如果文件共享包含租用的快照，则删除会失败。 对于“leased-snapshots”，文件共享将被删除，包括其所有文件共享快照（已租用/未发布）。

类型:	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

输入文件共享资源 ID。

类型:	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