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>] 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 不同。