Introdução ao PowerShell no Azure Stack Hub

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 de Azure Resource Manager. 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 Hub Azure Stack, você precisa manipular vários conjuntos de cmdlets do PowerShell.

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

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

Cada interface contata provedores de recursos no Azure global ou Azure Stack Hub. Os provedores de recursos habilitam recursos 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 seus 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 Azure Resource Manager. Por sua vez, a interface fornece uma superfície para o PowerShell, o CLI do Azure e seus próprios clientes REST.

Onde encontrar Azure Stack PowerShell do Hub

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

PowerShell do hub de Azure Stack

Azure Global

Azure PowerShell contém um conjunto de cmdlets que usam a versão atual do Azure Resource Manager para trabalhar com os recursos do Azure. Azure PowerShell usa a versão .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 de Hub Azure Stack

Azure Stack Hub do PowerShell 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 Hub Azure Stack. Cada provedor de recursos no Hub Azure Stack usa uma versão mais antiga do provedor encontrada no Azure global. Para ajudá-lo a coordenar a versão de cada provedor com suporte pelo Hub Azure Stack, você pode usar perfis de API. Para obter mais informações, consulte gerenciar perfis de versão da API no Hub Azure Stack.

Administrador do Hub Azure Stack

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

Ponto de extremidade com privilégios de Hub Azure Stack

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

Ferramentas de Hub de Azure Stack

Azure Stack Hub disponibiliza scripts e cmdlets adicionais em um repositório de GitHub, AzureStack-Tools. 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, vá para a página AzureStack-Tools .

Trabalhar com o PowerShell no Hub de Azure Stack

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

Se você gastar muito tempo trabalhando com o PowerShell Azure Stack Hub, você encontrará Instalando e reinstalando 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