共用方式為

Get-CMConfigurationPlatform

  • 參考
模組:
ConfigurationManager

取得需求規則的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>]

Description

使用此 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 不同。