New-CMDetectionClauseWindowsInstaller
MSI 製品コードの検出方法句を作成します。
構文
New-CMDetectionClauseWindowsInstaller
-ExpectedValue <String>
-ExpressionOperator <WindowsInstallerRuleExpressionOperator>
-ProductCode <Guid>
[-PropertyType <MSIProperty>]
[-Value]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] New-CMDetectionClauseWindowsInstaller
-ProductCode <Guid>
[-Existence]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] 説明
アプリケーションの検出方法で句を作成するには、このコマンドレットを使用します。 この句は、アプリケーションの存在を示す Windows インストーラー (MSI) 製品コードの規則です。
このコマンドレットを使用した後、展開の種類に 対して Add またはSet- のいずれかのコマンドレットを使用します。 この検出句オブジェクトを AddDetectionClause パラメーターまたは RemoveDetectionClause パラメーターに渡します。
検出句をグループ化するには、デプロイの種類のコマンドレットで GroupDetectionClauses パラメーターを使用します。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: MSI 製品コードの存在を検出する
この例では、Configuration Manager コンソール MSI 製品コードを展開の種類に追加します。
$clause = New-CMDetectionClauseWindowsInstaller -Existence -ProductCode 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD
Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clauseパラメーター
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Existence
このパラメーターを追加するときは、このアプリケーションの存在を示すために、MSI 製品コードがターゲット システムに存在している必要があります。
存在するだけではなく、バージョン条件も評価するには、 Value パラメーターを使用します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ExpectedValue
Value パラメーターを追加するときは、PropertyType と ExpressionOperator で ExpectedValue を使用します。 これらのパラメーターを使用する場合、MSI バージョンは、このアプリケーションの存在を示す規則を満たす必要があります。 この ExpectedValue パラメーターは、デバイスと比較する値を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ExpressionOperator
Value パラメーターを追加するときは、PropertyType と ExpectedValue で ExpressionOperator を使用します。 これらのパラメーターを使用する場合、MSI バージョンは、このアプリケーションの存在を示す規則を満たす必要があります。 この ExpressionOperator パラメーターは、デバイスの値と予期される値を比較する演算子を指定します。
バージョン 2010 以降、パラメーターの種類が RuleExpressionOperator から WindowsInstallerRuleExpressionOperator に変更されました。
| 型: | WindowsInstallerRuleExpressionOperator |
| 指定可能な値: | IsEquals, NotEquals, GreaterThan, LessThan, GreaterEquals, LessEquals |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProductCode
このアプリケーションの存在を示す Windows インストーラー製品コードを指定します。 形式は GUID です (例: 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD)。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PropertyType
Value パラメーターを追加するときは、ExpressionOperator と ExpectedValue で PropertyType を使用します。 これらのパラメーターを使用する場合、MSI バージョンは、このアプリケーションの存在を示す規則を満たす必要があります。
この PropertyType パラメーターは現在、1 つの値 ( ProductVersion) のみをサポートしています。
| 型: | MSIProperty |
| 指定可能な値: | ProductVersion |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Value
Value パラメーターを製品コードと共に追加する場合、MSI バージョンも、このアプリケーションの存在を示す規則を満たす必要があります。 このパラメーターは、 ExpectedValue、 ExpressionOperator、 PropertyType の各パラメーターと共に使用します。
ルールを評価する代わりに、MSI 製品コードだけを確認するには、 Existence パラメーターを使用します。
| 型: | SwitchParameter |
| Aliases: | ValueRule |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object