Technische Referenz zu CiTool

2024-10-01
Gilt für:: ✅ Windows 11

CiTool erleichtert IT-Administratoren die Verwaltung von App Control for Business-Richtlinien. Sie können dieses Tool verwenden, um App Control for Business-Richtlinien und CI-Token zu verwalten. In diesem Artikel wird beschrieben, wie Sie CiTool zum Aktualisieren und Verwalten von Richtlinien verwenden. Es ist in den Windows-Images ab Windows 11, Version 22H2 und Windows Server 2025 enthalten.

Richtlinienbefehle

Befehl	Beschreibung	Alias
`--update-policy </Path/To/Policy/File>`	Fügen Sie eine Richtlinie auf dem aktuellen System hinzu, oder aktualisieren Sie sie.	`-up`
`--remove-policy <PolicyGUID>`	Entfernen Sie eine durch PolicyGUID angegebene Richtlinie aus dem System.	`-rp`
`--list-policies`	Sichern Sie Informationen zu allen Richtlinien im System, unabhängig davon, ob sie aktiv sind oder nicht.	`-lp`

Tokenbefehle

Befehl	Beschreibung	Alias
`--add-token <Path/To/Token/File> <--token-id ID>`	Stellen Sie ein Token auf dem aktuellen System mit einer optionalen spezifischen ID bereit.	`-at`
`--remove-token <ID>`	Entfernen Sie ein Token, das durch die ID angegeben ist, aus dem System.	`-rt`
`--list-tokens`	Sichern Sie Informationen zu allen Token im System.	`-lt`

Hinweis

<ID> Wenn --add-tokenangegeben ist, sollte kein bereits vorhandenes Token mit <ID> vorhanden sein.

Verschiedene Befehle

Befehl	Beschreibung	Alias
`--device-id`	Sichern Sie die Geräte-ID der Codeintegrität.	`-id`
`--refresh`	Versuchen Sie, App Control-Richtlinien zu aktualisieren.	`-r`
`--help`	Zeigt das Hilfemenü des Tools an.	`-h`

Ausgabeattribute und -beschreibungen

Auflisten von Richtlinien (`--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

Attribut	Beschreibung	Beispielwert
Richtlinien-ID	Listen die ID der Richtlinie.	`d2bda982-ccf6-4344-ac5b-0b44427b6816`
Basisrichtlinien-ID	Listen die ID der Basisrichtlinie.	`d2bda982-ccf6-4344-ac5b-0b44427b6816`
Anzeigename	In aufgeführter Wert `<Setting Provider="PolicyInfo" Key="Information" ValueName="Name">`	`Microsoft Windows Driver Policy`
Version	Version der Richtlinie, die in aufgeführt ist `<VersionEx>`	`2814751463178240`
Plattformrichtlinie	Gibt an, ob die Richtlinie von Microsoft bereitgestellt wird, z. B. in der Sperrliste für anfällige Treiber.	`true`
Richtlinie ist signiert	Gibt an, ob die Richtlinie über eine gültige Signatur verfügt.	`true`
Datei auf datenträger	Gibt an, ob sich die Richtliniendatei derzeit auf dem Datenträger befindet.	`false`
Wird derzeit erzwungen	Gibt an, ob die Richtliniendatei aktiv ist.	`true`
Ist autorisiert	Wenn die Richtlinie erfordert, dass ein Token aktiviert wird, ist dieser Wert der Autorisierungsstatus für das Token. Wenn die Richtlinie kein Token erfordert, stimmt dieser Wert mit dem Wert für die Eigenschaft Is Currently Enforced überein .	`true`

Beispiele

Bereitstellen einer App Control-Richtlinie

CiTool --update-policy "\Windows\Temp\{BF61FE40-8929-4FDF-9EC2-F7A767717F0B}.cip"

Aktualisieren der App Control-Richtlinien auf dem System

CiTool --refresh

Entfernen einer bestimmten App Control-Richtlinie anhand ihrer Richtlinien-ID

CiTool --remove-policy "{BF61FE40-8929-4FDF-9EC2-F7A767717F0B}"

Auflisten der aktiv erzwungenen App Control-Richtlinien auf dem 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

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

Freigeben über