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コマンドレットでは、このコマンドレットの出力オブジェクトを使用できます。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください

例 1: プラットフォーム別に OS の要件ルールを追加する

この例では、まず Get-CMGlobalConditionコマンドレットを使用**** して、モバイル以外のデバイスの既定のオペレーティング システムグローバル条件Windowsします。 次に、サーバー 2019 とサーバー 2019 のWindows Server 2016プラットフォームWindows定義します。 次に 、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 と組み合わせは使用できない

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

遅延プロパティを自動的に更新しない場合は、このパラメーターを追加します。 遅延プロパティには、取得に比較的非効率な値が含まれます。 これらのプロパティを取得すると、追加のネットワーク トラフィックが発生し、コマンドレットのパフォーマンスが低下する可能性があります。

このパラメーターを使用しない場合、コマンドレットは警告を表示します。 この警告を無効にするには、 を設定します $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****サーバー 2019 Windows (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
-Name

OS プラットフォームの名前を指定します。 ワイルドカード文字を使用できます。

  • *: 複数の文字
  • ?: 1 文字
Type:String
Aliases:LocalizedDisplayName
Position:0
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

入力

なし

出力

IResultObject[]

IResultObject

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_ConfigurationPlatform WMI クラス」を参照してください

このコマンドレットは、同様の Get-CMSupportedPlatform コマンドレットとは異 なります。