Remove-SCGuestOSProfile

从 VMM 中删除来宾操作系统配置文件对象。

语法

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

说明

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,该 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 提示)的 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

备注

  • 需要 VMM 来宾操作系统配置文件对象,可以使用 Get-SCGuestOSProfile cmdlet 进行检索。