New-CMDetectionClauseDirectory
SYNOPSIS
Crie uma cláusula de método de deteção para um diretório de sistema de ficheiros.
SYNTAX
Valor
New-CMDetectionClauseDirectory -DirectoryName <String> -PropertyType <FileFolderProperty>
-ExpectedValue <String[]> -ExpressionOperator <FileFolderRuleExpressionOperator> [-Is64Bit] -Path <String>
[-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Existência
New-CMDetectionClauseDirectory -DirectoryName <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 uma pasta do sistema de ficheiros que indica a presença de uma aplicação.
Para detetar um ficheiro em vez de uma pasta, utilize o cmdlet New-CMDetectionClauseFile.
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: Adicionar um método de deteção de existência
Este exemplo adiciona uma cláusula de deteção que requer a existência de um ID e nome de diretório específico do produto.
$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)
Exemplo 2: Adicionar um método de deteção de avaliação de regras
Este exemplo adiciona uma cláusula de deteção baseada em regras para verificar se a pasta foi modificada após 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 $clause1
PARAMETERS
-Nome do Diretório
Especifique o nome da pasta que indica a presença da aplicação. Utilize o parâmetro Caminho para especificar o caminho para esta pasta.
Por exemplo, a consola Do Gestor de Configuração instala por predefinição C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole . Para criar uma regra para esta pasta, desacorda este parâmetro AdminConsole e o parâmetro Caminho para %ProgramFiles(x86)%\Microsoft Endpoint Manager .
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-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, a pasta 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 desta pasta, 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, a pasta deve satisfazer a regra para indicar a presença desta aplicação. Este parâmetro ExpectValue especifica o valor a comparar com o sistema de ficheiros.
O parâmetro PropertyType para esta cláusula só aceita a data em que a pasta foi criada ou modificada, pelo que este valor é uma cadeia com uma data válida. Por exemplo, "2020-11-30T08:00:00Z".
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, a pasta deve satisfazer a regra para indicar a presença desta aplicação. 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
-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 esta pasta está associada 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 a pasta que indica a presença da aplicação. Utilize o parâmetro Do Nome do Diretório para especificar o nome da pasta.
Por exemplo, a consola Do Gestor de Configuração instala por predefinição C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole . Para criar uma regra para esta pasta, desista este parâmetro %ProgramFiles(x86)%\Microsoft Endpoint Manager e o parâmetro Do Nome do Diretório para AdminConsole .
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, a pasta deve satisfazer a regra para indicar a presença desta aplicação. Este parâmetro PropertyType especifica a propriedade da pasta para avaliar.
Type: FileFolderProperty
Parameter Sets: Value
Aliases:
Accepted values: DateCreated, DateModified
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Valor
Quando adicionar o parâmetro Valor, a pasta deve satisfazer a regra para indicar a presença desta aplicação. Utilize este parâmetro com os seguintes parâmetros: ExpectValue, ExpressionOperator e PropertyType.
Em vez de avaliar uma regra, para verificar se a pasta 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
New-CMDetectionClauseRegistryKey