共用方式為

Remove-SCGuestOSProfile

  • 參考
模組:
VirtualMachineManager

從 VMM 移除客體作業系統配置檔物件。

語法

Remove-SCGuestOSProfile
      [-GuestOSProfile] <GuestOSProfile>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Remove-SCGuestOSProfile Cmdlet 會從 VMM 連結庫移除一或多個客體作業系統配置檔物件。

這個 Cmdlet 會在成功時傳回物件（屬性 MarkedForDeletion 設為 True），或在失敗時傳回錯誤訊息。

範例

範例 1：從連結庫移除特定客體作業系統配置檔

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Remove-SCGuestOSProfile -GuestOSProfile $OSProfile -Confirm

第一個命令會取得名為 NewOSProfile01 的客體作業系統配置檔物件，並將物件儲存在$OSProfile變數中。

第二個命令會移除儲存在 $OSProfile 中的客體作業系統配置檔，並在完成作業之前提示確認。

範例 2：移除所有作業系統設定檔，而不提示確認每個刪除

PS C:\> $OSProfiles = Get-SCGuestOSProfile -VMMServer "VMMServer01.Contoso.com"
PS C:\> $OSProfiles | Remove-SCGuestOSProfile

第一個命令會從 VMMServer01 取得所有作業系統配置檔物件，並將物件儲存在$OSProfiles物件陣列中。

第二個命令會將$OSProfiles中的每個對象傳遞至 Remove-OSProfile Cmdlet，這會從 VMM 連結庫移除每個客體操作系統配置檔物件。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

強制命令執行，而不要求使用者確認。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-GuestOSProfile

指定客體作業系統配置檔物件。

類型:GuestOSProfile
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-JobVariable

指定作業進度會追蹤並儲存在此參數所命名的變數中。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PROTipID

指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 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

備註

  • 需要 VMM 客體作業系統設定檔物件，您可以使用 Get-SCGuestOSProfile Cmdlet 來擷取此物件。