Introdução ao PowerShell para Administradores do Power Platform

  • Artigo

Os cmdlets do PowerShell para Administradores do Power Platform foram projetados para gerenciar e administrar ambientes do Microsoft Power Platform, Power Apps e fluxos do Power Automate. Use o PowerShell para Administradores do Power Platform quando quiser criar ferramentas automatizadas que interajam com esses recursos.

Este artigo ajuda você a começar a usar o módulo do PowerShell e ensina os principais conceitos por trás dele.

Instalação

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

Entre no Microsoft Power Platform

Entre interativamente com o cmdlet Add-PowerAppsAccount.

Add-PowerAppsAccount -Endpoint prod

Como alternativa, você pode entrar com uma ID do cliente e segredo ou certificado. Para fazer isso, você precisa Criar uma entidade de 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 executar as operações de administração nos cmdlets, você precisará do seguinte:

  • Um usuário com qualquer uma dessas funções do Microsoft Entra ID, administrador do locatário, administrador do Power Platform, administrador de serviço do Dynamics 365, pode acessar os cmdlets do PowerShell do Power Apps. Essas funções não exigem mais um plano do Power Apps para acesso administrativo a cmdlets PowerShell para administradores do Power Apps. Entretanto, esses administradores precisam entrar no centro de administração do Power Platform pelo menos uma vez antes de usar os cmdlets do PowerShell. Se isso não for feito, os cmdlets falharão com um erro de autorização.

  • Power Platform Permissões de administrador ou administrador do Dynamics 365 são necessárias se você precisar pesquisar nos recursos de outro usuário. Observe que os administradores de ambiente só têm acesso aos ambientes e recursos de ambientes para os quais eles têm permissões.

  • Para Dataverse for Teams ambientes, você deve ser um Power Platform administrador para gerenciar ambientes dos quais você não é o proprietário da equipe Microsoft Teams.