Get-CMConfigurationPlatform

获取要求规则的操作系统平台。

语法

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 可获取要与应用程序部署类型的操作系统要求规则一同使用的操作系统平台。 可以将此 cmdlet 的输出对象与 New-CMRequirementRuleOperatingSystemValue cmdlet 一同使用。

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\> 。 有关详细信息,请参阅 入门

示例

示例 1:按平台添加操作系统的要求规则

此示例首先使用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 结合使用

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Fast

添加此参数不自动刷新延迟属性。 延迟属性包含检索效率相对低的值。 获取这些属性可能会导致额外的网络流量并减少 cmdlet 性能。

如果不使用此参数,该 cmdlet 将显示一条警告。 若要禁用此警告,请设置 $CMPSSuppressFastNotUsedCheck = $true

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

-Id

指定平台的 CI_ID整数值 。 例如,CI_ID **** All Windows Server 2019和更高版本的 64 (的) 为 287650

使用与以下内容类似的命令来发现CI_ID应用:

Get-CMConfigurationPlatform -Name "*Server 2019*" | Select-Object LocalizedDisplayName, CI_ID

Type:Int32
Aliases:CI_ID
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IsSupported

Configuration Manager 仍定义旧平台实现向后兼容。 设置此参数 $true 以仅筛选当前支持的平台的结果。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PlatformOption

使用此参数按平台类型筛选结果。

Type:PlatformType
Accepted values:None, Windows, Mobile, Mac, MixedPlatform
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-名称

指定操作系统平台的名称。 可以使用通配符:

  • *:多个字符
  • ?:单个字符
Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

输入

输出

IResultObject[]

IResultObject

备注

有关此返回对象及其属性的信息,请参阅SMS_ConfigurationPlatform WMI 类

此 cmdlet 不同于类似的 Get-CMSupportedPlatform cmdlet。