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>] 説明
このコマンドレットを使用して、アプリケーションの展開の種類の OS 要件規則で使用する OS プラットフォームを取得します。 このコマンドレットの出力オブジェクトは、 New-CMRequirementRuleOperatingSystemValue コマンドレットで使用できます。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: プラットフォーム別に OS の要件規則を追加する
この例では、最初に Get-CMGlobalCondition コマンドレットを使用して、モバイル以外の Windows デバイスの既定の オペレーティング システム のグローバル条件を取得します。 次に、Windows Server 2016 と Windows Server 2019 の 2 つのプラットフォームの変数を定義します。 次に、 New-CMRequirementRuleOperatingSystemValue コマンドレットを使用して、これら 2 つのプラットフォームを含める要件ルール オブジェクトを作成します。 最後に、その規則オブジェクトを Set-CMScriptDeploymentType コマンドレットに渡して、要件を追加します。
$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 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Fast
このパラメーターを追加して、遅延プロパティを自動的に更新しないようにします。 遅延プロパティには、取得するのが比較的非効率的な値が含まれています。 これらのプロパティを取得すると、追加のネットワーク トラフィックが発生し、コマンドレットのパフォーマンスが低下する可能性があります。
このパラメーターを使用しない場合、コマンドレットに警告が表示されます。 この警告を無効にするには、 $CMPSSuppressFastNotUsedCheck = $trueを設定します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | 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 |
| Aliases: | CI_ID |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IsSupported
Configuration Manager では、下位互換性のためにレガシ プラットフォームが引き続き定義されています。 現在サポートされているプラットフォームのみに結果をフィルター処理するには、このパラメーターを $true に設定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
OS プラットフォームの名前を指定します。 ワイルドカード文字を使用できます。
-
*: 複数の文字 -
?: 1 文字
| 型: | String |
| Aliases: | LocalizedDisplayName |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PlatformOption
プラットフォームの種類で結果をフィルター処理するには、このパラメーターを使用します。
| 型: | PlatformType |
| 指定可能な値: | None, Windows, Mobile, Mac, MixedPlatform |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject[]
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_ConfigurationPlatform」を参照してください。
このコマンドレットは、同様の Get-CMSupportedPlatform コマンドレットとは異なります。