Condividi tramite

New-CMComplianceRuleFileFolderSimple

  • Riferimento
Modulo:
ConfigurationManager

Creare una regola di conformità per una cartella di file semplice.

Sintassi

New-CMComplianceRuleFileFolderSimple
   -PropertyType <SimpleFileFolderProperty>
   -ExpressionOperator <RuleExpressionOperator>
   [-ReportNoncompliance]
   -InputObject <ConfigurationItemSetting>
   -RuleName <String>
   [-ExpectedValue <String[]>]
   [-NoncomplianceSeverity <NoncomplianceSeverity>]
   [-RuleDescription <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare una regola di conformità per una cartella di file semplice.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

$ci = Get-CMConfigurationItem -Name "ci1" -Fast

$Result = $ci | Add-CMComplianceSettingFile -Path "C:\" -FileName  "TestFile.exe" -NoRule -Name "AttributeSetting1"

$TestSet = $Result | Get-CMComplianceSetting -SettingName "AttributeSetting1"

$r1 = $TestSet | New-CMComplianceRuleFileFolderSimple -PropertyType SHA1Hash -RuleName "RuleSha1HashEquals" -ExpressionOperator IsEquals -ExpectedValue "s4XuFV2KZldXAMQZ6YEWFv+5zA6ZB982Fbh471TMboc="

$r2 = $TestSet | New-CMComplianceRuleFileFolderSimple -PropertyType Company -RuleName "RuleCompanyEquals" -ExpressionOperator IsEquals -ExpectedValue "Contoso"

$r3 = $TestSet | New-CMComplianceRuleFileFolderSimple -PropertyType ProductName -RuleName "RuleProductNameEquals" -ExpressionOperator IsEquals -ExpectedValue "MyContoso"

$Result | Add-CMComplianceSettingRule -Rule $r1

$Result | Add-CMComplianceSettingRule -Rule $r2

$Result | Add-CMComplianceSettingRule -Rule $r3

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExpectedValue

Specificare una matrice di stringhe per confrontare il valore. Il valore da confrontare dipende dall'oggetto PropertyType specificato.

Tipo:String[]
Alias:ExpectedValues
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExpressionOperator

Per ExpectedValue specificare l'operatore di confronto.

Tipo:RuleExpressionOperator
Valori accettati:And, Or, Other, IsEquals, NotEquals, GreaterThan, LessThan, Between, NotBetween, GreaterEquals, LessEquals, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains, AllOf, OneOf, NoneOf, SetEquals, SubsetOf, ExcludesAll
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto di impostazione dell'elemento di configurazione come destinazione di questa regola.

Tipo:ConfigurationItemSetting
Alias:Setting
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NoncomplianceSeverity

Specificare il livello di gravità per i report quando la regola non è conforme.

Tipo:NoncomplianceSeverity
Valori accettati:None, Informational, Warning, Critical, CriticalWithEvent
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PropertyType

Specificare la proprietà folder da confrontare e valutare per la conformità. Utilizzare il parametro -ExpectedValue per specificare il valore di questa proprietà e il parametro -ExpressionOperator per specificare i mezzi di confronto.

A partire dalla versione 2010, il tipo di parametro è cambiato da FileFolderProperty a SimpleFileFolderProperty .

Tipo:SimpleFileFolderProperty
Valori accettati:Company, ProductName, SHA1Hash
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ReportNoncompliance

Aggiungere questo parametro per segnalare la non conformità se questa istanza dell'impostazione non viene trovata.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RuleDescription

Specificare una descrizione facoltativa per questa regola.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RuleName

Specificare il nome per questa regola.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItemSetting

Output

System.Object