New-CMDetectionClauseDirectory

  • Artykuł

SYNOPSIS

Utwórz klauzulę metody wykrywania dla katalogu systemu plików.

SYNTAX

Wartość

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

Istnienia

New-CMDetectionClauseDirectory -DirectoryName <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łą folderu systemu plików, która wskazuje obecność aplikacji.

Aby wykryć plik zamiast folderu, użyj polecenia cmdlet New-CMDetectionClauseFile.

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: Dodawanie metody wykrywania istnienia

W tym przykładzie dodano klauzulę wykrywania, która wymaga istnienia określonego identyfikatora produktu i nazwy katalogu.

$app = Get-CMApplication -ApplicationName "CentralApp"
$guid = "9900a338-484b-4a18-884e-bce87654ce1b"
$clause1 = New-CMDetectionClauseWindowsInstaller -ProductCode $guid -Value -ExpressionOperator IsEquals -ExpectedValue "1.1.1.1"
$clause2 = New-CMDetectionClauseDirectory -DirectoryName "mymsi" -Path "C:\" -Existence

$app | Add-CMMsiDeploymentType -ContentLocation "\\myserver\mypath\mymsi.msi" -Force -AddDetectionClause ($clause1, $clause2)

Przykład 2: Dodawanie metody wykrywania oceny reguły

W tym przykładzie dodano klauzulę wykrywania opartą na regułach, aby sprawdzić, czy folder został zmodyfikowany po 30.12.2020 r.

$clause1 = New-CMDetectionClauseDirectory -DirectoryName "AdminConsole" -Path "%ProgramFiles(x86)%\Microsoft Endpoint Manager" -Value -PropertyType DateCreated -ExpressionOperator GreaterThan -ExpectedValue "2020-11-30T08:00:00Z"

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1

PARAMETERS

-DirectoryName

Określ nazwę folderu, który wskazuje obecność aplikacji. Użyj parametru Ścieżka, aby określić ścieżkę do tego folderu.

Na przykład konsola Menedżer konfiguracji instalowana domyślnie na platformie C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole . Aby utworzyć regułę dla tego folderu, ustaw ten parametr na , a parametr AdminConsole Path na %ProgramFiles(x86)%\Microsoft Endpoint Manager .

Type: String
Parameter Sets: (All)
Aliases:

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

-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 folder musi istnieć w systemie docelowym, aby wskazać obecność tej aplikacji.

Zamiast po prostu istnienia, aby ocenić regułę dla właściwości tego folderu, 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, folder musi spełniać regułę, aby wskazać obecność tej aplikacji. Ten parametr ExpectedValue określa wartość do porównania z systemem plików.

Parametr PropertyType dla tej klauzuli akceptuje tylko datę utworzenia lub zmodyfikowania folderu, więc ta wartość jest ciągiem z prawidłową datą/godziną. Na przykład "2020-11-30T08:00:00Z".

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, folder 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

-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 folder 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 folderu, który wskazuje obecność aplikacji. Użyj parametru DirectoryName, aby określić nazwę folderu.

Na przykład konsola Menedżer konfiguracji instalowana domyślnie na platformie C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole . Aby utworzyć regułę dla tego folderu, ustaw ten parametr na , a %ProgramFiles(x86)%\Microsoft Endpoint Manager parametr DirectoryName na AdminConsole .

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, folder musi spełniać regułę, aby wskazać obecność tej aplikacji. Ten parametr PropertyType określa właściwość folderu do oceny.

Type: FileFolderProperty
Parameter Sets: Value
Aliases:
Accepted values: DateCreated, DateModified

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

-Value (Wartość)

Po dodaniu parametru Value folder 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 folder 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-CMDetectionClauseFile

New-CMDetectionClauseRegistryKey

New-CMDetectionClauseRegistryKeyValue

New-CMDetectionClauseWindowsInstaller