Agent 365 CLI-Befehlsreferenz cleanup

Bereinigt ALLRessourcen (Blueprint, Instanz und Azure). Verwenden Sie Unterbefehle für eine präzise Bereinigung. Der cleanup Befehl bietet Optionen zum Bereinigen von Ressourcen, die Sie während der Agent 365-Entwicklung und -Bereitstellung erstellt haben. Sie können alle Ressourcen gleichzeitig bereinigen oder bestimmte Unterbefehle für eine präzise Bereinigung verschiedener Ressourcentypen verwenden.

Mindestrolle erforderlich: Azure Mitwirkender + Globaler Administrator

Syntax

a365 cleanup [command] [options]

Options

Option	Description
-n, --agent-name <name>	Name der Agentenbasis. Wenn angegeben, ist keine Konfigurationsdatei erforderlich. Die CLI leitet Ressourcennamen auf die gleiche Weise ab wie a365 setup all --agent-name.
--tenant-id <tenantId>	Azure AD-Mandanten-ID. Overrides auto-detection. Verwendung mit --agent-name.
-y, --yes	Überspringe die Bestätigungshinweise und mach automatisch weiter.
--dry-run	Schauen Sie die Ressourcen an, die über Blueprint, Azure und Instanzschritte gelöscht werden, ohne Änderungen vorzunehmen.
-v, --verbose	Ermöglicht das Erstellen ausführlicher Protokolldateien.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Note

Wenn du --agent-name passierst, sucht die CLI zuerst den passenden Bauplan in Microsoft Entra nach. Wenn der Bauplan nicht gefunden wird und ein lokaler a365.generated.config.json Standort auf einen anderen Bauplan verweist, stoppt die CLI, um das Löschen der falschen Ressourcen zu vermeiden. Führe a365 cleanup ohne --agent-name Ausführung aus, um den von der lokal generierten Konfiguration referenzierten Blueprint zu bereinigen oder den --agent-name Wert zu korrigieren.

cleanup blueprint

Entfernen Sie Entra ID Blueprintanwendung und Dienstprinzipal.

Wenn du keinen Agenten-Blueprint mehr brauchst, führe cleanup blueprint ihn aus, um ihn aus der Microsoft Entra ID zu entfernen. Der Befehl löscht außerdem den Service-Principal des Blueprints und alle damit verknüpften Agenten-Instanzen. Wenn der Agent im Agentenregister registriert ist, kann auch der entsprechende Registereintrag entfernt werden.

a365 cleanup blueprint [options]

blueprint-Optionen

Option	Description
-n, --agent-name <name>	Name der Agentenbasis. Wenn du diese Option anbietest, brauchst du keine Konfigurationsdatei.
--tenant-id <tenantId>	Azure AD-Mandanten-ID. Overrides auto-detection. Verwendung mit --agent-name.
-y, --yes	Überspringe die Bestätigungshinweise und mach automatisch weiter.
--dry-run	Schaue die Ressourcen an, die gelöscht werden, ohne Änderungen vorzunehmen.
--endpoint-only	Lösche nur die Registrierung des Messaging-Endpunkts, behalte die Blueprint-Anwendung.
--m365	Behandle diesen Agent wie einen M365-Agenten. Optional – --endpoint-only löscht den Messaging-Endpunkt bereits automatisch über Teams Graph. Ignoriert (mit einer Warnung) bei vollständiger Blueprint-Bereinigung, da das Löschen der Blueprint-Anwendung den Messaging-Endpunkt auf der Serverseite entfernt. Standard ist false (opt-in).
-v, --verbose	Ermöglicht das Erstellen ausführlicher Protokolldateien.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Das folgende Beispiel zeigt, wie man einen Agenten-Blueprint namens my-agent löscht.

 a365 cleanup blueprint -n my-agent

cleanup azure

Entfernen Azure Ressourcen (App Service, App Service Plan).

a365 cleanup azure [options]

Mit diesem Befehl werden die Ressourcen Azure App Service und App Service Plan entfernt, die Sie während des Bereitstellungsprozesses erstellt haben.

azure-Optionen

Option	Description
-n, --agent-name <name>	Name der Agentenbasis. Wenn du diese Option anbietest, brauchst du keine Konfigurationsdatei.
--tenant-id <tenantId>	Azure AD-Mandanten-ID. Overrides auto-detection. Verwendung mit --agent-name.
-y, --yes	Überspringe die Bestätigungshinweise und mach automatisch weiter.
--dry-run	Schaue die Ressourcen an, die gelöscht werden, ohne Änderungen vorzunehmen.
-v, --verbose	Ermöglicht das Erstellen ausführlicher Protokolldateien.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

cleanup instance

Entfernen Sie die Agentinstanzidentität und den Benutzer aus Entra ID.

a365 cleanup instance [options]

Mit diesem Befehl wird die Agentinstanzidentität und das zugeordnete Benutzerkonto aus Microsoft Entra ID entfernt.

instance-Optionen

Option	Description
-n, --agent-name <name>	Name der Agentenbasis. Wenn du diese Option anbietest, brauchst du keine Konfigurationsdatei.
--tenant-id <tenantId>	Azure AD-Mandanten-ID. Overrides auto-detection. Verwendung mit --agent-name.
-y, --yes	Überspringe die Bestätigungshinweise und mach automatisch weiter.
--dry-run	Schaue die Ressourcen an, die gelöscht werden, ohne Änderungen vorzunehmen.
-v, --verbose	Ermöglicht das Erstellen ausführlicher Protokolldateien.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.