Compartir a través de

New-CMDetectionClauseFile

  • Referencia
Módulo:
ConfigurationManager

Cree una cláusula de método de detección para un archivo.

Sintaxis

New-CMDetectionClauseFile
   -FileName <String>
   -PropertyType <FileFolderProperty>
   -ExpectedValue <String[]>
   -ExpressionOperator <FileFolderRuleExpressionOperator>
   [-Is64Bit]
   -Path <String>
   [-Value]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
New-CMDetectionClauseFile
   -FileName <String>
   [-Is64Bit]
   -Path <String>
   [-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 archivo que indica la presencia de una aplicación.

Para detectar una carpeta en lugar de un archivo, use el cmdlet New-CMDetectionClauseDirectory .

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 una aplicación por versión

En este ejemplo se detecta la app.exe de la aplicación en una carpeta específica donde la versión es mayor o igual que 1.0.0.

$clause = New-CMDetectionClauseFile -Path "C:\Program Files\Application" -FileName App.exe -Value -PropertyType Version -ExpressionOperator GreaterEquals -ExpectedValue "1.0.0"

Set-CMScriptDeploymentType -ApplicationName "CentralApp" -DeploymentTypeName "Scripted install" -AddDetectionClause $clause

Ejemplo 2: Creación de varias cláusulas para un tipo de implementación de aplicación MSI

En este ejemplo se crean dos cláusulas de archivo y una cláusula del Registro y, a continuación, se usan para agregar un tipo de implementación MSI a una aplicación.

$cla1=New-CMDetectionClauseFile -FileName "filetest" -PropertyType Size -ExpectedValue 123 -ExpressionOperator IsEquals -Path "C:\" -Value -Is64Bit
$cla2=New-CMDetectionClauseFile -FileName "foldertest" -PropertyType DateCreated -ExpectedValue (Get-Date) -ExpressionOperator LessThan -Path "C:\" -Value
$cla3=New-CMDetectionClauseRegistryKey -Hive ClassesRoot -KeyName "aaa"
$logic1=$cla1.Setting.LogicalName
$logic2=$cla2.Setting.LogicalName
$logic3=$cla3.Setting.LogicalName

Add-CMMsiDeploymentType -AddDetectionClause $cla1,$cla2,$cla3 -ApplicationName "app" -DeploymentTypeName "dt" -InstallCommand "mycommand" -ContentLocation "\\server\sources\Orca.msi" -GroupDetectionClauses $logic1,$logic2 -DetectionClauseConnector {LogicalName=$logic2;Connector="or"},{LogicalName=$logic3;Connector="or"}

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 archivo debe existir en el sistema de destino para indicar la presencia de esta aplicación.

En lugar de solo existencia, para evaluar una regla para las propiedades de este archivo, 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, el archivo 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 sistema de archivos.

El valor que se va a comparar depende del PropertyType especificado.

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, el archivo debe cumplir la regla para indicar la presencia de esta aplicación. Este parámetro ExpressionOperator especifica el operador para comparar el valor del sistema de archivos con el valor esperado.

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

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

-FileName

Especifique el nombre del archivo que indica la presencia de la aplicación. Use el parámetro Path para especificar la ruta de acceso a este archivo.

Por ejemplo, la consola de Configuration Manager se instala de forma predeterminada en C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe. Para crear una regla para este archivo, establezca este parámetro Microsoft.ConfigurationManagement.exe en y el parámetro Path en %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin.

Tipo:String
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

-Is64Bit

Agregue este parámetro para indicar que este archivo está asociado a una aplicación de 32 bits en sistemas de 64 bits.

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

-Path

Especifique la ruta de acceso del sistema de archivos al archivo que indica la presencia de la aplicación. Use el parámetro FileName para especificar el nombre del archivo.

Por ejemplo, la consola de Configuration Manager se instala de forma predeterminada en C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe. Para crear una regla para este archivo, establezca este parámetro %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin en y el parámetro FileName en Microsoft.ConfigurationManagement.exe.

Tipo:String
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, el archivo debe cumplir la regla para indicar la presencia de esta aplicación. Este parámetro PropertyType especifica la propiedad de archivo que se va a evaluar.

Por ejemplo, establezca este parámetro en Version, establezca ExpressionOperatorIsEqualsen y ExpectedValue en 1.48.1.0. A continuación, la regla comprueba el archivo especificado para que tenga la misma versión de archivo.

Tipo:FileFolderProperty
Valores aceptados:DateCreated, DateModified, Version, Size
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Value

Al agregar el parámetro Value , el archivo 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 que el archivo existe, 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