Azure PIM CLI (azpim)

Ein Kommandozeilen-Tool zur Verwaltung von Azure Privileged Identity Management (PIM)-Rollenaktivierungen direkt von Ihrem Terminal aus.

Funktionen

🔐 Rollenaktivierung – Schnelle Aktivierung berechtigter Azure PIM-Rollen
🔓 Rollendeaktivierung – Deaktivieren aktiver Rollen, wenn sie nicht mehr benötigt werden
📋 Interaktives Menü – Benutzerfreundliche, menügesteuerte Oberfläche
✨ Schöne Benutzeroberfläche – Poliertes Terminal-Erlebnis mit Spinnern und Farben
🔄 Multi-Rollen-Unterstützung – Mehrere Rollen gleichzeitig aktivieren oder deaktivieren
📊 Statusverfolgung – Echtzeit-Feedback zum Aktivierungs-/Deaktivierungsstatus
💾 Presets – Speichern und Wiederverwenden von Aktivierungs-/Deaktivierungskonfigurationen
⭐ Favoriten – Abonnements als Favoriten markieren für schnellen Zugriff
🗃️ Abonnement-Cache – Automatisches Caching von Abonnements (6 Stunden TTL) für schnelleren Start
🚀 Nicht-interaktiver Modus – CLI-Flags für Skripterstellung und Automatisierung
🔔 Update-Benachrichtigungen – Automatische Update-Prüfungen mit konfigurierbarem Verhalten
📤 JSON-Ausgabe – Maschinenlesbare Ausgabe zur Integration mit anderen Tools
👤 Pro-Benutzer-Datenisolierung – Konfiguration und Cache werden pro Azure-Benutzer-ID gespeichert

Voraussetzungen

Stellen Sie vor der Verwendung von azpim Folgendes sicher:

Node.js (v18 oder höher)
Azure CLI installiert und konfiguriert
Azure-Konto mit PIM-berechtigten Rollen

Azure CLI Einrichtung

# Azure CLI installieren (falls nicht installiert)
# Siehe: https://docs.microsoft.com/en-us/cli/azure/install-azure-cli

# Bei Azure anmelden
az login

# Überprüfen, ob Sie angemeldet sind
az account show

Installation

Globale Installation (Empfohlen)

# Mit npm
npm install -g azpim

# Mit pnpm
pnpm add -g azpim

# Mit yarn
yarn global add azpim

Nach der Installation steht der Befehl azpim global zur Verfügung.

Migration von azp-cli

Wenn Sie zuvor azp-cli verwendet haben, befinden sich Ihre Presets in ~/.config/azp-cli/ (bzw. %APPDATA%\azp-cli\ unter Windows). So migrieren Sie:

Kopieren Sie Ihre presets.json in das neue Verzeichnis: ~/.config/azpim/ (bzw. %APPDATA%\azpim\)
Deinstallieren Sie das alte Paket: npm uninstall -g azp-cli

Aus dem Quellcode (Entwicklung)

# Repository klonen
git clone https://github.com/tapanmeena/azpim.git
cd azpim

# Abhängigkeiten installieren
pnpm install

# Projekt erstellen
pnpm build

# Global für die Entwicklung verknüpfen
npm link

Verwendung

Das CLI ausführen

# Nach globaler Installation
azpim

# Oder mit spezifischen Befehlen
azpim activate
azpim deactivate
azpim preset list
azpim update

# Entwicklungsmodus (aus dem Quellcode)
pnpm dev

Befehle

Befehl	Alias	Beschreibung
`activate`	`a`	Aktivieren einer Rolle in Azure PIM (Standard)
`deactivate`	`d`	Deaktivieren einer Rolle in Azure PIM
`preset`	-	Verwaltung wiederverwendbarer Presets
`favorites`	`fav`	Verwaltung von Favoriten-Abonnements
`check-update`	`update`, `upgrade`	Prüfen auf eine neuere Version
`help`	-	Hilfeinformationen anzeigen

Globale Flags:

--debug – Debug-Logging aktivieren
--version – Versionsnummer anzeigen

Preset-Unterbefehle

Befehl	Beschreibung
`preset list`	Alle verfügbaren Presets auflisten
`preset show`	Details eines bestimmten Presets anzeigen
`preset add`	Neues Preset hinzufügen (interaktiver Assistent)
`preset edit`	Vorhandenes Preset bearbeiten (interaktiver Assistent)
`preset remove`	Preset entfernen

Favoriten-Unterbefehle

Befehl	Beschreibung
`favorites list`	Alle Favoriten-Abonnements auflisten
`favorites add`	Abonnement zu Favoriten hinzufügen
`favorites remove`	Abonnement aus Favoriten entfernen
`favorites clear`	Alle Favoriten löschen
`favorites export`	Favoriten in eine Datei exportieren
`favorites import`	Favoriten aus einer Datei importieren
`favorites refresh`	Abonnement-Cache aktualisieren

Updates

Sie können prüfen, ob eine neuere Version verfügbar ist:

azpim update
# Alias
azpim upgrade

Hinweise:

azpim update beendet sich mit Code 0, wenn aktuell, mit 2, wenn ein Update verfügbar ist, und mit 1 bei Fehler.
--check-only – Nur Status prüfen und anzeigen, ohne Upgrade-Anweisungen.
--output json liefert eine strukturierte Antwort, die für Skripte geeignet ist.
Standardmäßig zeigen azpim activate und azpim deactivate ebenfalls einen kurzen "Update verfügbar"-Hinweis (nur Textmodus) höchstens einmal pro Tag an.
Deaktivieren Sie Update-Prüfungen über AZPIM_NO_UPDATE_NOTIFIER=1 (oder AZPIM_DISABLE_UPDATE_CHECK=1).

Der Update-Check-Cache wird zusammen mit den Presets in Ihrem Konfigurationsverzeichnis gespeichert:

macOS/Linux: ~/.config/azpim/update-check.json (oder $XDG_CONFIG_HOME/azpim/update-check.json)
Windows: %APPDATA%\azpim\update-check.json

Nicht-interaktiver Modus (Automatisierung)

Verwenden Sie Flags, um PIM-Rollen direkt ohne das interaktive Menü zu aktivieren oder zu deaktivieren – ideal für Skripterstellung und CI/CD-Workflows.

Aktivierungsbeispiele

# Einzelne Rolle nach Namen aktivieren (nicht-interaktiv)
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Owner" \
   --duration-hours 2 \
   --justification "Break-glass für Vorfall" \
   --output json

# Mehrere Rollen aktivieren (--role-name wiederholen)
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --role-name "User Access Administrator"

# Wenn ein Rollenname mehreren berechtigten Rollen (unterschiedliche Bereiche) entspricht,
# führt --non-interactive zu einem Fehler, es sei denn, Sie erlauben explizit die Aktivierung aller Übereinstimmungen
azpim activate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --allow-multiple

# Vorschau, was passieren würde, ohne Anfragen zu senden
azpim activate --non-interactive --dry-run \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Contributor" \
   --output json

Deaktivierungsbeispiele

# Bestimmte Rollen deaktivieren
azpim deactivate --non-interactive --yes \
   --subscription-id <SUBSCRIPTION_GUID> \
   --role-name "Owner" \
   --justification "Aufgabe erledigt"

# Über alle Abonnements hinweg deaktivieren (subscription-id weglassen)
azpim deactivate --non-interactive --yes \
   --role-name "Contributor" \
   --allow-multiple

Verfügbare Flags

Gemeinsame Flags (aktivieren/deaktivieren):

azpim

Beliebteste