Crie uma cláusula de método de detecção para um arquivo.
\n","uid":"ConfigurationManager.New-CMDetectionClauseFile"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMDetectionClauseFile":{"href":"new-cmdetectionclausefile","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMDetectionClauseFile","schemaType":"PowershellCmdlet","summary":"Crie uma cláusula de método de detecção para um arquivo.
\n","uid":"ConfigurationManager.New-CMDetectionClauseFile"}},"description":"Use este cmdlet para criar uma cláusula em um método de detecção em um aplicativo. Essa cláusula é uma regra para um arquivo que indica a presença de um aplicativo.
\nPara detectar uma pasta em vez de um arquivo, use o cmdlet New-CMDetectionClauseDirectory .
\nDepois de usar esse cmdlet, use um dos cmdlets Add ou Set para os tipos de implantação. Passe esse objeto de cláusula de detecção para os parâmetros AddDetectionClause ou RemoveDetectionClause .
\nPara agrupar cláusulas de detecção, use o parâmetro GroupDetectionClauses nos cmdlets do tipo de implantação.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
Este exemplo detecta o app.exe de aplicativo em uma pasta específica onde a versão é maior ou igual a 1.0.0.
Este exemplo cria duas cláusulas de arquivo e uma cláusula do Registro e, em seguida, as usa para adicionar um tipo de implantação MSI a um aplicativo.
\n","title":"Exemplo 2: Criar várias cláusulas para um tipo de implantação de aplicativo MSI"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"new-cmdetectionclausedirectory","text":"New-CMDetectionClauseDirectory"},{"href":"new-cmdetectionclauseregistrykey","text":"New-CMDetectionClauseRegistryKey"},{"href":"new-cmdetectionclauseregistrykeyvalue","text":"New-CMDetectionClauseRegistryKeyValue"},{"href":"new-cmdetectionclausewindowsinstaller","text":"New-CMDetectionClauseWindowsInstaller"}],"module":"ConfigurationManager","name":"New-CMDetectionClauseFile","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Quando você adiciona esse parâmetro, o arquivo deve existir no sistema de destino para indicar a presença desse aplicativo.
\nEm vez de apenas existência, para avaliar uma regra para propriedades desse arquivo, use o parâmetro Valor .
\n","isRequired":true,"name":"Existence","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Ao adicionar o parâmetro Value , use ExpectedValue com PropertyType e ExpressionOperator. Quando você usa esses parâmetros, o arquivo deve atender à regra para indicar a presença desse aplicativo. Esse parâmetro ExpectedValue especifica o valor a ser comparado com o sistema de arquivos.
\nO valor a ser comparado depende do PropertyType especificado.
\n","isRequired":true,"name":"ExpectedValue","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"","defaultValue":"None","description":"Ao adicionar o parâmetro Value , use ExpressionOperator com PropertyType e ExpectedValue. Quando você usa esses parâmetros, o arquivo deve atender à regra para indicar a presença desse aplicativo. Esse parâmetro ExpressionOperator especifica o operador para comparar o valor do sistema de arquivos com o valor esperado.
\nA partir da versão 2010, o tipo de parâmetro mudou de RuleExpressionOperator para FileFolderRuleExpressionOperator.
\n","isRequired":true,"name":"ExpressionOperator","parameterValueGroup":"IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf","position":"Named","type":"FileFolderRuleExpressionOperator\n"},{"aliases":"","defaultValue":"None","description":"Especifique o nome do arquivo que indica a presença do aplicativo. Use o parâmetro Path para especificar o caminho para esse arquivo.
\nPor exemplo, o console do Configuration Manager é instalado, por padrão, no C:\\Program Files (x86)\\Microsoft Endpoint Manager\\AdminConsole\\bin\\Microsoft.ConfigurationManagement.exeformato . Para criar uma regra para esse arquivo, defina esse parâmetro como Microsoft.ConfigurationManagement.exe e o parâmetro Path como %ProgramFiles(x86)%\\Microsoft Endpoint Manager\\AdminConsole\\bin.
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Adicione esse parâmetro para indicar que esse arquivo está associado a um aplicativo de 32 bits em sistemas de 64 bits.
\n","name":"Is64Bit","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique o caminho no sistema de arquivos para o arquivo que indica a presença do aplicativo. Use o parâmetro FileName para especificar o nome do arquivo.
\nPor exemplo, o console do Configuration Manager é instalado, por padrão, no C:\\Program Files (x86)\\Microsoft Endpoint Manager\\AdminConsole\\bin\\Microsoft.ConfigurationManagement.exeformato . Para criar uma regra para esse arquivo, defina esse parâmetro como %ProgramFiles(x86)%\\Microsoft Endpoint Manager\\AdminConsole\\bin e o parâmetro FileName como Microsoft.ConfigurationManagement.exe.
Ao adicionar o parâmetro Value , use PropertyType com ExpressionOperator e ExpectedValue. Quando você usa esses parâmetros, o arquivo deve atender à regra para indicar a presença desse aplicativo. Esse parâmetro PropertyType especifica a propriedade do arquivo a ser avaliada.
\nPor exemplo, você define esse parâmetro como Version, define ExpressionOperator como IsEqualse ExpectedValue como 1.48.1.0. Em seguida, a regra verifica se o arquivo especificado tem a mesma versão de arquivo.
Quando você adiciona o parâmetro Value , o arquivo deve atender à regra para indicar a presença desse aplicativo. Use esse parâmetro com os seguintes parâmetros: ExpectedValue, ExpressionOperator e PropertyType.
\nEm vez de avaliar uma regra, para apenas marcar se o arquivo existe, use o parâmetro Existence.
\n","isRequired":true,"name":"Value","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Crie uma cláusula de método de detecção para um arquivo.
\n","syntaxes":["New-CMDetectionClauseFile -FileNameCrie uma cláusula de método de detecção para um arquivo.
\n","uid":"ConfigurationManager.New-CMDetectionClauseFile"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmdetectionclausefile?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmdetectionclausefile?view=sccm-ps"},"pageMetadata":"Use este cmdlet para criar uma cláusula em um método de detecção em um aplicativo. Essa cláusula é uma regra para um arquivo que indica a presença de um aplicativo.\nPara detectar uma pasta em vez de um arquivo, use o cmdlet New-CMDetectionClauseDirectory .
\nDepois de usar esse cmdlet, use um dos cmdlets Add ou Set para os tipos de implantação. Passe esse objeto de cláusula de detecção para os parâmetros AddDetectionClause ou RemoveDetectionClause .
\nPara agrupar cláusulas de detecção, use o parâmetro GroupDetectionClauses nos cmdlets do tipo de implantação.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.