New-CMWdacSetting
创建Microsoft Defender 应用程序控制设置策略对象。
语法
New-CMWdacSetting
[-EnforcementMode <CMWDACEnforcementMode>]
[-EnforceRestart <Boolean>]
[-EnableIntelligentSecurityGraph]
[-TrustedFolders <DirectoryInfo[]>]
[-TrustedFiles <FileInfo[]>]
-Name <String>
[-Description <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
说明
创建Microsoft Defender 应用程序控制设置策略对象。
使用 New-CMSettingDeployment cmdlet 将此设置部署到集合。
示例
示例 1:新的审核模式应用程序控制策略
此示例创建一个新的策略对象,以将应用程序控制置于审核模式。
New-CMWdacSetting -Name "NewAudit" -EnforcementMode AuditMode
示例 2:不重新启动客户端的新策略
此示例创建一个新策略,该策略在应用策略时不会强制客户端重启。
New-CMWdacSetting -Name "NewNoReboot" -EnforceRestart $false
示例 3:新策略自定义受信任的二进制文件
此示例创建一个新策略,用于将特定文件添加到受信任文件列表中。
New-CMWdacSetting -Name "NewTrustedFiles" -TrustedFiles "abc.exe", "xyz.dll"
参数
-Description
指定可选说明以更好地识别此策略。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EnableIntelligentSecurityGraph
添加此参数可授权Microsoft Intelligent Security Graph 信任的软件。 此服务包括 Windows Defender SmartScreen 和其他Microsoft服务。 若要信任此软件,设备必须运行 Windows Defender SmartScreen 和 Windows 10 版本 1709 或更高版本。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EnforcementMode
为 Microsoft Defender 应用程序控制选择以下强制方法之一:
-
EnforceMode
:只有受信任的可执行文件才能运行。 -
AuditMode
:允许所有可执行文件运行。 在运行不受信任的可执行文件时,向 Windows 事件日志添加一个条目。
类型: | CMWDACEnforcementMode |
接受的值: | AuditMode, EnforceMode |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EnforceRestart
客户端处理策略后,将在客户端上计划重启。 它遵循 计算机重启的客户端设置。 在设备重启之前,设备上当前运行的应用程序不会应用新的应用程序控制策略。
将此参数设置为 $true
以在客户端应用策略后强制设备重启。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Name
指定此策略的名称以标识它。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-TrustedFiles
为特定文件添加信任。
类型: | FileInfo[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TrustedFolders
为特定文件夹添加信任。
类型: | DirectoryInfo[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.WDAC.CMWdacSettings