Remove-SCLibraryShare

从 VMM 中删除库共享,但不会从 Windows 文件系统中删除该共享。

语法

Remove-SCLibraryShare
      [-LibraryShare] <LibraryShare>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-SCLibraryShare cmdlet 从 Virtual Machine Manager (VMM) 库中删除库共享。 此 cmdlet 不会从计算机上的文件系统中删除任何共享或文件。

此 cmdlet 在成功时返回对象(属性 MarkedForDeletion 设置为 $True),或在失败时返回错误消息。

示例

示例 1:从 VMM 库中删除库共享对象

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Remove-SCLibraryShare -LibraryShare $LibShare

第一个命令从 VMMServer01 上的 VMM 库获取名为 AllVHD 的库共享对象,然后将该对象存储在$LibShare变量中。

第二个命令从 VMM 库中删除库共享对象和此共享中的所有库对象,但不会从库服务器上的文件系统中删除共享或其内容。

示例 2:从 VMM 库中删除多个库共享对象

PS C:\> $LibShares = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "vhd" }
PS C:\> $LibShares | Remove-SCLibraryShare

第一个命令获取 LibraryServer01 上的所有库共享对象,其名称包括 VMMServer01 上的 VMM 库中的字符串“vhd”,然后将这些共享对象存储在$LibShares变量(对象数组)中。

第二个命令将$LibShares中的每个库共享对象传递给 remove-SCLibraryShare。 该 cmdlet 从 VMM 库中删除每个库共享对象和共享中的所有对象,但不从库服务器上的文件系统中删除相应的共享或其内容。

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-JobVariable

指定在此参数命名的变量中跟踪和存储作业进度。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LibraryShare

指定 VMM 库共享对象。

类型:LibraryShare
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PROTipID

指定触发此操作的性能和资源优化提示(PRO 提示)的 ID。 此参数允许你审核 PRO 提示。

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunAsynchronously

指示作业以异步方式运行,以便控件立即返回到命令行界面。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False