Compartilhar via


New-CMDetectionClauseWindowsInstaller

Crie uma cláusula de método de deteçã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

Utilize este cmdlet para criar uma cláusula num método de deteção numa aplicação. Esta cláusula é uma regra para um código de produto do Windows Installer (MSI) que indica a presença de uma aplicação.

Depois de utilizar este cmdlet, utilize um dos cmdlets Add- ou Set- para tipos de implementação. Transmita este objeto de cláusula de deteção para os parâmetros AddDetectionClause ou RemoveDetectionClause .

Para agrupar cláusulas de deteção, utilize o parâmetro GroupDetectionClauses nos cmdlets do tipo de implementação.

Observação

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

Exemplos

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

Este exemplo adiciona o código de produto MSI da consola do Configuration Manager ao tipo de implementação.

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

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

Parâmetros

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. 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 adiciona este parâmetro, o código de produto MSI tem de existir no sistema de destino para indicar a presença desta aplicação.

Em vez de existir apenas, para avaliar também uma condição de versão, utilize 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

Quando adicionar o parâmetro Value , utilize ExpectedValue com PropertyType e ExpressionOperator. Quando utiliza estes parâmetros, a versão MSI tem de satisfazer a regra para indicar a presença desta aplicação. Este parâmetro ExpectedValue especifica o valor a comparar 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

Quando adicionar o parâmetro Value , utilize ExpressionOperator com PropertyType e ExpectedValue. Quando utiliza estes parâmetros, a versão MSI tem de satisfazer a regra para indicar a presença desta aplicação. 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

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 desta aplicação. 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

Quando adicionar o parâmetro Value , utilize PropertyType com ExpressionOperator e ExpectedValue. Quando utiliza estes parâmetros, a versão MSI tem de satisfazer a regra para indicar a presença desta aplicação.

Atualmente, este parâmetro PropertyType só suporta 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 adiciona o parâmetro Valor , juntamente com o código do produto, a versão do MSI também tem de satisfazer a regra para indicar a presença desta aplicação. Utilize este parâmetro com os seguintes parâmetros: ExpectedValue, ExpressionOperator e PropertyType.

Em vez de avaliar uma regra, para verificar apenas o código do produto MSI, utilize o parâmetro Existência .

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