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
RELATED LINKS
New-CMDetectionClauseDirectory
New-CMDetectionClauseRegistryKey