New-CMComplianceRuleFileFolderSimple
建立簡單檔案資料夾的合規性規則。
語法
New-CMComplianceRuleFileFolderSimple
-PropertyType <SimpleFileFolderProperty>
-ExpressionOperator <RuleExpressionOperator>
[-ReportNoncompliance]
-InputObject <ConfigurationItemSetting>
-RuleName <String>
[-ExpectedValue <String[]>]
[-NoncomplianceSeverity <NoncomplianceSeverity>]
[-RuleDescription <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 建立簡單檔案資料夾的合規性規則。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 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
參數
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ExpectedValue
指定要比較值的字串數位。 要比較的值取決於指定的 PropertyType。
類型: | String[] |
別名: | ExpectedValues |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ExpressionOperator
針對 ExpectedValue,指定比較運算符。
類型: | RuleExpressionOperator |
接受的值: | 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 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-InputObject
指定設定項目設定物件作為此規則的目標。
類型: | ConfigurationItemSetting |
別名: | Setting |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-NoncomplianceSeverity
當規則不符合規範時,指定報告的嚴重性層級。
類型: | NoncomplianceSeverity |
接受的值: | None, Informational, Warning, Critical, CriticalWithEvent |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PropertyType
指定要比較及評估合規性的資料夾屬性。 使用 -ExpectedValue 參數來指定這個屬性的值,並使用 -ExpressionOperator 參數來指定比較方法。
從 2010 版開始,參數類型從 FileFolderProperty 變更為 SimpleFileFolderProperty 類型。
類型: | SimpleFileFolderProperty |
接受的值: | Company, ProductName, SHA1Hash |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ReportNoncompliance
如果找不到此設定實例,請新增此參數來報告不符合規範。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-RuleDescription
指定此規則的選擇性描述。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-RuleName
指定此規則的名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItemSetting
輸出
System.Object