New-CMDetectionClauseFile
Creare una clausola del metodo di rilevamento per un file.
Sintassi
New-CMDetectionClauseFile
-FileName <String>
-PropertyType <FileFolderProperty>
-ExpectedValue <String[]>
-ExpressionOperator <FileFolderRuleExpressionOperator>
[-Is64Bit]
-Path <String>
[-Value]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
New-CMDetectionClauseFile
-FileName <String>
[-Is64Bit]
-Path <String>
[-Existence]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Descrizione
Usare questo cmdlet per creare una clausola in un metodo di rilevamento in un'applicazione. Questa clausola è una regola per un file che indica la presenza di un'applicazione.
Per rilevare una cartella anziché un file, usare il cmdlet New-CMDetectionClauseDirectory .
Dopo aver usato questo cmdlet, usare uno dei cmdlet Add- o Set- per i tipi di distribuzione. Passare questo oggetto clausola di rilevamento ai parametri AddDetectionClause o RemoveDetectionClause .
Per raggruppare le clausole di rilevamento, usare il parametro GroupDetectionClauses nei cmdlet del tipo di distribuzione.
Nota
Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>
. Per altre informazioni, vedere Introduzione.
Esempio
Esempio 1: Rilevare un'applicazione per versione
In questo esempio viene rilevata l'applicazione app.exe in una cartella specifica in cui la versione è maggiore o uguale a 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
Esempio 2: Creare più clausole per un tipo di distribuzione di app MSI
Questo esempio crea due clausole file e una clausola del Registro di sistema e le usa per aggiungere un tipo di distribuzione MSI a un'app.
$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"}
Parametri
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Existence
Quando si aggiunge questo parametro, il file deve esistere nel sistema di destinazione per indicare la presenza di questa applicazione.
Invece della sola esistenza, per valutare una regola per le proprietà di questo file, usare il parametro Value .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpectedValue
Quando si aggiunge il parametro Value , usare ExpectedValue con PropertyType e ExpressionOperator. Quando si usano questi parametri, il file deve soddisfare la regola per indicare la presenza di questa applicazione. Questo parametro ExpectedValue specifica il valore da confrontare con il file system.
Il valore da confrontare dipende dall'oggetto PropertyType specificato.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpressionOperator
Quando si aggiunge il parametro Value , usare ExpressionOperator con PropertyType e ExpectedValue. Quando si usano questi parametri, il file deve soddisfare la regola per indicare la presenza di questa applicazione. Questo parametro ExpressionOperator specifica l'operatore per confrontare il valore del file system con il valore previsto.
A partire dalla versione 2010, il tipo di parametro è cambiato da RuleExpressionOperator a FileFolderRuleExpressionOperator.
Type: | FileFolderRuleExpressionOperator |
Accepted values: | IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileName
Specificare il nome del file che indica la presenza dell'applicazione. Utilizzare il parametro Path per specificare il percorso del file.
Ad esempio, la console Configuration Manager viene installata per impostazione predefinita su C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe
. Per creare una regola per questo file, impostare questo parametro su Microsoft.ConfigurationManagement.exe
e il parametro Path su %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Is64Bit
Aggiungere questo parametro per indicare che questo file è associato a un'applicazione a 32 bit in sistemi a 64 bit.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Specificare il percorso nel file system del file che indica la presenza dell'applicazione. Utilizzare il parametro FileName per specificare il nome del file.
Ad esempio, la console Configuration Manager viene installata per impostazione predefinita su C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe
. Per creare una regola per questo file, impostare questo parametro su %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin
e il parametro FileName su Microsoft.ConfigurationManagement.exe
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PropertyType
Quando si aggiunge il parametro Value , usare PropertyType con ExpressionOperator e ExpectedValue. Quando si usano questi parametri, il file deve soddisfare la regola per indicare la presenza di questa applicazione. Questo parametro PropertyType specifica la proprietà del file da valutare.
Ad esempio, si imposta questo parametro Version
su , si imposta ExpressionOperator su IsEquals
e ExpectedValue su 1.48.1.0
. La regola controlla quindi che il file specificato abbia la stessa versione del file.
Type: | FileFolderProperty |
Accepted values: | DateCreated, DateModified, Version, Size |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Quando si aggiunge il parametro Value , il file deve soddisfare la regola per indicare la presenza di questa applicazione. Usare questo parametro con i parametri seguenti: ExpectedValue, ExpressionOperator e PropertyType.
Invece di valutare una regola, per verificare solo che il file esista, usare il parametro Existence .
Type: | SwitchParameter |
Aliases: | ValueRule |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
None
Output
System.Object
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per