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>]

説明

このコマンドレットを使用して、アプリケーションの展開の種類の 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 コマンドレットとは異なります。