New-CMDetectionClauseFile

  • Artykuł

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

New-CMDetectionClauseDirectory

New-CMDetectionClauseRegistryKey

New-CMDetectionClauseRegistryKeyValue

New-CMDetectionClauseWindowsInstaller