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中。此操作所需的凭据为本地 Administrator 帐户或库服务器上具有管理员权限的域帐户。下面的命令使用 $Credential 向每个需要凭据的 cmdlet 传递您的凭据。

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

第三个命令通过指定其名称) 作为 VMM 中的库服务器来删除高度可用的文件服务器 (。此命令使用 RunAsynchronously 参数在此命令完成 () 之前立即将控件返回到 shell，因为最后一个命令不需要等到此命令完成之后。

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

参数

-Confirm

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

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

-Credential

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

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

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

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

-JobVariable

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

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

-LibraryServer

指定一个 VMM 库服务器对象。

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

-PROTipID

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

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

-RunAsynchronously

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

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。此 cmdlet 未运行。

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

通过