New-CMDetectionClauseDirectory
Cree una cláusula de método de detección para un directorio del sistema de archivos.
Sintaxis
New-CMDetectionClauseDirectory
-DirectoryName <String>
-PropertyType <FileFolderProperty>
-ExpectedValue <String[]>
-ExpressionOperator <FileFolderRuleExpressionOperator>
[-Is64Bit]
-Path <String>
[-Value]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] New-CMDetectionClauseDirectory
-DirectoryName <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 una carpeta del sistema de archivos que indica la presencia de una aplicación.
Para detectar un archivo en lugar de una carpeta, use el cmdlet New-CMDetectionClauseFile .
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: Agregar un método de detección de existencias
En este ejemplo se agrega una cláusula de detección que requiere que exista un identificador de producto y un nombre de directorio específicos.
$app = Get-CMApplication -ApplicationName "CentralApp"
$guid = "9900a338-484b-4a18-884e-bce87654ce1b"
$clause1 = New-CMDetectionClauseWindowsInstaller -ProductCode $guid -Value -ExpressionOperator IsEquals -ExpectedValue "1.1.1.1"
$clause2 = New-CMDetectionClauseDirectory -DirectoryName "mymsi" -Path "C:\" -Existence
$app | Add-CMMsiDeploymentType -ContentLocation "\\myserver\mypath\mymsi.msi" -Force -AddDetectionClause ($clause1, $clause2)Ejemplo 2: Adición de un método de detección de evaluación de reglas
En este ejemplo se agrega una cláusula de detección basada en reglas para comprobar que la carpeta se modificó después del 12/30/2020.
$clause1 = New-CMDetectionClauseDirectory -DirectoryName "AdminConsole" -Path "%ProgramFiles(x86)%\Microsoft Endpoint Manager" -Value -PropertyType DateCreated -ExpressionOperator GreaterThan -ExpectedValue "2020-11-30T08:00:00Z"
Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1Parámetros
-DirectoryName
Especifique el nombre de la carpeta que indica la presencia de la aplicación. Use el parámetro Path para especificar la ruta de acceso a esta carpeta.
Por ejemplo, la consola de Configuration Manager se instala de forma predeterminada en C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole. Para crear una regla para esta carpeta, establezca este parámetro AdminConsole en y el parámetro Path en %ProgramFiles(x86)%\Microsoft Endpoint Manager.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-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, la carpeta 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 esta carpeta, 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 carpeta 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 parámetro PropertyType de esta cláusula solo acepta la fecha en que se creó o modificó la carpeta, por lo que este valor es una cadena con una fecha y hora válida. Por ejemplo, "2020-11-30T08:00:00Z".
| 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 carpeta 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 |
-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 esta carpeta está asociada 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 a la carpeta que indica la presencia de la aplicación. Use el parámetro DirectoryName para especificar el nombre de la carpeta.
Por ejemplo, la consola de Configuration Manager se instala de forma predeterminada en C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole. Para crear una regla para esta carpeta, establezca este parámetro %ProgramFiles(x86)%\Microsoft Endpoint Manager en y el parámetro DirectoryName en AdminConsole.
| 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, la carpeta debe cumplir la regla para indicar la presencia de esta aplicación. Este parámetro PropertyType especifica la propiedad folder que se va a evaluar.
| Tipo: | FileFolderProperty |
| Valores aceptados: | DateCreated, DateModified |
| 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 , la carpeta 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 la carpeta 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