Inventaris voor geplande prompts

2025-06-03

Beheerders kunnen een inventarisatie maken van geplande prompts die in hun organisatie zijn gemaakt door PowerShell-scripts uit te voeren. Met de volgende instructies kunnen beheerders verbinding maken met hun accounts en geplande prompts weergeven, weergeven of verwijderen.

Vereisten

Als u een inventarisatie wilt maken van geplande prompts die door gebruikers in uw organisatie zijn gemaakt, hebt u de volgende vereisten nodig:

Laat de rollen Globale beheerder en Power Platform-beheerder toewijzen aan uw gebruiker in Azure Portal voor de tenant waarop u bewerkingen wilt uitvoeren.
Gebruik PowerShell v7.0+.
Modules Az.Accounts en Microsoft.PowerApps.Administration.PowerShellgeïnstalleerd hebben.
Plaats alle scripts in dezelfde map en voer de scripts uit terwijl u zich in die map bevindt.

Voer de volgende stappen uit om de rol Systeembeheerder op te halen in de copilot-omgeving met geplande prompts:

Ga naar het Power Platform-beheercentrum.
Zoek de Microsoft 365-omgeving en selecteer deze. (Dit is de standaardnaam voor Copilot-acties omgeving; sommige tenants gebruiken mogelijk een andere naam).
Selecteer Lidmaatschap.
Selecteer Mij toevoegen om de rol Systeembeheerder toe te voegen aan uw gebruiker. Het kan ongeveer 30 minuten duren voordat de rol overal wordt weergegeven.

Zie High-Privileged Beheer-rollen beheren voor meer informatie en opties.

Verbinding maken met uw Azure-account

Voordat u een van de volgende scripts uitvoert, moet u zich aanmelden bij uw beheerdersaccount. Voer het volgende script uit om u aan te melden:

Connect-AzAccount

Algemene bewerkingen

Als u de omgevingsnaam voor geplande Copilot-prompts wilt ophalen, voert u het volgende script uit en maakt u desgevraagd verbinding met het beheerdersaccount:

Get-AdminPowerAppEnvironment 'Microsoft 365'

Voer uw weergavenaam (Microsoft 365 standaard) in. Houd er rekening mee dat de EnvironmentName waarde de naam van uw omgeving aangeeft.

U kunt een gebruikers-id ook identificeren door dit script uit te voeren, met behulp van het juiste e-mailadres van de gebruiker (user@domain.com in het volgende voorbeeld). Noteer de Id veldwaarde in de uitvoer en die de id van de gebruiker aangeeft:

Connect-Entra  

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

Geplande copilot-prompts weergeven

Er zijn verschillende manieren om een script uit te voeren om geplande prompts weer te geven die in uw tenant zijn gemaakt.

Een lijst met geplande Copilot-prompts ophalen voor de hele tenant

Haal het EnvironmentId op met behulp van het eerder opgegeven script.
Voer het volgende script uit, vervang de tijdelijke aanduiding door uw werkelijke EnvironmentId, en maak desgevraagd verbinding met het beheerdersaccount:
```
.\Get-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345
```
De lijst met geplande Copilot-prompts moet worden weergegeven in de console.

Een lijst met geplande Copilot-prompts ophalen voor één gebruiker

Haal de EnvironmentId en UserId op met behulp van de scripts die eerder zijn opgegeven.
Voer het volgende script uit met behulp van de juiste EnvironmentId en UserId om de tijdelijke aanduidingen te vervangen en om verbinding te maken met het beheerdersaccount als dit wordt aangevraagd:
```
.\Get-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345 -UserId abc123-a100-xyz000-12345
```
De lijst met geplande Copilot-prompts van die gebruiker moet worden weergegeven in de console.

De lijst exporteren naar een Excel-/CSV-bestand

Voeg het volgende toe aan het einde van de opdracht:

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

Voorbeeld:

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

Geplande Copilot-prompts verwijderen

Eén copilot-actie verwijderen

Haal de EnvironmentId en de DataverseId op van de actie die u wilt verwijderen.

Voer het volgende script uit:

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

Meerdere geplande Copilot-Prompts van één gebruiker verwijderen

Voltooi Het ophalen van de copilot-Prompts-omgevings-id.
Voltooi Het ophalen van de Microsoft Entra gebruikersobject-id.
Voer het volgende script uit met behulp van de juiste EnvironmentId en UserId en maak verbinding met het beheerdersaccount als dit wordt aangevraagd:
```
.\Clear-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345 -UserId abc123-a100-xyz000-12345
```