New-CMTSStepConditionQueryWmi
为任务 序列步骤创建 WMI 查询条件。
语法
New-CMTSStepConditionQueryWmi
[-Namespace <String[]>]
-Query <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
使用此 cmdlet 为任务序列步骤创建 WMI 查询条件对象。 然后,将New-CMTSStep * _ 或 _ Set-CMTSStep * _ cmdlet 之一与 _ Condition 或AddCondition参数一同使用。 例如 ,Set-CMTSStepApplyDataImage。
有关详细信息,请参阅使用任务 序列编辑器:条件。
备注
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:基于硬件模型创建查询条件
此示例首先创建一个条件对象来查询计算机模型的 WMI。
然后,它使用Set-CMTSStepRunPowerShellScript cmdlet 将此条件对象添加到默认操作系统部署任务序列的"运行PowerShell脚本"步骤中。
$model = "Latitude E7470"
$query = "Select * From Win32_ComputerSystem Where Model = `"$model`""
$condition = New-CMTSStepConditionQueryWMI -Namespace "root\cimv2" -Query $query
$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"
Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $condition
此示例脚本在步骤上创建以下条件:
WMI Query Select * From Win32_ComputerSystem Where Model = "Latitude E7470"
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符,并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Namespace
指定查询的 WMI 命名空间。 例如,root\cimv2
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Query
指定 WMI 查询。 cmdlet 不测试查询的有效性。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
无
输出
IResultObject
备注
有关此返回对象及其属性的信息,请参阅 SMS_TaskSequence_WMIConditionExpression 服务器 WMI 类。