New-CMRequirementRuleOperatingSystemValue

  • リファレンス
モジュール:
ConfigurationManager

アプリケーションの展開の種類の OS 要件ルールを作成します。

構文

New-CMRequirementRuleOperatingSystemValue
   [-Platform <IResultObject[]>]
   [-PlatformString <String[]>]
   -RuleOperator <RuleExpressionOperator>
   [-SelectFullPlatform <FullPlatformOption>]
   [-InputObject] <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

このコマンドレットを使用して、アプリケーションの展開の種類の OS 要件規則を作成します。

このコマンドレットを使用した後、展開の種類に 対して Add またはSet- のいずれかのコマンドレットを使用します。 この要件ルール オブジェクトを AddRequirement パラメーターまたは RemoveRequirement パラメーターに渡します。

詳細については、「 展開の種類の要件 」および「 グローバル条件の作成」を参照してください。

注:

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

例

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

この例では、最初に Get-CMGlobalCondition コマンドレットを使用して、モバイル以外の Windows デバイスの既定の オペレーティング システム のグローバル条件を取得します。 次に、Get-CMConfigurationPlatform コマンドレットを使用して、Windows Server 2016 と Windows Server 2019 の 2 つのプラットフォームの変数を定義します。 次に、これら 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)" -Fast

$platformB = Get-CMConfigurationPlatform -Name "All Windows Server 2016 and higher (64-bit)" -Fast

$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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-InputObject

この要件ルールの基礎として使用するグローバル条件オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMGlobalCondition コマンドレットを 使用します。

ほとんどの場合、モバイル以外の Windows デバイスでは既定の オペレーティング システム のグローバル条件を使用します。 (例: Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1)。

注:

既定では、Configuration Managerにはオペレーティング システムという名前の 2 つのグローバル条件があります。 PlatformType プロパティを使用して、デバイスの種類で区別できます。

PlatformType デバイスのタイプ
1 Windows
2 Mobile
Type:IResultObject
Aliases:GlobalCondition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Platform

1 つ以上の OS プラットフォーム オブジェクトの配列を指定します。 このオブジェクトを取得するには、 Get-CMConfigurationPlatform コマンドレットを 使用します。

Type:IResultObject[]
Aliases:Platforms
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PlatformString

Platform パラメーターで Get-CMConfigurationPlatform コマンドレットを使用する代わりに、このパラメーターを使用して、1 つ以上の既知の ModelName 文字列の配列を指定できます。 たとえば、プラットフォーム All Windows 11 以降 (64 ビット) の ModelName は ですWindows/All_x64_Windows_11_and_higher_Clients。

プラットフォームのモデル名を検出するには、次のようなコマンドを使用します。

Get-CMConfigurationPlatform -Name "*Server 2019*" -Fast | Select-Object LocalizedDisplayName, ModelName

Type:String[]
Aliases:PlatformStrings, PlatformCIUniqueID, PlatformCIUniqueIDs
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RuleOperator

オペレーターを指定して、デバイスの設定と予期される値を比較します。

Type:RuleExpressionOperator
Accepted values:OneOf, NoneOf
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SelectFullPlatform

指定した型のすべてのプラットフォームを選択するには、このパラメーターを使用します。

Type:FullPlatformOption
Accepted values:Windows, Nokia, WindowsMobile, IOs, IOsDeepLink, Android, AndroidDeepLink, Mac, WinPhone8, WinPhone8DeepLink, MobileMsi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object