New-CMDetectionClauseFile
SYNOPSIS
Crie uma cláusula de método de deteção para um ficheiro.
SYNTAX
Valor
New-CMDetectionClauseFile -FileName <String> -PropertyType <FileFolderProperty> -ExpectedValue <String[]>
-ExpressionOperator <FileFolderRuleExpressionOperator> [-Is64Bit] -Path <String> [-Value]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Existência
New-CMDetectionClauseFile -FileName <String> [-Is64Bit] -Path <String> [-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 ficheiro que indica a presença de um pedido.
Para detetar uma pasta em vez de um ficheiro, utilize o cmdlet New-CMDetectionClauseDirectory.
Depois de utilizar este cmdlet, utilize um dos cmdlets Add-or set para tipos de implantação. Passe 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 implantação.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Detetar uma aplicação por versão
Este exemplo deteta a aplicação app.exe numa pasta específica onde a versão é maior ou igual a 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
Exemplo 2: Criar várias cláusulas para um tipo de implementação de aplicações MSI
Este exemplo cria duas cláusulas de ficheiro e uma cláusula de registo, e depois usa-as para adicionar um tipo de implementação MSI a uma aplicação.
$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"}
PARAMETERS
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Existência
Quando adicionar este parâmetro, o ficheiro deve existir no sistema alvo para indicar a presença desta aplicação.
Em vez de apenas existir, para avaliar uma regra para as propriedades deste ficheiro, use o parâmetro Valor.
Type: SwitchParameter
Parameter Sets: Existence
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Valor Esperado
Quando adicionar o parâmetro Valor, utilize o Valor Esperado com o PropertyType e o ExpressionOperator. Quando utilizar estes parâmetros, o ficheiro deve satisfazer a regra para indicar a presença deste pedido. Este parâmetro ExpectValue especifica o valor a comparar com o sistema de ficheiros.
O valor a comparar depende doTipo de Propriedade especificado.
Type: String[]
Parameter Sets: Value
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpressionOperator
Quando adicionar o parâmetro Valor, utilize o ExpressionOperator com o PropertyType e o ExpectValue. Quando utilizar estes parâmetros, o ficheiro deve satisfazer a regra para indicar a presença deste pedido. Este parâmetro ExpressionOperator especifica o operador para comparar o valor do sistema de ficheiros com o valor esperado.
A partir da versão 2010, o tipo de parâmetro mudou de RuleExpressionOperator para FileFolderRuleExpressionOperator.
Type: FileFolderRuleExpressionOperator
Parameter Sets: Value
Aliases:
Accepted values: IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de arquivo
Especifique o nome do ficheiro que indica a presença do pedido. Utilize o parâmetro Caminho para especificar o caminho para este ficheiro.
Por exemplo, a consola Do Gestor de Configuração instala por predefinição C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe . Para criar uma regra para este ficheiro, desacorda este parâmetro Microsoft.ConfigurationManagement.exe e o parâmetro Caminho para %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin .
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Is64Bit
Adicione este parâmetro para indicar que este ficheiro está associado a uma aplicação de 32 bits em sistemas de 64 bits.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Especifique o caminho no sistema de ficheiros para o ficheiro que indique a presença da aplicação. Utilize o parâmetro Data de Arquivo para especificar o nome do ficheiro.
Por exemplo, a consola Do Gestor de Configuração instala por predefinição C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe . Para criar uma regra para este ficheiro, desista este parâmetro %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin e o parâmetro FileName para Microsoft.ConfigurationManagement.exe .
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PropertyType
Quando adicionar o parâmetro Valor, utilize o PropertyType com ExpressionOperator e ExpectValue. Quando utilizar estes parâmetros, o ficheiro deve satisfazer a regra para indicar a presença deste pedido. Este parâmetro PropertyType especifica a propriedade do ficheiro para avaliar.
Por exemplo, define este parâmetro para Version , definir ExpressionOperator para IsEquals , e ExpectValue para 1.48.1.0 . A regra verifica então o ficheiro especificado para ter a mesma versão de ficheiro.
Type: FileFolderProperty
Parameter Sets: Value
Aliases:
Accepted values: DateCreated, DateModified, Version, Size
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Valor
Quando adicionar o parâmetro Valor, o ficheiro deve satisfazer a regra para indicar a presença deste pedido. Utilize este parâmetro com os seguintes parâmetros: ExpectValue, ExpressionOperator e PropertyType.
Em vez de avaliar uma regra, apenas para verificar se o ficheiro existe, use o parâmetro Existência.
Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Nenhuma
OUTPUTS
Sistema.Objeto
NOTAS
RELATED LINKS
Novo CMDetectionClauseDirectory
New-CMDetectionClauseRegistryKey