New-CMDetectionClauseFile
SYNOPSIS
Hozzon létre egy észlelési metódus záradékot egy fájlhoz.
SYNTAX
Érték
New-CMDetectionClauseFile -FileName <String> -PropertyType <FileFolderProperty> -ExpectedValue <String[]>
-ExpressionOperator <FileFolderRuleExpressionOperator> [-Is64Bit] -Path <String> [-Value]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Létezését
New-CMDetectionClauseFile -FileName <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ájlra vonatkozó szabály, amely egy alkalmazás jelenlétét jelzi.
Ha fájl helyett mappát észlel, használja a New-CMDetectionClauseDirectory 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 GroupDetectionCstbses 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: Alkalmazás észlelése verzió alapján
Ez a példa észleli az alkalmazás app.exe egy adott mappában, ahol a verzió nagyobb vagy egyenlő, mint 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
2. példa: Több záradék létrehozása MSI-alkalmazástelepítési típushoz
Ez a példa két fájl záradékot és egy beállításjegyzék-záradékot hoz létre, majd a használatával hozzáad egy MSI üzembe helyezési típust egy alkalmazáshoz.
$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
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 fájlnak léteznie kell a célrendszeren az alkalmazás jelenlétének jelzéséhez.
Ahelyett, hogy csak a meglétet használjuk, a fájl tulajdonságaira vonatkozó szabály kiértékeléséhez használja a Value paramétert.
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 fájlnak meg kell felelnie a szabálynak, amely jelzi az alkalmazás jelenlétét. Ez a ExpectedValue paraméter határozza meg a fájlrendszerhez összehasonlítani kívánt értéket.
Az összehasonlítható érték a megadott PropertyType tulajdonságtól függ.
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 értékkel. Ha ezeket a paramétereket használja, a fájlnak meg kell felelnie a szabálynak, amely jelzi 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 kezdődően 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
-FileName (Fájlnév)
Adja meg az alkalmazás jelenlétét jelző fájl nevét. A Path paraméterrel adhatja meg a fájl elérési útját.
Az Konfigurációkezelő konzolja például alapértelmezés szerint a következőre van telepítve: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe
. A fájlra vonatkozó szabály létrehozásához állítsa ezt a paramétert a következőre: , az Microsoft.ConfigurationManagement.exe
Elérési út paramétert pedig a következőre: %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
Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling használatá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 fájl 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 az alkalmazás jelenlétét jelző fájl elérési útját a fájlrendszerben. A fájl nevének megadásához használja a FileName paramétert.
Az Konfigurációkezelő konzolja például alapértelmezés szerint a következőre van telepítve: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe
. A fájlra vonatkozó szabály létrehozásához állítsa ezt a paramétert a következőre: , a %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin
FileName paramétert pedig a következőre: 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 (Tulajdonságtípus)
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 fájlnak meg kell felelnie a szabálynak, amely jelzi az alkalmazás jelenlétét. Ez a PropertyType paraméter határozza meg az értékelni kívánt fájltulajdonságokat.
Ezt a paramétert például a következőre adhatja meg: Version
, az ExpressionOperator értéke IsEquals
, a ExpectedValue értéke pedig 1.48.1.0
. A szabály ezután ellenőrzi, hogy a megadott fájlnak ugyanaz-e a fájlverziója.
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 (Érték)
Az Érték paraméter hozzáadásakor a fájlnak meg kell felelnie a szabálynak, amely jelzi az alkalmazás jelenlétét. Használja ezt a paramétert a következő paraméterekkel: ExpectedValue, ExpressionOperator, és PropertyType.
Egy szabály kiértékelása helyett csak azt ellenőrizze, hogy a fájl létezik-e, használja a Existence 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
RELATED LINKS
New-CMDetectionClauseDirectory
New-CMDetectionClauseRegistryKey