Usar o Azure Cloud Shell
O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo sem precisar instalar nada no seu ambiente local.
Para iniciar o Azure Cloud Shell:
| Opção |
Exemplo/Link |
| Selecione Experimente no canto superior direito de um bloco de código. Selecionar Experimente não copia automaticamente o código para o Cloud Shell. |
 |
| Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador. |
 |
| Selecione o botão Cloud Shell na barra de menus no canto superior direito do portal do Azure. |
 |
Para executar o código neste artigo no Azure Cloud Shell:
Inicie o Cloud Shell.
Clique no botão Copiar no bloco de código para copiá-lo.
Cole o código na sessão do Cloud Shell ao pressionar Ctrl+Shift+V no Windows e no Linux ou Cmd+Shift+V no macOS.
Pressione Enter para executar o código.
Prepare o seu ambiente
Os comandos de capacidade do Power BI Embedded exigem a versão 2.3.1 ou posterior da CLI do Azure. Execute az --version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para instalar ou atualizar, confira Instalar a CLI do Azure.
Entrar.
Entre usando o comando az login se estiver usando uma instalação local da CLI.
az login
Siga as etapas exibidas em nosso terminal para concluir o processo de autenticação.
Instale a extensão de CLI do Azure.
Ao trabalhar com referências de extensão para a CLI do Azure, você deve primeiro instalar a extensão. As extensões da CLI do Azure fornecem acesso a comandos experimentais e de pré-lançamento que ainda não foram enviados como parte da CLI principal. Para saber mais sobre extensões, incluindo atualização e desinstalação, confira Usar extensões com a CLI do Azure.
Instale a extensão para a capacidade do Power BI Embedded executando o seguinte comando:
az extension add --name powerbidedicated
Criar uma capacidade com a CLI do Azure
Use o comando az Power BI embedded-capacity create para criar uma capacidade.
az powerbi embedded-capacity create --location westeurope
--name
--resource-group
--sku-name "A1"
--sku-tier "PBIE_Azure"
Excluir uma capacidade com a CLI do Azure
Para excluir uma capacidade usando a CLI do Azure, use o comando Exclusão de capacidade do Azure Power BI Embedded.
az powerbi embedded-capacity delete --name
--resource-group
Gerenciar sua capacidade com a CLI do Azure
Confira todos os comandos da CLI do Azure do Power BI Embedded emAzure Power BI.
Usar modelo do Resource Manager
O modelo do Resource Manager é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do projeto. O modelo usa a sintaxe declarativa, que permite declarar o que você pretende implantar sem precisar gravar a sequência de comandos de programação para criá-lo. Caso deseje saber mais sobre como desenvolver modelos do Resource Manager, confira a documentação do Resource Manager e a referência de modelos.
Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Examinar o modelo
Os modelos usados neste início rápido são provenientes dos Modelos de Início Rápido do Azure.
Depois que o recurso do Azure for definido no modelo Microsoft.PowerBIDedicated/capacities Az, crie uma capacidade do Power BI Embedded.
Use este modelo para criar um recurso do Power BI Embedded.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"name": {
"type": "string",
"metadata": {
"description": "The capacity name, which is displayed in the Azure portal and the Power BI admin portal"
}
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]",
"metadata": {
"description": "The location where Power BI is hosted for your tenant"
}
},
"sku": {
"type": "string",
"allowedValues": [
"A1",
"A2",
"A3",
"A4",
"A5",
"A6"
],
"metadata": {
"description": "The pricing tier, which determines the v-core count and memory size for the capacity"
}
},
"admin": {
"type": "string",
"metadata": {
"description": "A user within your Power BI tenant, who will serve as an admin for this capacity"
}
}
},
"resources": [
{
"type": "Microsoft.PowerBIDedicated/capacities",
"apiVersion": "2021-01-01",
"name": "[parameters('name')]",
"location": "[parameters('location')]",
"sku": {
"name": "[parameters('sku')]"
},
"properties": {
"administration": {
"members": [
"[parameters('admin')]"
]
}
}
}
]
}
Implantar o modelo
Selecione o link a seguir para entrar no Azure e abrir um modelo. O modelo cria uma capacidade de Power BI Embedded.
Preencha as informações necessárias e clique em Revisar + criar.
Assinatura – a assinatura na qual você deseja criar a capacidade.
Grupo de recursos – o grupo de recursos que contém essa nova capacidade. Escolha um grupo de recursos existente ou crie outro. Para obter mais informações, confira Visão geral do Azure Resource Manager.
Região – a região à qual a capacidade pertencerá.
Nome – o nome da capacidade.
Local – o local em que o Power BI está hospedado para seu locatário. O local padrão é sua região de residência, mas você pode alterar o local usando Opções de Multi-Geo.
SKU – o SKU A necessário. Para obter mais informações, confira Memória e capacidade de computação do SKU.
Administrador – um administrador para a capacidade.
Observação
- Por padrão, o administrador de capacidade é o usuário que está criando a capacidade.
- Você pode selecionar um usuário ou entidade de serviço diferente, como um administrador de capacidade.
- O administrador de capacidade deve pertencer ao locatário em que a capacidade é provisionada. Os usuários B2B (Business to Business) não podem ser administradores de capacidade.
Validar a implantação
Para validar a implantação, faça o seguinte:
Entre no Portal do Azure.
Na caixa de pesquisa, procure Power BI Embedded.
Examine a lista de capacidades do Power BI Embedded e verifique se a capacidade que você criou está listada.
Limpar os recursos
Para excluir a capacidade que você criou, siga estas etapas:
Entre no Portal do Azure.
Na caixa de pesquisa, procure Power BI Embedded.
Abra o menu de contexto da capacidade que você criou e clique em Excluir.
Na página de confirmação, insira o nome da capacidade e clique em Excluir.
