Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
CiTool makes App Control for Business policy management easier for IT admins. You can use this tool to manage App Control for Business policies and CI tokens. This article describes how to use CiTool to update and manage policies. It's included in the Windows images starting with Windows 11, version 22H2, and Windows Server 2025.
Important
Policy enumeration includes Windows-managed inbox policies, not just policies that your organization deploys. Don't modify or remove Windows-managed policies. Use the associated Windows feature's documented settings or feature-specific recovery guidance instead.
Policy commands
| Command | Description | Alias |
|---|---|---|
--update-policy </Path/To/Policy/File> |
Add or update a policy on the current system. | -up |
--remove-policy <PolicyGUID> |
Remove a policy indicated by PolicyGUID from the system. | -rp |
--list-policies |
Dump information about all policies on the system, whether they're active or not. | -lp |
Token commands
| Command | Description | Alias |
|---|---|---|
--add-token <Path/To/Token/File> <--token-id ID> |
Deploy a token onto the current system, with an optional specific ID. | -at |
--remove-token <ID> |
Remove a token indicated by ID from the system. | -rt |
--list-tokens |
Dump information about all tokens on the system. | -lt |
Note
Regarding --add-token, if <ID> is specified, a pre-existing token with <ID> shouldn't exist.
Miscellaneous commands
| Command | Description | Alias |
|---|---|---|
--device-id |
Dump the code integrity device ID. | -id |
--refresh |
Attempt to refresh App Control policies. | -r |
--help |
Display the tool's help menu. | -h |
Output attributes and descriptions
List policies (--list-policies)
Policy ID: d2bda982-ccf6-4344-ac5b-0b44427b6816
Base Policy ID: d2bda982-ccf6-4344-ac5b-0b44427b6816
Friendly Name: Microsoft Windows Driver Policy
Version: 2814751463178240
Platform Policy: true
Policy is Signed: true
Has File on Disk: false
Is Currently Enforced: true
Is Authorized: true
Status: 0
| Attribute | Description | Example value |
|---|---|---|
| Policy ID | Lists the ID of the policy. | d2bda982-ccf6-4344-ac5b-0b44427b6816 |
| Base Policy ID | Lists the ID of the base policy. | d2bda982-ccf6-4344-ac5b-0b44427b6816 |
| Friendly Name | Value listed in <Setting Provider="PolicyInfo" Key="Information" ValueName="Name"> |
Microsoft Windows Driver Policy |
| Version | Version of the policy listed in <VersionEx> |
2814751463178240 |
| Platform Policy | Indicates whether Microsoft manages the policy as part of Windows, for example the vulnerable driver blocklist policy. The corresponding JSON property is IsSystemPolicy. Exclude policies with this value set to true from removal workflows. |
true |
| Policy is Signed | Indicates whether the policy has a valid signature. | true |
| Has File on Disk | Indicates whether the policy file is currently on the disk. | false |
| Is Currently Enforced | Indicates whether the policy file is active. | true |
| Is Authorized | If the policy requires a token to be activated, this value is the state of authorization for the token. If the policy doesn't require a token, this value matches the value for the Is Currently Enforced property. | true |
With -json, IsSystemPolicy is a boolean, not a string. true identifies a Windows-managed policy. false doesn't by itself authorize removal: verify that your organization deployed the policy and that you've met the policy removal prerequisites.
Don't infer ownership from a policy's friendly name, signature, enforcement state, authorization state, or presence on disk. If enumeration fails or the ownership property is unavailable, stop rather than assuming that a policy is safe to remove.
Examples
Deploy an App Control policy
CiTool --update-policy "\Windows\Temp\{BF61FE40-8929-4FDF-9EC2-F7A767717F0B}.cip"
Refresh the App Control policies on the system
CiTool --refresh
Remove a specific App Control policy by its policy ID
Use the guarded removal script to remove a policy that your organization deployed. The script checks IsSystemPolicy, skips Windows-managed policies, and stops if it can't determine ownership. Complete the signed-policy prerequisites in that article before removing a signed base policy.
List Windows-managed App Control policies
This read-only example shows policies to exclude from organization-policy removal workflows.
$PolicyJson = CiTool.exe -lp -json
if ($LASTEXITCODE -ne 0) {
throw "CiTool couldn't enumerate policies. Don't proceed with policy removal."
}
$Inventory = $PolicyJson | ConvertFrom-Json -ErrorAction Stop
if ($null -eq $Inventory.Policies) {
throw "The policy inventory is unavailable."
}
foreach ($Policy in $Inventory.Policies) {
if ($Policy.IsSystemPolicy -isnot [bool]) {
throw "Ownership information is unavailable for policy $($Policy.PolicyID)."
}
if ($Policy.IsSystemPolicy) {
$Policy | Select-Object -Property PolicyID, FriendlyName, IsSystemPolicy
}
}
List the actively enforced App Control policies on the system
# Check each policy's IsEnforced state and return only the enforced policies
(CiTool -lp -json | ConvertFrom-Json).Policies | Where-Object {$_.IsEnforced -eq "True"} |
Select-Object -Property PolicyID,FriendlyName | Format-List
Display the help menu
CiTool -h
----------------------------- Policy Commands ---------------------------------
--update-policy /Path/To/Policy/File
Add or update a policy on the current system
aliases: -up
--remove-policy PolicyGUID
Remove a policy indicated by PolicyGUID from the system
aliases: -rp
--list-policies
Dump information about all policies on the system, whether they be active or not
aliases: -lp
----------------------------- Token Commands ---------------------------------
--add-token Path/To/Token/File <--token-id ID>
Deploy a token onto the current system, with an optional specific ID
If <ID> is specified, a pre-existing token with <ID> should not exist.
aliases:-at
--remove-token ID
Remove a Token indicated by ID from the system.
aliases: -rt
--list-tokens
Dump information about all tokens on the system
aliases: -lt
----------------------------- Misc Commands ---------------------------------
--device-id
Dump the Code Integrity Device Id
aliases: -id
--refresh
Attempt to Refresh CI Policies
aliases: -r
--help
Display this message
aliases: -h