Dela via


New-CMDetectionClauseDirectory

SYNOPSIS

Skapa en identifieringsmetodsats för en filsystemkatalog.

SYNTAX

Värde

New-CMDetectionClauseDirectory -DirectoryName <String> -PropertyType <FileFolderProperty>
 -ExpectedValue <String[]> -ExpressionOperator <FileFolderRuleExpressionOperator> [-Is64Bit] -Path <String>
 [-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

Existens

New-CMDetectionClauseDirectory -DirectoryName <String> [-Is64Bit] -Path <String> [-Existence]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

Använd den här cmdleten för att skapa en -sats i en identifieringsmetod i ett program. Den här satsen är en regel för en filsystemmapp som anger förekomsten av ett program.

Om du vill identifiera en fil i stället för en mapp använder du cmdleten New-CMDetectionClauseFile.

När du har använder den här cmdleten använder du en av cmdletarna Add- eller Set- för distributionstyper. Skicka det här identifieringssatsobjektet till parametrarna AddDetectionClause eller RemoveDetectionClause.

Om du vill gruppera satser för identifiering använder du parametern GroupDetectionClauses på cmdletarna för distributionstyp.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Lägg till en identifieringsmetod för förekomsten

Det här exemplet lägger till en identifieringssats som kräver att ett specifikt produkt-ID och katalognamn finns.

$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)

Exempel 2: Lägg till en identifieringsmetod för regelutvärdering

Det här exemplet lägger till en regelbaserad identifieringssats för att kontrollera att mappen ändrades efter 2020-12-30.

$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

-DirectoryName

Ange namnet på mappen som anger förekomsten av programmet. Använd parametern Sökväg för att ange sökvägen till den här mappen.

Till exempel installeras Konfigurationshanteraren-konsolen som standard på C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole . Om du vill skapa en regel för den här mappen anger du parametern AdminConsole till och parametern Path till %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

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Finns

När du lägger till den här parametern måste mappen finnas i målsystemet för att indikera förekomst av det här programmet.

Om du vill utvärdera en regel för egenskaperna för den här mappen använder du parametern Value i stället för att bara existera.

Type: SwitchParameter
Parameter Sets: Existence
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ExpectedValue

När du lägger till parametern Value använder du ExpectedValue med PropertyType och ExpressionOperator. När du använder dessa parametrar måste mappen uppfylla regeln för att indikera förekomsten av det här programmet. Den här parametern ExpectedValue anger det värde som ska jämföras med filsystemet.

Parametern PropertyType för den här satsen accepterar bara det datum då mappen skapades eller ändrades, så det här värdet är en sträng med en giltig datetime. Till exempel "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

När du lägger till parametern Value använder du ExpressionOperator med PropertyType och ExpectedValue. När du använder dessa parametrar måste mappen uppfylla regeln för att indikera förekomsten av det här programmet. Den här expressionOperator-parametern anger operatorn för att jämföra filsystemvärdet med det förväntade värdet.

Från och med version 2010 har parametertypen ändrats från RuleExpressionOperator till 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

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Is64Bit

Lägg till den här parametern för att ange att den här mappen är associerad med ett 32-bitarsprogram på 64-bitarssystem.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Path

Ange sökvägen i filsystemet till mappen som anger förekomsten av programmet. Använd parametern DirectoryName för att ange namnet på mappen.

Till exempel installeras Konfigurationshanteraren-konsolen som standard på C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole . Om du vill skapa en regel för den här mappen anger du parametern %ProgramFiles(x86)%\Microsoft Endpoint Manager till och parametern DirectoryName till AdminConsole .

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PropertyType

När du lägger till parametern Value använder du PropertyType med ExpressionOperator och ExpectedValue. När du använder dessa parametrar måste mappen uppfylla regeln för att indikera förekomsten av det här programmet. Parametern PropertyType anger mappegenskapen som ska utvärderas.

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

-Value

När du lägger till parametern Value måste mappen uppfylla regeln för att indikera förekomsten av det här programmet. Använd den här parametern med följande parametrar: ExpectedValue, ExpressionOperator och PropertyType.

I stället för att utvärdera en regel kan du använda parametern Existence för att bara kontrollera att mappen finns.

Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Ingen

OUTPUTS

System.Object

ANTECKNINGAR

New-CMDetectionClauseFile

New-CMDetectionClauseRegistryKey

New-CMDetectionClauseRegistryKeyValue

New-CMDetectionClauseWindowsInstaller