Introdução ao PowerShell no Azure Stack Hub

  • Artigo

O PowerShell foi projetado para gerenciar e administrar recursos da linha de comando. Você pode usar o PowerShell quando quiser criar ferramentas automatizadas que usam o modelo do ARM. Um módulo do PowerShell pode ser definido como um conjunto de funções do PowerShell que são agrupadas para gerenciar todos os aspectos de uma área específica. Para trabalhar com o Azure Stack Hub, você precisa manipular vários conjuntos de cmdlets do PowerShell.

Este artigo ajuda você a entender a variedade de módulos do PowerShell usados no Azure Stack Hub. Ao usar o PowerShell no Azure Stack Hub, você pode interagir com qualquer um dos quatro conjuntos de APIs, conforme mostrado na seguinte tabela:

API Referência do PowerShell Referência REST
Global Azure Resource Manager módulos Azure PowerShell Navegador da API REST
Gerenciador de Recursos do Azure Stack Hub Gerenciar perfis de versão de API no Azure Stack Hub Gerenciar perfis de versão de API no Azure Stack Hub
Pontos de extremidade do administrador do Azure Stack Hub Módulo de administração do Azure Stack Hub [Navegador da API REST - Azure Stack Hub] (/rest/api/?term=Azure Azure Stack Administração)
Ponto de extremidade com privilégios do Azure Stack Hub Usar o ponto de extremidade privilegiado no Azure Stack Hub

Cada interface entra em contato comunica-se com provedores de recursos no Azure global ou no Azure Stack Hub. Os provedores de recursos habilitam funcionalidades do Azure. Por exemplo, o provedor de recursos de Computação do Azure fornece acesso programático à criação e ao gerenciamento de máquinas virtuais e aos respectivos recursos de suporte.

Os provedores de recursos fornecem funcionalidade e controles para gerenciar e configurar o recurso. Você pode acessar programaticamente os provedores de recursos usando o Azure Resource Manager. A interface, por sua vez, fornece uma superfície para o PowerShell, a CLI do Azure e seus próprios clientes REST.

Onde encontrar o PowerShell do Azure Stack Hub

O diagrama de bloco a seguir mostra as relações entre os conjuntos de módulos do PowerShell. No computador, você pode carregar os módulos do PowerShell e gerenciar o Azure global e o Azure Stack Hub.

PowerShell do Azure Stack Hub

Azure Global

Azure PowerShell contém um conjunto de cmdlets que usam a versão atual do Azure Resource Manager para trabalhar com seus recursos do Azure. Azure PowerShell usa a versão do .NET Standard, o que significa que você pode usar versões do PowerShell com Windows, macOS e Linux. O Azure PowerShell também está disponível no Azure Cloud Shell. Para obter mais informações, consulte Introdução ao Azure PowerShell.

Gerenciador de Recursos do Azure Stack Hub

O PowerShell do Azure Stack Hub fornece um conjunto de cmdlets que usam versões anteriores do Azure Resource Manager. Esses cmdlets são compatíveis com os provedores de recursos no Azure Stack Hub. Cada provedor de recursos no Azure Stack Hub usa uma versão mais antiga do provedor encontrada no Azure global. Para ajudar você a coordenar a versão de cada provedor com suporte pelo Azure Stack Hub, você pode usar perfis de API. Para obter mais informações, consulte Gerenciar perfis de versão da API no Azure Stack Hub.

Administrador do Azure Stack Hub

O Azure Stack Hub expõe um conjunto de provedores de recursos para o operador de nuvem para que o operador possa instalar e manter o Azure Stack Hub. No Azure global, essa interação é dissociada do usuário e manipulada em segundo plano como parte do Azure. No entanto, com o Azure Stack Hub, as empresas podem dar suporte a uma nuvem privada. Para executar essas tarefas, o operador interage com as APIs de Administração do Azure Stack Hub. Para obter mais informações, consulte Instalar o PowerShell para o Azure Stack Hub.

Ponto de extremidade com privilégios do Azure Stack Hub

Para atividades de operador no Azure Stack Hub, como testar a instalação e acessar os logs, os operadores podem interagir com o PEP (ponto de extremidade com privilégios). O PEP é um console pré-configurado do PowerShell remoto que oferece aos operadores acesso suficiente para realizar tarefas específicas. O ponto de extremidade usa o PowerShell JEA (administração Just Enough, ou administração suficiente) para expor um conjunto restrito de cmdlets. Para obter mais informações, confira usar o ponto de extremidade privilegiado no Azure Stack Hub.

Ferramentas do Azure Stack Hub

O Azure Stack Hub disponibiliza scripts e cmdlets adicionais em um repositório GitHub, AzureStack-Tools. O AzureStack-Tools hospeda módulos do PowerShell para gerenciar e implantar recursos no Azure Stack Hub. Se você estiver planejando estabelecer a conectividade VPN, poderá baixar esses módulos do PowerShell para o Kit de Desenvolvimento do Azure Stack ou para um cliente externo baseado em Windows. Para obter mais informações, acesse a página AzureStack-Tools .

Trabalhar com o PowerShell no Azure Stack Hub

O PowerShell fornece uma maneira programática de interagir com Azure Resource Manager. Você poderá trabalhar com um prompt de comando interativo ou, se estiver automatizando tarefas, poderá escrever scripts.

Se você gastar muito tempo trabalhando com o PowerShell do Azure Stack Hub, eventualmente precisará instalar e reinstalar os módulos. Se você estiver trabalhando com o Azure global ao mesmo tempo, essa rotina poderá ser desafiadora, pois você precisará desinstalar e reinstalar seus módulos dependendo do seu destino.

Você pode usar contêineres do Docker para isolar cada versão do PowerShell em seu computador local. Para usar contêineres do Docker para que você possa alternar do módulo do PowerShell definido para o conjunto de módulos do PowerShell, consulte Usar o Docker para executar o PowerShell.

Próximas etapas