New-CMDetectionClauseFile
SYNOPSIS
Skapa en identifieringsmetodsats för en fil.
SYNTAX
Värde
New-CMDetectionClauseFile -FileName <String> -PropertyType <FileFolderProperty> -ExpectedValue <String[]>
-ExpressionOperator <FileFolderRuleExpressionOperator> [-Is64Bit] -Path <String> [-Value]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Existens
New-CMDetectionClauseFile -FileName <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 fil som anger förekomsten av ett program.
Om du vill identifiera en mapp i stället för en fil använder du cmdleten New-CMDetectionClauseDirectory.
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 identifieringssatser använder du parametern GroupDetectionClauses på cmdletarna för distributionstyp.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Identifiera ett program efter version
Det här exemplet identifierar programmet app.exe i en specifik mapp där versionen är större än eller lika med 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
Exempel 2: Skapa flera satser för en MSI-appdistributionstyp
Det här exemplet skapar två filsatser och en registersats och använder dem sedan för att lägga till en MSI-distributionstyp i en app.
$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
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
-Existence
När du lägger till den här parametern måste filen finnas i målsystemet för att indikera förekomsten av det här programmet.
Använd parametern Value i stället för att bara existera för att utvärdera en regel för egenskaperna för den här filen.
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 filen 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.
Värdet som ska jämföras beror på angiven PropertyType.
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 filen 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
-FileName
Ange namnet på filen som anger förekomsten av programmet. Använd parametern Sökväg för att ange sökvägen till den här filen.
Till exempel installeras Konfigurationshanteraren-konsolen som standard på C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe . Om du vill skapa en regel för den här filen anger du parametern till Microsoft.ConfigurationManagement.exe och parametern Path till %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
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 filen ä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 filen som anger förekomsten av programmet. Använd parametern FileName för att ange namnet på filen.
Till exempel installeras Konfigurationshanteraren-konsolen som standard på C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe . Om du vill skapa en regel för den här filen anger du parametern till %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin och parametern FileName till 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
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 filen uppfylla regeln för att indikera förekomsten av det här programmet. Parametern PropertyType anger den filegenskap som ska utvärderas.
Du kan till exempel ange den här parametern Version till , ange ExpressionOperator IsEquals till och ExpectedValue till 1.48.1.0 . Regeln kontrollerar sedan att den angivna filen har samma filversion.
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
-Value
När du lägger till parametern Value måste filen 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 använder du parametern Existence för att bara kontrollera att filen 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
RELATED LINKS
New-CMDetectionClauseDirectory
New-CMDetectionClauseRegistryKey