Share via


New-CMDetectionClauseDirectory

SYNOPSIS

Hozzon létre egy észlelési metódus záradékot a fájlrendszer könyvtárához.

SYNTAX

Érték

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

Létezését

New-CMDetectionClauseDirectory -DirectoryName <String> [-Is64Bit] -Path <String> [-Existence]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

Ezzel a parancsmagkal záradékot hozhat létre egy alkalmazás észlelési metódusában. Ez a záradék egy fájlrendszermappa szabálya, amely egy alkalmazás jelenlétét jelzi.

Ha mappa helyett egy fájlt észlel, használja a New-CMDetectionClauseFile parancsmagot.

A parancsmag használata után használja az egyik Add- vagy Set- parancsmagot a központi telepítési típusokhoz. Adja át ezt az észlelési záradékobjektumot az AddDetectionClause vagy a RemoveDetectionClause paramétereknek.

A csoportészlelési záradékok csoportosítására használja a GroupDetectionCelésses paramétert az üzembe helyezési típus parancsmagja esetén.

Megjegyzés

Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\> . További információ: Első lépések.

EXAMPLES

1. példa: Meglétészlelési módszer hozzáadása

Ez a példa egy észlelési záradékot ad hozzá, amely megköveteli egy adott termékazonosító és könyvtárnév létezését.

$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)

2. példa: Szabályértékelés észlelési módszerének hozzáadása

Ez a példa egy szabályalapú észlelési záradékot ad hozzá annak ellenőrzéséhez, hogy a mappa 2020. 12. 30. után lett-e módosítva.

$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

Adja meg az alkalmazás jelenlétét jelző mappa nevét. A Path paraméterrel adhatja meg a mappa elérési útját.

Például a Konfigurációkezelő-konzol alapértelmezés szerint a következőre van telepítve: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole . Ha szabályt hoz létre ehhez a mappához, állítsa a paramétert a következőre: , az AdminConsole Elérési út paramétert pedig a következőre: %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

Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Existence (Meglét)

A paraméter hozzáadásakor a mappának léteznie kell a célrendszeren az alkalmazás jelenlétének jelzéséhez.

A mappa tulajdonságaira vonatkozó szabályok csak a megléte helyett a Value paramétert használják.

Type: SwitchParameter
Parameter Sets: Existence
Aliases:

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

-ExpectedValue (Várt érték)

A Value paraméter hozzáadásakor használja a ExpectedValue értéket a PropertyType és az ExpressionOperator paraméterrel. Ha ezeket a paramétereket használja, a mappának meg kell felelnie a szabálynak, hogy jelezze az alkalmazás jelenlétét. Ez a ExpectedValue paraméter határozza meg a fájlrendszerrel összehasonlítható értéket.

A záradék PropertyType paramétere csak a mappa létrehozási vagy módosítási dátumát fogadja el, ezért ez az érték egy érvényes datetime értékkel megadott sztring. Például: "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

A Value paraméter hozzáadásakor használja az ExpressionOperatort a PropertyType és a ExpectedValue paraméterrel. Ha ezeket a paramétereket használja, a mappának meg kell felelnie a szabálynak, hogy jelezze az alkalmazás jelenlétét. Ez az ExpressionOperator paraméter határozza meg az operátort, amely összehasonlítja a fájlrendszer értékét a várt értékkel.

A 2010-es verziótól kezdve a paraméter típusa RuleExpressionOperator értékről FileFolderRuleExpressionOperator típusra változott.

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

Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling kártyával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Is64Bit

Adja hozzá ezt a paramétert, amely jelzi, hogy ez a mappa egy 32 bites alkalmazáshoz van társítva 64 bites rendszereken.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Adja meg a fájlrendszerben az alkalmazás jelenlétét jelző mappa elérési útját. A mappa nevének megadásához használja a DirectoryName paramétert.

Például a Konfigurációkezelő-konzol alapértelmezés szerint a következőre van telepítve: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole . A mappa szabályának létrehozásához állítsa a paramétert a következőre: , %ProgramFiles(x86)%\Microsoft Endpoint Manager a DirectoryName paramétert pedig a következőre: AdminConsole .

Type: String
Parameter Sets: (All)
Aliases:

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

-PropertyType

A Value paraméter hozzáadásakor használja a PropertyType paramétert az ExpressionOperator és az ExpectedValue paraméterrel. Ha ezeket a paramétereket használja, a mappának meg kell felelnie a szabálynak, hogy jelezze az alkalmazás jelenlétét. Ez a PropertyType paraméter határozza meg az értékelni kívánt mappatulajdonságokat.

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 (Érték)

Az Érték paraméter hozzáadásakor a mappának meg kell felelnie a szabálynak, hogy jelezze az alkalmazás jelenlétét. Ezt a paramétert a következő paraméterekkel használhatja: ExpectedValue, ExpressionOperator és PropertyType.

Egy szabály kiértékelése helyett csak a Mappa létezésének ellenőrzésével ellenőrizze a Meglét paramétert.

Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule

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

CommonParameters

Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.

INPUTS

None

OUTPUTS

System.Object

MEGJEGYZÉSEK

New-CMDetectionClauseFile

New-CMDetectionClauseRegistryKey

New-CMDetectionClauseRegistryKeyValue

New-CMDetectionClauseWindowsInstaller