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 之前,提示你进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-HardwareProfile
指定硬件配置文件对象。
类型: | HardwareProfile |
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-SCHardwareProfile cmdlet 进行检索。