New-CMDetectionClauseFile
SYNOPSIS
Utwórz klauzulę metody wykrywania dla pliku.
SYNTAX
Wartość
New-CMDetectionClauseFile -FileName <String> -PropertyType <FileFolderProperty> -ExpectedValue <String[]>
-ExpressionOperator <FileFolderRuleExpressionOperator> [-Is64Bit] -Path <String> [-Value]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Istnienia
New-CMDetectionClauseFile -FileName <String> [-Is64Bit] -Path <String> [-Existence] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
To polecenie cmdlet umożliwia utworzenie klauzuli w metodzie wykrywania w aplikacji. Ta klauzula jest regułą dla pliku, która wskazuje obecność aplikacji.
Aby wykryć folder zamiast pliku, użyj polecenia cmdlet New-CMDetectionClauseDirectory.
Po użyciu tego polecenia cmdlet użyj jednego z add- lub set- polecenia cmdlet dla typów wdrożeń. Przekaż ten obiekt klauzuli wykrywania do parametrów AddDetectionClause lub RemoveDetectionClause.
Aby zgrupować klauzule wykrywania, użyj parametru GroupDetectionClauses w poleceniach cmdlet typu wdrożenia.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: wykrywanie aplikacji według wersji
W tym przykładzie aplikacja jest wykrywanaapp.exe w określonym folderze, w którym wersja jest większa niż lub równa 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
Przykład 2: Tworzenie wielu klauzul dla typu wdrożenia aplikacji MSI
Ten przykład tworzy dwie klauzule pliku i jedną klauzulę rejestru, a następnie używa ich do dodawania typu wdrożenia MSI do aplikacji.
$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
Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Istnienie
Po dodaniu tego parametru plik musi istnieć w systemie docelowym, aby wskazać obecność tej aplikacji.
Zamiast po prostu istnienia, aby ocenić regułę dla właściwości tego pliku, użyj wartości parametru.
Type: SwitchParameter
Parameter Sets: Existence
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpectedValue
Podczas dodawania parametru Value użyj wartości ExpectedValue z właściwościami PropertyType i ExpressionOperator. Jeśli używasz tych parametrów, plik musi spełniać regułę, aby wskazać obecność tej aplikacji. Ten parametr ExpectedValue określa wartość do porównania z systemem plików.
Wartość do porównania zależy od określonego typu właściwości.
Type: String[]
Parameter Sets: Value
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpressionOperator
Podczas dodawania parametru Value użyj właściwości ExpressionOperator z właściwościami PropertyType i ExpectedValue. Jeśli używasz tych parametrów, plik musi spełniać regułę, aby wskazać obecność tej aplikacji. Ten parametr ExpressionOperator określa operator, który ma porównać wartość systemu plików z oczekiwaną wartością.
Począwszy od wersji 2010, typ parametru został zmieniony z RuleExpressionOperator na 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
Określ nazwę pliku, która wskazuje obecność aplikacji. Użyj path parametru, aby określić ścieżkę do tego pliku.
Na przykład konsola Menedżer konfiguracji instalowana domyślnie na platformie C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe . Aby utworzyć regułę dla tego pliku, ustaw ten parametr na , a parametr Microsoft.ConfigurationManagement.exe Path na %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
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Is64Bit
Dodaj ten parametr, aby wskazać, że ten plik jest skojarzony z aplikacją 32-bitową w systemach 64-bitowych.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Określ ścieżkę w systemie plików do pliku, który wskazuje obecność aplikacji. Użyj parametru FileName, aby określić nazwę pliku.
Na przykład konsola Menedżer konfiguracji instalowana domyślnie na platformie C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe . Aby utworzyć regułę dla tego pliku, ustaw ten parametr na , a %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin parametr FileName na 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
Po dodaniu parametru Value użyj właściwości PropertyType z parametrami ExpressionOperator i ExpectedValue. Jeśli używasz tych parametrów, plik musi spełniać regułę, aby wskazać obecność tej aplikacji. Ten parametr PropertyType określa właściwość pliku do oceny.
Na przykład ten parametr należy ustawić na Version , ustawić parametr ExpressionOperator na IsEquals wartość , a parametr ExpectedValue na 1.48.1.0 wartość . Następnie reguła sprawdza, czy określony plik ma tę samą wersję pliku.
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 (Wartość)
Po dodaniu parametru Value plik musi spełniać regułę, aby wskazać obecność tej aplikacji. Użyj tego parametru z następującymi parametrami: ExpectedValue, ExpressionOperator i PropertyType.
Zamiast oceniać regułę, aby tylko sprawdzić, czy plik istnieje, użyj parametru Obecność.
Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
INPUTS
Brak
OUTPUTS
System.Object
UWAGI
RELATED LINKS
New-CMDetectionClauseDirectory
New-CMDetectionClauseRegistryKey