New-CMTSStepConditionOperatingSystem
为任务序列步骤创建 OS 版本 条件。
语法
New-CMTSStepConditionOperatingSystem
-SupportedPlatform <IResultObject[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
使用此 cmdlet 为任务序列步骤创建 OS 版本 条件对象。 然后,将 New-CMTSStep* 或 Set-CMTSStep* cmdlet 之一与 Condition 或 AddCondition 参数结合使用 。 例如 ,Set-CMTSStepApplyDataImage。
有关详细信息,请参阅 使用任务序列编辑器:条件。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1
此示例首先使用 Get-CMSupportedPlatform cmdlet 创建支持的平台对象,其中包括 Windows 10 和 Windows 11 64 位客户端。 接下来,它使用该对象创建任务序列步骤条件对象。
然后,它使用 Set-CMTSStepSetDynamicVariable cmdlet 将此条件对象添加到默认 OS 部署任务序列的“设置动态变量”步骤。
$osPlat = Get-CMSupportedPlatform -Name "*Windows 1? (64-bit) Client" -Fast
$condition = New-CMTSStepConditionOperatingSystem -SupportedPlatform $osPlat
$tsNameOsd = "Default OS deployment"
$tsStepNameDynVar = "Set Dynamic Variables"
Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameDynVar -AddCondition $condition
此示例脚本在步骤中创建以下条件:
Operating System equals All Windows 10 (64-bit) Or All Windows 11 (64-bit)
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SupportedPlatform
为此条件指定一个或多个受支持的平台对象。 若要获取此对象,请使用 Get-CMSupportedPlatform cmdlet。
类型: | IResultObject[] |
别名: | SupportedPlatforms |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
IResultObject
备注
有关此返回对象及其属性的详细信息,请参阅 SMS_TaskSequence_OSConditionGroup服务器 WMI 类。
若要创建 OS 语言条件,请使用 New-CMTSStepConditionOperatingSystemLanguage cmdlet。