通过

Remove-SCLibraryServer

  • 参考
模块:
VirtualMachineManager

从 VMM 中删除库服务器。

语法

Remove-SCLibraryServer
      [-LibraryServer] <LibraryServer>
      -Credential <VMMCredential>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-SCLibraryServer cmdlet 从 Virtual Machine Manager （VMM） 数据库中删除库服务器对象（以及该库服务器上的所有库对象）。 此 cmdlet 不会从文件系统中删除具有相应文件（如 .vhd 或 .vmdk 文件）的库对象。

此 cmdlet 按如下所示运行：

  • 如果此库服务器也是 VMM 服务器，则无法删除库服务器，因此删除库服务器操作将失败。

  • 如果此计算机既是库服务器又是主机，则此 cmdlet 仅从 VMM 中删除库服务器功能，但计算机将继续充当主机。

  • 如果此计算机只是库服务器（不是主机或 VMM 服务器），则库服务器将从 VMM 中删除。

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

示例

示例 1：从 VMM 中删除库服务器对象

PS C:\> $Creds = Get-Credential
PS C:\> $LibServ = Get-SCLibraryServer -VMMServer "VMMServer1.Contoso.com" -ComputerName "LibraryServer01.Contoso.com"
PS C:\> Remove-SCLibraryServer -LibraryServer $LibServ -Credential $Creds

第一个命令会提示输入凭据。 出现对话框时，键入本地管理员帐户或具有库服务器上的管理员权限的域帐户的用户名和密码。

第二个命令检索 VMMServer01 上的名为 LibraryServer01 的库服务器对象，并将其存储在$LibServ变量中。

第三个命令从 VMM 库中删除库服务器对象以及此服务器上的所有库共享。 当 Remove-SCLibraryServer cmdlet 与 LibraryServer 参数一起使用时，只能将一个库服务器对象传递给 cmdlet。

示例 2：删除名称中包含特定字符串的多个库服务器对象

PS C:\> $Creds = Get-Credential
PS C:\> $LibServers = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "LibraryServer" }
PS C:\> $LibServers | Remove-SCLibraryServer -Credential $Creds

第一个命令会提示输入凭据。 出现对话框时，键入本地管理员帐户或具有库服务器上的管理员权限的域帐户的用户名和密码。

第二个命令从 VMMServer01 获取包含字符串“LibraryServer”的名称的所有库服务器对象，并将返回的对象存储在$LibServers变量（对象数组）中。

第三个命令将$LibServers中的每个库服务器对象传递给 Remove-SCLibraryServer，这会从 VMM 中删除每个对象。

示例 3：删除高度可用的库服务器及其所有节点

PS C:\> $Credential = Get-Credential
PS C:\> $Cluster = Find-SCCluster -ComputerName "HAFileServer01.Contoso.com" -Credential $Credential
PS C:\> Remove-LibraryServer -LibraryServer "HAFileServer01.Contoso.com" -Credential $Credential -RunAsynchronously
PS C:\> ForEach ($Node in $Cluster.ClusterNodes) {Remove-LibraryServer -LibraryServer $Node -Credential $Credential -RunAsynchronously}

第一个命令使用 Get-Credential 来提示你提供用户名和密码，并将凭据存储在$Credential中。 此操作所需的凭据是本地管理员帐户或具有库服务器上的管理员权限的域帐户。 以下命令使用$Credential将凭据传递给需要凭据的每个 cmdlet。

第二个命令使用 Find-SCCluster cmdlet 来确认 HAFileServer01 是高度可用的文件服务器，并将群集对象存储在$Cluster变量中。

第三个命令从 VMM 中删除高度可用的文件服务器（方法是将其名称指定为库服务器）。 该命令使用 RunAsynchronous 参数立即（在此命令完成之前）返回对 shell 的控制，因为最后一个命令不需要等到此命令完成之后。

最后一个命令使用 ForEach 循环将存储在 $Cluster.ClusterNodes 中的每个对象传递给 Remove-SCLibraryServer cmdlet，该 cmdlet 会从 VMM 中删除每个节点。 该命令使用 RunAsynchronous 参数立即将控制权返回到 shell。 有关库服务器的详细信息，请键入 Get-Help Add-LibraryServer -Detailed。 有关 Windows PowerShell ForEach 循环语句的详细信息，请键入 Get-Help about_ForEach。

参数

-Confirm

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

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

-Credential

指定凭据对象，或者，对于某些 cmdlet，一个运行方式帐户对象，该对象包含有权执行此操作的帐户的用户名和密码。 或者，如果 Restart-SCJob，则有权完成重启的任务。

有关 PSCredential 对象的详细信息，请键入 Get-Help Get-Credential。

有关运行方式帐户的详细信息，请键入 Get-Help New-SCRunAsAccount。

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

-JobVariable

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

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

-LibraryServer

指定 VMM 库服务器对象。

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