Remove-SCHardwareProfile

从 VMM 库中删除硬件配置文件对象。

语法

Remove-SCHardwareProfile
      [-HardwareProfile] <HardwareProfile>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Remove-SCHardwareProfile cmdlet 从 VMM 库中删除一个或多个硬件配置文件对象。

此 cmdlet 在成功时返回对象, 将 MarkedForDeletion 属性设置为$True,或在失败时返回错误消息。

示例

示例 1:从库中删除特定硬件配置文件

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01"}
PS C:\> Remove-SCHardwareProfile -HardwareProfile $HWProfile -Confirm

第一个命令从 VMM 库获取名为 NewHWProfile01 的硬件配置文件对象,并将对象存储在$HWProfile变量中。

第二个命令从库中删除 NewHWProfle01,提示用户在完成操作之前进行确认。

示例 2:删除所有硬件配置文件,而不提示确认每次删除

PS C:\> Get-SCHardwareProfile | Remove-SCHardwareProfile

此命令获取库中的所有硬件配置文件对象,并将每个配置文件对象传递给 Remove-SCHardwareProfile cmdlet,该 cmdlet 会删除每个硬件配置文件。 如果不使用 Confirm 参数,系统不会提示你确认是否删除这些硬件配置文件对象。

参数

-Confirm

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

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

-HardwareProfile

指定硬件配置文件对象。

Type:HardwareProfile
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 提示) 的性能和资源优化提示的 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

备注

  • 需要 VMM 硬件配置文件对象,可以使用 Get-SCHardwareProfile cmdlet 进行检索。