Delen via


New-CMDetectionClauseFile

SYNOPSIS

Maak een detectiemethodeclausule voor een bestand.

SYNTAX

Waarde

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

Bestaan

New-CMDetectionClauseFile -FileName <String> [-Is64Bit] -Path <String> [-Existence] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

Gebruik deze cmdlet om een component te maken in een detectiemethode in een toepassing. Deze component is een regel voor een bestand dat de aanwezigheid van een toepassing aangeeft.

Als u een map wilt detecteren in plaats van een bestand, gebruikt u de cmdlet New-CMDetectionClauseDirectory.

Nadat u deze cmdlet hebt gebruikt, gebruikt u een van de cmdlets Add- of Set- voor implementatietypen. Geef dit detectieclausuleobject door aan de parameters AddDetectionClause of RemoveDetectionClause.

Als u detectieclausules wilt groepeert, gebruikt u de parameter GroupDetectionClauses voor de cmdlets van het implementatietype.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een toepassing detecteren op versie

In dit voorbeeld wordt gedetecteerd dat deapp.exe in een specifieke map waarin de versie groter is dan of gelijk is aan 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

Voorbeeld 2: Meerdere components maken voor een implementatietype van een MSI-app

In dit voorbeeld worden twee bestandsclausules en één registerclausule gemaakt en vervolgens gebruikt om een MSI-implementatietype aan een app toe te voegen.

$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

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Bestaan

Wanneer u deze parameter toevoegt, moet het bestand bestaan op het doelsysteem om aan te geven dat deze toepassing aanwezig is.

In plaats van alleen bestaan, gebruikt u de parameter Value om een regel te evalueren voor eigenschappen van dit bestand.

Type: SwitchParameter
Parameter Sets: Existence
Aliases:

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

-ExpectedValue

Wanneer u de parameter Value toevoegt, gebruikt u ExpectedValue met PropertyType en ExpressionOperator. Wanneer u deze parameters gebruikt, moet het bestand voldoen aan de regel om de aanwezigheid van deze toepassing aan te geven. Met deze parameter ExpectedValue geeft u de waarde op die moet worden vergeleken met het bestandssysteem.

De te vergelijken waarde is afhankelijk van het opgegeven PropertyType.

Type: String[]
Parameter Sets: Value
Aliases:

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

-ExpressionOperator

Wanneer u de parameter Value toevoegt, gebruikt u ExpressionOperator met PropertyType en ExpectedValue. Wanneer u deze parameters gebruikt, moet het bestand voldoen aan de regel om de aanwezigheid van deze toepassing aan te geven. Met deze parameter ExpressionOperator geeft u de operator op om de waarde van het bestandssysteem te vergelijken met de verwachte waarde.

Vanaf versie 2010 is het parametertype gewijzigd van RuleExpressionOperator in 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

-FileName

Geef de naam op van het bestand dat de aanwezigheid van de toepassing aangeeft. Gebruik de parameter Path om het pad naar dit bestand op te geven.

De Configuration Manager-console wordt bijvoorbeeld standaard geïnstalleerd op C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe . Als u een regel voor dit bestand wilt maken, stelt u deze parameter in op Microsoft.ConfigurationManagement.exe en stelt u de parameter Path in op %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

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Is64Bit

Voeg deze parameter toe om aan te geven dat dit bestand is gekoppeld aan een 32-bits toepassing op 64-bits systemen.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Geef het pad in het bestandssysteem op naar het bestand dat de aanwezigheid van de toepassing aangeeft. Gebruik de parameter FileName om de naam van het bestand op te geven.

De Configuration Manager-console wordt bijvoorbeeld standaard geïnstalleerd op C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe . Als u een regel voor dit bestand wilt maken, stelt u deze parameter in op %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin en stelt u de parameter FileName in op 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

Wanneer u de parameter Value toevoegt, gebruikt u PropertyType met ExpressionOperator en ExpectedValue. Wanneer u deze parameters gebruikt, moet het bestand voldoen aan de regel om de aanwezigheid van deze toepassing aan te geven. Met deze parameter PropertyType geeft u de bestandsinstelling op die moet worden geëvalueerd.

Stel deze parameter bijvoorbeeld in op Version , stel ExpressionOperator in op IsEquals en ExpectedValue op 1.48.1.0 . De regel controleert vervolgens of het opgegeven bestand dezelfde bestandsversie heeft.

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

-Waarde

Wanneer u de parameter Value toevoegt, moet het bestand voldoen aan de regel om de aanwezigheid van deze toepassing aan te geven. Gebruik deze parameter met de volgende parameters: ExpectedValue, ExpressionOperator en PropertyType.

In plaats van een regel te evalueren, gebruikt u de parameter Existence om te controleren of het bestand bestaat.

Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Geen

OUTPUTS

System.Object

OPMERKINGEN

New-CMDetectionClauseDirectory

New-CMDetectionClauseRegistryKey

New-CMDetectionClauseRegistryKeyValue

New-CMDetectionClauseWindowsInstaller