New-CMComplianceRuleFileFolderSimple
Erstellen Sie eine Konformitätsregel für einen einfachen Dateiordner.
Syntax
New-CMComplianceRuleFileFolderSimple
-PropertyType <SimpleFileFolderProperty>
-ExpressionOperator <RuleExpressionOperator>
[-ReportNoncompliance]
-InputObject <ConfigurationItemSetting>
-RuleName <String>
[-ExpectedValue <String[]>]
[-NoncomplianceSeverity <NoncomplianceSeverity>]
[-RuleDescription <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Verwenden Sie dieses Cmdlet, um eine Konformitätsregel für einen einfachen Dateiordner zu erstellen.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>
. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 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
Parameter
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ExpectedValue
Geben Sie ein Array von Zeichenfolgen an, um den Wert zu vergleichen. Der zu vergleichende Wert hängt vom angegebenen PropertyType ab.
Typ: | String[] |
Aliase: | ExpectedValues |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ExpressionOperator
Geben Sie für ExpectedValue den Vergleichsoperator an.
Typ: | RuleExpressionOperator |
Zulässige Werte: | And, Or, Other, IsEquals, NotEquals, GreaterThan, LessThan, Between, NotBetween, GreaterEquals, LessEquals, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains, AllOf, OneOf, NoneOf, SetEquals, SubsetOf, ExcludesAll |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InputObject
Geben Sie ein Konfigurationselementeinstellungsobjekt als Ziel dieser Regel an.
Typ: | ConfigurationItemSetting |
Aliase: | Setting |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-NoncomplianceSeverity
Geben Sie den Schweregrad für Berichte an, wenn die Regel nicht konform ist.
Typ: | NoncomplianceSeverity |
Zulässige Werte: | None, Informational, Warning, Critical, CriticalWithEvent |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-PropertyType
Geben Sie die Ordnereigenschaft an, die verglichen und auf Konformität bewertet werden soll. Verwenden Sie den Parameter -ExpectedValue , um den Wert dieser Eigenschaft anzugeben, und den Parameter -ExpressionOperator , um die Vergleichsmittel anzugeben.
Ab Version 2010 wurde der Parametertyp von FileFolderProperty in SimpleFileFolderProperty-Typ geändert.
Typ: | SimpleFileFolderProperty |
Zulässige Werte: | Company, ProductName, SHA1Hash |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ReportNoncompliance
Fügen Sie diesen Parameter hinzu, um Nichtkonformität zu melden, wenn diese Einstellungsinstanz nicht gefunden wird.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RuleDescription
Geben Sie eine optionale Beschreibung für diese Regel an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RuleName
Geben Sie den Namen für diese Regel an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItemSetting
Ausgaben
System.Object