Remove-SCGuestOSProfile
從 VMM 移除客體作業系統設定檔物件。
Syntax
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 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
強制執行命令而不要求使用者確認。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GuestOSProfile
指定來賓作業系統設定檔物件。
Type: | GuestOSProfile |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-JobVariable
指定追蹤工作進度,並將工作進度存放在這個參數命名的變數中。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
指定觸發此動作之 PRO 提示 (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 |
備註
- 需要 VMM 客體作業系統設定檔物件,可使用 Get-SCGuestOSProfile Cmdlet 來擷取。