共用方式為

Remove-SCLibraryServer

  • 參考
模組:
VirtualMachineManager

從 VMM 移除程式庫伺服器。

Syntax

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

Description

Remove-SCLibraryServer Cmdlet 會從 Virtual Machine Manager (VMM) 資料庫移除程式庫伺服器物件 (，以及該程式庫伺服器) 的所有程式庫物件。 此指令程式不會從檔案系統中移除程式庫物件，這些程式庫物件具有存放在伺服器檔案系統中的對應檔案 (如 .vhd 或 .vmdk 檔案)。

這個指令程式的運作方式如下：

  • 如果此程式庫伺服器也是 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 將您的認證傳遞給每個需要認證的指令程式。

第二個命令會使用 Find-SCCluster Cmdlet 來確認 HAFileServer01 是高可用性檔案伺服器，並將叢集物件儲存在 $Cluster 變數中。

第三個命令會指定其名稱) 作為 VMM 的程式庫伺服器，以移除高可用性檔案伺服器 (。 此命令會使用 RunAsynchronously 參數，在此命令完成之前立即將控制權傳回殼層 () ，因為最後一個命令不需要等到此命令完成之後。

最後一個命令會使用 ForEach 迴圈，將儲存在 $Cluster.ClusterNodes 中的每個物件傳遞至 Remove-SCLibraryServer Cmdlet，以從 VMM 移除每個節點。 此命令會使用 RunAsynchronously 參數，立即將控制權傳回殼層。 如需程式庫伺服器的詳細資訊，請輸入 Get-Help Add-LibraryServer -Detailed 。 如需forEach迴圈語句Windows PowerShell的詳細資訊，請輸入 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 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 PRO 秘訣。

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

-RunAsynchronously

表示作業會以非同步方式執行，讓控制項立即返回命令殼層。

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