Inventário para pedidos agendados

2025-06-03

Os administradores podem fazer o inventário de pedidos agendados criados na organização ao executar scripts do PowerShell. As instruções seguintes permitem que os administradores se liguem às respetivas contas e vejam, listem ou eliminem pedidos agendados.

Pré-requisitos

Para fazer o inventário de pedidos agendados criados pelos utilizadores na sua organização, precisa dos seguintes pré-requisitos:

Ter as funções Administrador Global e Administrador do Power Platform atribuídas ao utilizador no portal do Azure para o inquilino no qual pretende realizar operações.
Utilize o PowerShell v7.0+.
Ter Az.Accounts e Microsoft.PowerApps.Administration.PowerShellmódulos instalados.
Tenha todos os scripts na mesma pasta e execute os scripts enquanto estiver nessa pasta.

Para obter a função administrador de sistema no ambiente de pedidos agendados do Copilot, siga estes passos:

Aceda ao centro de administração do Power Platform.
Localize o ambiente do Microsoft 365 e selecione-o. (Este é o nome predefinido para Ações do Copilot ambiente; alguns inquilinos podem utilizar um nome diferente).
Selecione Associação.
Selecione Adicionar-me para adicionar a função de Administrador de Sistema ao utilizador. Pode demorar cerca de 30 minutos para que a função seja refletida em todo o lado.

Para obter mais detalhes e opções, veja Gerir funções de High-Privileged Administração.

Ligar à sua Conta do Azure

Antes de executar qualquer um dos seguintes scripts, tem de iniciar sessão na sua conta de administrador. Para iniciar sessão, execute o seguinte script:

Connect-AzAccount

Operações gerais

Para obter o nome do ambiente para pedidos agendados do Copilot, execute o seguinte script e ligue-se à conta de administrador, se solicitado:

Get-AdminPowerAppEnvironment 'Microsoft 365'

Introduza o seu nome a apresentar (Microsoft 365 por predefinição). Tenha em atenção que o EnvironmentName valor indica o nome do ambiente.

Também pode identificar um ID de utilizador ao executar este script com o e-mail de utilizador adequado (user@domain.com no exemplo seguinte). Tenha em atenção o Id valor do campo na saída e que indica o ID do utilizador:

Connect-Entra  

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

Listar pedidos agendados do Copilot

Existem diferentes formas de executar um script para listar pedidos agendados criados no seu inquilino.

Obter uma lista de pedidos agendados do Copilot para todo o inquilino

Obtenha a utilização do EnvironmentId script fornecido anteriormente.
Execute o seguinte script, substituindo o marcador de posição pelo seu real EnvironmentIde ligue-se à conta de administrador, se lhe for pedido:
```
.\Get-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345
```
A lista de pedidos agendados do Copilot deve ser apresentada na consola do .

Obter uma lista de pedidos agendados do Copilot para um único utilizador

Obtenha e EnvironmentIdUserId utilize os scripts fornecidos anteriormente.
Execute o seguinte script com o adequado EnvironmentId e UserId para substituir os marcadores de posição e ligar com a conta de administrador, se solicitado:
```
.\Get-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345 -UserId abc123-a100-xyz000-12345
```
A lista de pedidos agendados do Copilot pertencentes a esse utilizador deve ser apresentada na consola do .

Exportar a lista para um ficheiro Excel/CSV

Adicione o seguinte ao final do comando:

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

Exemplo:

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

Eliminar pedidos agendados do Copilot

Eliminar uma única Ação copilot

Obtenha o EnvironmentId e o DataverseId da ação que pretende eliminar.

Execute o seguinte script:

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

Eliminar várias Pedidos Agendadas do Copilot de um único utilizador

Conclua Obter o ID de ambiente de Pedidos Agendado do Copilot.
Conclua Obter o ID de objeto de utilizador Microsoft Entra.
Execute o seguinte script com o adequado EnvironmentId e UserId e ligue-se com a conta de administrador, se solicitado:
```
.\Clear-CopilotActions.ps1 -EnvironmentId abc123-a100-xyz000-12345 -UserId abc123-a100-xyz000-12345
```