Deploy WDAC policies using script

Applies to:

  • Windows 10
  • Windows 11
  • Windows Server 2016 and above

Note

Some capabilities of Windows Defender Application Control are only available on specific Windows versions. Learn more about the Application Control feature availability.

This topic describes how to deploy Windows Defender Application Control (WDAC) policies using script. The instructions below use PowerShell but can work with any scripting host.

Note

To use this procedure, download and distribute the WDAC policy refresh tool to all managed endpoints. Ensure your WDAC policies allow the WDAC policy refresh tool or use a managed installer to distribute the tool.

Deploying policies for Windows 10 version 1903 and above

  1. Initialize the variables to be used by the script.

    # Policy binary files should be named as {GUID}.cip for multiple policy format files (where {GUID} = <PolicyId> from the Policy XML)
    $PolicyBinary = "<Path to policy binary file to deploy>"
    $DestinationFolder = $env:windir+"\System32\CodeIntegrity\CIPolicies\Active\"
    $RefreshPolicyTool = "<Path where RefreshPolicy.exe can be found from managed endpoints>"
    
  2. Copy WDAC policy binary to the destination folder.

    Copy-Item -Path $PolicyBinary -Destination $DestinationFolder -Force
    
  3. Repeat steps 1-2 as appropriate to deploy additional WDAC policies.

  4. Run RefreshPolicy.exe to activate and refresh all WDAC policies on the managed endpoint.

    & $RefreshPolicyTool
    

Deploying policies for Windows 10 versions earlier than 1903

  1. Initialize the variables to be used by the script.

    # Policy binary files should be named as SiPolicy.p7b for Windows 10 versions earlier than 1903
    $PolicyBinary = "<Path to policy binary file to deploy>"
    $DestinationBinary = $env:windir+"\System32\CodeIntegrity\SiPolicy.p7b"
    
  2. Copy WDAC policy binary to the destination.

    Copy-Item  -Path $PolicyBinary -Destination $DestinationBinary -Force
    
  3. Refresh and activate WDAC policy using WMI

    Invoke-CimMethod -Namespace root\Microsoft\Windows\CI -ClassName PS_UpdateAndCompareCIPolicy -MethodName Update -Arguments @{FilePath = $DestinationBinary}
    

Deploying signed policies

In addition to the steps outlined above, the binary policy file must also be copied to the device's EFI partition. Deploying your policy via MEM or the Application Control CSP will handle this step automatically.

  1. Mount the EFI volume and make the directory, if it does not exist, in an elevated PowerShell prompt:

    $MountPoint = 'C:\EFI'
    $EFIDestinationFolder = "$MountPoint\Microsoft\Boot\CiPolicies\Active"
    $EFIPartition = (Get-Partition | Where-Object IsSystem).AccessPaths[0]
    mkdir $EFIDestinationFolder
    mountvol $MountPoint $EFIPartition
    
  2. Copy the signed policy to the created folder:

    Copy-Item -Path $PolicyBinary -Destination $EFIDestinationFolder -Force
    
  3. Restart the system.