Compartir a través de

New-CMDetectionClauseWindowsInstaller

  • Referencia
Módulo:
ConfigurationManager

Cree una cláusula de método de detección para un código de producto MSI.

Sintaxis

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

Description

Use este cmdlet para crear una cláusula en un método de detección en una aplicación. Esta cláusula es una regla para un código de producto de Windows Installer (MSI) que indica la presencia de una aplicación.

Después de usar este cmdlet, use uno de los cmdlets Add- o Set- para los tipos de implementación. Pase este objeto de cláusula de detección a los parámetros AddDetectionClause o RemoveDetectionClause .

Para agrupar cláusulas de detección, use el parámetro GroupDetectionClauses en los cmdlets de tipo de implementación.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Detección de la existencia de un código de producto MSI

En este ejemplo se agrega el código de producto MSI de la consola de Configuration Manager al tipo de implementación.

$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 los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Existence

Al agregar este parámetro, el código del producto MSI debe existir en el sistema de destino para indicar la presencia de esta aplicación.

En lugar de solo existencia, para evaluar también una condición de versión, use el parámetro Value .

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExpectedValue

Cuando agregue el parámetro Value , use ExpectedValue con PropertyType y ExpressionOperator. Cuando se usan estos parámetros, la versión de MSI debe cumplir la regla para indicar la presencia de esta aplicación. Este parámetro ExpectedValue especifica el valor que se va a comparar con el dispositivo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExpressionOperator

Al agregar el parámetro Value , use ExpressionOperator con PropertyType y ExpectedValue. Cuando se usan estos parámetros, la versión de MSI debe cumplir la regla para indicar la presencia de esta aplicación. Este parámetro ExpressionOperator especifica el operador para comparar el valor del dispositivo con el valor esperado.

A partir de la versión 2010, el tipo de parámetro cambió de RuleExpressionOperator a WindowsInstallerRuleExpressionOperator.

Tipo:WindowsInstallerRuleExpressionOperator
Valores aceptados:IsEquals, NotEquals, GreaterThan, LessThan, GreaterEquals, LessEquals
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProductCode

Especifique el código de producto de Windows Installer que indica la presencia de esta aplicación. El formato es un GUID, por ejemplo 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PropertyType

Al agregar el parámetro Value , use PropertyType con ExpressionOperator y ExpectedValue. Cuando se usan estos parámetros, la versión de MSI debe cumplir la regla para indicar la presencia de esta aplicación.

Actualmente, este parámetro PropertyType solo admite un único valor, ProductVersion.

Tipo:MSIProperty
Valores aceptados:ProductVersion
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Value

Al agregar el parámetro Value , junto con el código del producto, la versión de MSI también debe cumplir la regla para indicar la presencia de esta aplicación. Use este parámetro con los parámetros siguientes: ExpectedValue, ExpressionOperator y PropertyType.

En lugar de evaluar una regla, para comprobar el código del producto MSI, use el parámetro Existence .

Tipo:SwitchParameter
Alias:ValueRule
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Object