Bestand für geplante Eingabeaufforderungen

2025-06-03

Administratoren können eine Bestandsaufnahme geplanter Eingabeaufforderungen durchführen, die in ihren organization erstellt wurden, indem sie PowerShell-Skripts ausführen. Mit den folgenden Anweisungen können Administratoren eine Verbindung mit ihren Konten herstellen und geplante Eingabeaufforderungen anzeigen, auflisten oder löschen.

Voraussetzungen

Um eine Bestandsaufnahme geplanter Eingabeaufforderungen durchzuführen, die von Benutzern in Ihrem organization erstellt wurden, benötigen Sie die folgenden Voraussetzungen:

Weisen Sie Ihrem Benutzer die Rollen Globaler Administrator und Power Platform-Administrator in Azure-Portal für den Mandanten zu, für den Sie Vorgänge ausführen möchten.
Verwenden Sie PowerShell v7.0 und höher.
Die Az.Accounts Module und Microsoft.PowerApps.Administration.PowerShellsind installiert.
Alle Skripts befinden sich im selben Ordner, und führen Sie die Skripts aus, während sie sich in diesem Ordner befinden.

Führen Sie die folgenden Schritte aus, um die Rolle "Systemadministrator" in der Copilot-Umgebung für geplante Eingabeaufforderungen zu erhalten:

Wechseln Sie zum Power Platform Admin Center.
Suchen Sie die Microsoft 365-Umgebung , und wählen Sie sie aus. (Dies ist der Standardname für Copilot-Aktionen Umgebung. Einige Mandanten verwenden möglicherweise einen anderen Namen.)
Wählen Sie Mitgliedschaft aus.
Wählen Sie Mich hinzufügen aus, um Ihrem Benutzer die Rolle Systemadministrator hinzuzufügen. Es kann etwa 30 Minuten dauern, bis die Rolle überall widerzuspiegeln ist.

Weitere Informationen und Optionen finden Sie unter Verwalten High-Privileged Admin Rollen.

Herstellen einer Verbindung mit Ihrem Azure-Konto

Bevor Sie eines der folgenden Skripts ausführen, müssen Sie sich bei Ihrem Administratorkonto anmelden. Führen Sie zum Anmelden das folgende Skript aus:

Connect-AzAccount

Allgemeine Vorgänge

Um den Umgebungsnamen für geplante Copilot-Eingabeaufforderungen abzurufen, führen Sie das folgende Skript aus, und stellen Sie bei Bedarf eine Verbindung mit dem Administratorkonto her:

Get-AdminPowerAppEnvironment 'Microsoft 365'

Geben Sie Ihren Anzeigenamen (Microsoft 365 standardmäßig) ein. Beachten Sie, dass der EnvironmentName Wert ihren Umgebungsnamen angibt.

Sie können eine Benutzer-ID auch identifizieren, indem Sie dieses Skript mithilfe der entsprechenden Benutzer-E-Mail ausführen (user@domain.com im folgenden Beispiel). Notieren Sie sich den Id Feldwert in der Ausgabe, der die ID des Benutzers angibt:

Connect-Entra  

Get-EntraUser -UserId 'user@domain.com'

Auflisten geplanter Copilot-Eingabeaufforderungen

Es gibt verschiedene Möglichkeiten zum Ausführen eines Skripts zum Auflisten geplanter Eingabeaufforderungen, die in Ihrem Mandanten erstellt wurden.

Abrufen einer Liste der geplanten Copilot-Eingabeaufforderungen für den gesamten Mandanten

Rufen Sie mithilfe des EnvironmentId zuvor bereitgestellten Skripts ab.
Führen Sie das folgende Skript aus, ersetzen Sie den Platzhalter durch Ihren tatsächlichen EnvironmentId, und stellen Sie eine Verbindung mit dem Administratorkonto her, wenn Sie dazu aufgefordert werden:
```
.\Get-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345
```
Die Liste der geplanten Copilot-Eingabeaufforderungen sollte in der Konsole angezeigt werden.

Abrufen einer Liste der geplanten Copilot-Eingabeaufforderungen für einen einzelnen Benutzer

Rufen Sie die EnvironmentId ab, und UserId verwenden Sie die zuvor bereitgestellten Skripts.
Führen Sie das folgende Skript mit dem entsprechenden EnvironmentId und UserId aus, um die Platzhalter zu ersetzen und bei Bedarf eine Verbindung mit dem Administratorkonto herzustellen:
```
.\Get-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345 -UserId abc123-a100-xyz000-12345
```
Die Liste der geplanten Copilot-Eingabeaufforderungen, die zu diesem Benutzer gehören, sollte in der Konsole angezeigt werden.

Exportieren der Liste in eine Excel-/CSV-Datei

Fügen Sie am Ende des Befehls Folgendes hinzu:

| Export-Csv -Path C:\temp\resultFile.csv

Beispiel:

.\Get-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345 | Export-Csv -Path C:\temp\resultFile.csv

Geplante Copilot-Eingabeaufforderungen löschen

Löschen einer einzelnen Copilot-Aktion

Rufen Sie und die EnvironmentIdDataverseId der Aktion ab, die Sie löschen möchten.

Führen Sie folgendes Skript aus:

.\Remove-CopilotAction.ps1 -EnvironmentId abc123-a100-xyz000-12345 -DataverseId abc123-a100-xyz000-12345

Löschen mehrerer geplanter Copilot-Prompts von einem einzelnen Benutzer

Schließen Sie das Abrufen der Copilot Scheduled Prompts-Umgebungs-ID ab.
Schließen Sie Abrufen der Microsoft Entra Benutzerobjekt-ID ab.
Führen Sie das folgende Skript mit dem entsprechenden EnvironmentId und aus UserId , und stellen Sie bei Bedarf eine Verbindung mit dem Administratorkonto herstellen:
```
.\Clear-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345 -UserId abc123-a100-xyz000-12345
```