Compartilhar via

New-CMDetectionClauseWindowsInstaller

  • Referência
Módulo:
ConfigurationManager

Crie uma cláusula de método de detecção para um código de produto MSI.

Sintaxe

New-CMDetectionClauseWindowsInstaller
   -ExpectedValue <String>
   -ExpressionOperator <WindowsInstallerRuleExpressionOperator>
   -ProductCode <Guid>
   [-PropertyType <MSIProperty>]
   [-Value]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
New-CMDetectionClauseWindowsInstaller
   -ProductCode <Guid>
   [-Existence]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use esse cmdlet para criar uma cláusula em um método de detecção em um aplicativo. Essa cláusula é uma regra para um código de produto MSI (Windows Installer) que indica a presença de um aplicativo.

Depois de usar esse cmdlet, use um dos cmdlets Adicionar ou Definir para tipos de implantação. Passe esse objeto de cláusula de detecção para os parâmetros AddDetectionClause ou RemoveDetectionClause .

Para agrupar cláusulas de detecção, use o parâmetro GroupDetectionClauses nos cmdlets de tipo de implantação.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: detectar a existência de um código de produto MSI

Este exemplo adiciona o código de produto MSI do console Configuration Manager ao tipo de implantação.

$clause = New-CMDetectionClauseWindowsInstaller -Existence -ProductCode 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Existence

Quando você adiciona esse parâmetro, o código do produto MSI deve existir no sistema de destino para indicar a presença desse aplicativo.

Em vez de apenas existir, para avaliar também uma condição de versão, use o parâmetro Valor .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExpectedValue

Ao adicionar o parâmetro Valor , use ExpectedValue com PropertyType e ExpressionOperator. Quando você usa esses parâmetros, a versão MSI deve atender à regra para indicar a presença deste aplicativo. Este parâmetro ExpectedValue especifica o valor a ser comparado com o dispositivo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExpressionOperator

Ao adicionar o parâmetro Valor , use ExpressionOperator com PropertyType e ExpectedValue. Quando você usa esses parâmetros, a versão MSI deve atender à regra para indicar a presença deste aplicativo. Este parâmetro ExpressionOperator especifica o operador para comparar o valor do dispositivo com o valor esperado.

A partir da versão 2010, o tipo de parâmetro mudou de RuleExpressionOperator para WindowsInstallerRuleExpressionOperator.

Tipo:WindowsInstallerRuleExpressionOperator
Valores aceitos:IsEquals, NotEquals, GreaterThan, LessThan, GreaterEquals, LessEquals
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProductCode

Especifique o código de produto do Windows Installer que indica a presença deste aplicativo. O formato é um GUID, por exemplo 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PropertyType

Ao adicionar o parâmetro Valor , use PropertyType com ExpressionOperator e ExpectedValue. Quando você usa esses parâmetros, a versão MSI deve atender à regra para indicar a presença deste aplicativo.

Este parâmetro PropertyType atualmente só dá suporte a um único valor, ProductVersion.

Tipo:MSIProperty
Valores aceitos:ProductVersion
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Value

Quando você adiciona o parâmetro Value , juntamente com o código do produto, a versão MSI também deve atender à regra para indicar a presença desse aplicativo. Use esse parâmetro com os seguintes parâmetros: ExpectedValue, ExpressionOperator e PropertyType.

Em vez de avaliar uma regra, para apenas verificar o código do produto MSI, use o parâmetro Existence .

Tipo:SwitchParameter
Aliases:ValueRule
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object