Get-CMConfigurationPlatform
获取要求规则的 OS 平台。
语法
Get-CMConfigurationPlatform
[-Fast]
[-IsSupported <Boolean>]
[[-Name] <String>]
[-PlatformOption <PlatformType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMConfigurationPlatform
[-Fast]
[-Id] <Int32>
[-IsSupported <Boolean>]
[-PlatformOption <PlatformType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] 说明
使用此 cmdlet 获取与应用程序部署类型的 OS 要求规则一起使用的 OS 平台。 可以将此 cmdlet 的输出对象与 New-CMRequirementRuleOperatingSystemValue cmdlet 配合使用。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：按平台添加 OS 的要求规则
此示例首先使用 Get-CMGlobalCondition cmdlet 获取非移动 Windows 设备的默认 操作系统 全局条件。 然后，它为 Windows Server 2016 和 Windows Server 2019 的两个平台定义变量。 接下来，它使用 New-CMRequirementRuleOperatingSystemValue cmdlet 创建要求规则对象以包含这两个平台。 最后，它将该规则对象传递给 Set-CMScriptDeploymentType cmdlet 以添加要求。
$myGC = Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1
$platformA = Get-CMConfigurationPlatform -Name "All Windows Server 2019 and higher (64-bit)"
$platformB = Get-CMConfigurationPlatform -Name "All Windows Server 2016 and higher (64-bit)"
$myRule = $myGC | New-CMRequirementRuleOperatingSystemValue -RuleOperator OneOf -Platform $platformA, $platformB
Set-CMScriptDeploymentType -ApplicationName "Central App" -DeploymentTypeName "Install" -AddRequirement $myRule参数
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Fast
添加此参数以不自动刷新延迟属性。 延迟属性包含检索效率相对较低的值。 获取这些属性可能会导致额外的网络流量并降低 cmdlet 性能。
如果不使用此参数，cmdlet 将显示警告。 若要禁用此警告，请设置 $CMPSSuppressFastNotUsedCheck = $true。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Id
指定平台 CI_ID 的整数值。 例如，平台“所有 Windows Server 2019 及更高版本” (64 位) CI_ID为 287650。
使用类似于以下内容的命令来发现平台的CI_ID：
Get-CMConfigurationPlatform -Name "*Server 2019*" | Select-Object LocalizedDisplayName, CI_ID
| 类型: | Int32 |
| 别名: | CI_ID |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-IsSupported
Configuration Manager 仍定义旧平台以实现向后兼容性。 将此参数设置为 $true 以将结果筛选为仅当前支持的平台。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定 OS 平台的名称。 可以使用通配符：
-
*：多个字符 -
?：单个字符
| 类型: | String |
| 别名: | LocalizedDisplayName |
| Position: | 0 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PlatformOption
使用此参数可按平台类型筛选结果。
| 类型: | PlatformType |
| 接受的值: | None, Windows, Mobile, Mac, MixedPlatform |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
IResultObject[]
IResultObject
备注
有关此返回对象及其属性的详细信息，请参阅 SMS_ConfigurationPlatform服务器 WMI 类。
此 cmdlet 不同于类似的 Get-CMSupportedPlatform cmdlet。