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 $clauseParâ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