次の方法で共有

New-CMTSStepConditionSoftware

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

タスク シーケンス ステップ のインストール済みソフトウェア 条件を作成します。

構文

New-CMTSStepConditionSoftware
   [-IsAnyVersion <Boolean>]
   -MsiFilePath <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、タスク シーケンス ステップ用 にインストールされているソフトウェア 条件オブジェクトを作成します。 次に、Condition パラメーターまたは AddCondition パラメーターを使用して、New-CMTSStep* コマンドレットまたは Set-CMTSStep* コマンドレットのいずれかを使用します。 たとえば、 Set-CMTSStepApplyDataImage です。

詳細については、「 タスク シーケンス エディターの使用: 条件」を参照してください。

注:

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

例

例 1

この例では、最初に、Configuration Manager コンソール MSI の条件オブジェクトを作成します。

次に、Set-CMTSStepRunPowerShellScript コマンドレットを使用して、この条件オブジェクトを既定の OS 展開タスク シーケンスの PowerShell スクリプトの実行ステップに追加します。

$msi = "\\cm01.contoso.com\SMS_XYZ\bin\i386\adminconsole.msi"

$condition = New-CMTSStepConditionSoftware -MsiFilePath $msi -IsAnyVersion $true

$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"

Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $condition

このサンプル スクリプトは、この手順で次の条件を作成します。

Software An version of "Microsoft Endpoint Configuration Manager Console" installed

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

-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

-IsAnyVersion

このパラメーターを使用して、条件が MSI コードと一致する方法を判断します。

  • $true: この製品の任意のバージョンに一致する MSI アップグレード コード のみ
  • $false: この特定の製品、MSI 製品コード、アップグレード コードに一致する

このパラメーターを指定しない場合、既定では特定の製品と一致します。

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

-MsiFilePath

評価する MSI ファイルへのパスを指定します。 コマンドレットは、この MSI から製品の詳細を読み取ります。 MSI へのパスは保存されません。製品の詳細だけが保存されます。

たとえば、Configuration Manager バージョン 2107AdminConsole.msiの次の詳細が保存されます。

  • ProductCode: {B3842C82-95EB-472C-940A-D82C4A10857D}
  • ProductName: Microsoft エンドポイント Configuration Manager コンソール
  • UpgradeCode: {B038D5E8-6C93-4A05-9E21-240324CFDF0E}
  • Version: 5.2107.1059.1000
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

None

出力

IResultObject

メモ

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