Share via


Começar a utilizar o PowerShell para Administradores do Power Platform

Os cmdlets do PowerShell para Administradores do Power Platform foram concebidos para gerir e administrar ambientes do Microsoft Power Platform, o Power Apps e fluxos do Power Automate. Utilize o PowerShell para Administradores do Power Platform quando pretender criar ferramentas automatizadas que interagem com estes recursos.

Este artigo ajuda-o a começar a utilizar o módulo do PowerShell e ensina os conceitos fundamentais subjacentes.

Instalação

A forma mais fácil de começar a utilizar o módulo do PowerShell é ao instalá-lo na sua máquina local. Siga as instruções em Instalação para importar o módulo ou para atualizar uma versão desatualizada que possa ter instalado anteriormente.

Iniciar sessão no Microsoft Power Platform

Inicie sessão interativamente com o cmdlet Add-PowerAppsAccount.

Add-PowerAppsAccount -Endpoint prod

Em alternativa, poderá iniciar sessão com um ID de cliente e um segredo ou certificado. Para tal, terá de Criar um principal do serviço.

$appId = "CLIENT_ID_FROM_AZURE_APP"
$secret = "SECRET_FROM_AZURE_APP"
$tenantId = "TENANT_ID_FROM_AZURE_APP"

Add-PowerAppsAccount -Endpoint prod -TenantID $tenantId -ApplicationId $appId -ClientSecret $secret -Verbose

Pré-requisito

Para realizar as operações de administração nos cmdlets, precisará do seguinte:

  • Qualquer uma destas funções do ID do Microsoft Entra, administrador de Inquilinos, administradores do Power Platform, Administrador de Serviço do Dynamics 365, pode aceder aos cmdlets do PowerShell de administração do Power Apps. Estas funções deixam de requerer um plano do Power Apps para acesso administrativo aos cmdlets do PowerShell de administração do Power Apps. No entanto, estes administradores têm de iniciar sessão no centro de administração do Power Platform, pelo menos uma vez antes de utilizarem os cmdlets do PowerShell. Se tal não for efetuado, os cmdlets falharão com um erro de autorização.

  • São necessárias permissões de Administrador Global do Microsoft 365, Administrador Global do Microsoft Entra, Administrador do Power Platform ou Administrador do Dynamics 365 se precisar de procurar nos recursos de outro utilizador. Tenha em atenção que os administradores de ambiente só têm acesso aos ambientes e recursos de ambiente para os quais têm permissões.

  • Para ambientes do Dataverse for Teams, tem de ser um Admin Global do Microsoft 365, Administrador Global do Microsoft Entra ou Administrador do Power Platform para gerir ambientes dos quais não é o proprietário da equipa no Microsoft Teams.