Introdução ao PowerShell no Hub de Azure StackGet started with PowerShell in Azure Stack Hub

O PowerShell foi projetado para gerenciar e administrar recursos da linha de comando.PowerShell is designed for managing and administering resources from the command line. Você pode usar o PowerShell quando quiser criar ferramentas automatizadas que usam o modelo de Azure Resource Manager.You can use PowerShell when you want to build automated tools that use the Azure Resource Manager model. 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.A PowerShell module can be defined as a set of PowerShell functions that are grouped to manage all aspects of a particular area. Para trabalhar com o Hub Azure Stack, você precisa manipular vários conjuntos de cmdlets do PowerShell.To work with Azure Stack Hub, you need to juggle various sets of PowerShell cmdlets.

Este artigo ajuda você a se orientar na variedade de módulos do PowerShell que são usados no Hub Azure Stack.This article helps you orient yourself to the variety of PowerShell modules that are used in Azure Stack Hub. 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:When you use PowerShell in Azure Stack Hub, you can interact with any of four sets of APIs, as shown in the following table:

APIAPI Referência do PowerShellPowerShell reference Referência RESTREST reference
Azure Resource Manager globalGlobal Azure Resource Manager Módulos de Azure PowerShellAzure PowerShell modules Navegador da API RESTREST API browser
Gerenciador de recursos de Hub Azure StackAzure Stack Hub Resource Manager Gerenciar perfis de versão de API no Hub Azure StackManage API version profiles in Azure Stack Hub Gerenciar perfis de versão de API no Hub Azure StackManage API version profiles in Azure Stack Hub
Pontos de extremidade do administrador do Hub Azure StackAzure Stack Hub administrator endpoints Módulo de administração de Hub Azure StackAzure Stack Hub admin module [Navegador de API REST-Azure Stack HubREST API browser - Azure Stack Hub](/rest/api/?term=Azure Azure Stack Admin)
Ponto de extremidade com privilégios de Hub Azure StackAzure Stack Hub privileged endpoint Usar o ponto de extremidade privilegiado no Hub Azure StackUse the privileged endpoint in Azure Stack Hub

Cada interface contata provedores de recursos no Azure global ou Azure Stack Hub.Each interface contacts resource providers in global Azure or Azure Stack Hub. Os provedores de recursos habilitam recursos do Azure.Resource providers enable Azure capabilities. 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.For example, the Azure Compute resource provider gives you programmatic access to the creation and management of virtual machines and their supporting resources.

Os provedores de recursos fornecem funcionalidade e controles para gerenciar e configurar o recurso.Resource providers provide both functionality and controls for managing and configuring the resource. Você pode acessar programaticamente os provedores de recursos usando Azure Resource Manager.You can programmatically access the resource providers by using 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.In turn, the interface provides a surface for PowerShell, the Azure CLI, and your own REST clients.

Onde encontrar Azure Stack PowerShell do HubWhere to find Azure Stack Hub PowerShell

O diagrama de bloco a seguir mostra as relações entre os conjuntos de módulos do PowerShell.The following block diagram shows the relationships between the sets of PowerShell modules. Em seu computador, você pode carregar os módulos do PowerShell e gerenciar o Azure global e o Hub de Azure Stack.From your machine, you can load the PowerShell modules and manage both global Azure and Azure Stack Hub.

PowerShell do hub de Azure Stack

Azure GlobalGlobal Azure

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 contains a set of cmdlets that use the current version of Azure Resource Manager for working with your Azure resources. Azure PowerShell usa a versão .NET Standard, o que significa que você pode usar versões do PowerShell com Windows, macOS e Linux.Azure PowerShell uses the .NET Standard version, which means that you can use versions of PowerShell with Windows, macOS, and Linux. O Azure PowerShell também está disponível no Azure Cloud Shell.Azure PowerShell is also available on Azure Cloud Shell. Para obter mais informações, consulte Introdução ao Azure PowerShell.For more information, see Get started with Azure PowerShell.

Gerenciador de recursos de Hub Azure StackAzure Stack Hub Resource Manager

Azure Stack Hub do PowerShell fornece um conjunto de cmdlets que usam versões anteriores do Azure Resource Manager.Azure Stack Hub PowerShell provides a set of cmdlets that use previous versions of Azure Resource Manager. Esses cmdlets são compatíveis com os provedores de recursos no Hub Azure Stack.These cmdlets are compatible with the resource providers in Azure Stack Hub. Cada provedor de recursos no Hub Azure Stack usa uma versão mais antiga do provedor encontrada no Azure global.Each resource provider in Azure Stack Hub uses an older version of the provider found in global Azure. Para ajudá-lo a coordenar a versão de cada provedor com suporte pelo Hub Azure Stack, você pode usar perfis de API.To help you coordinate the version of each provider that's supported by Azure Stack Hub, you can use API profiles. Para obter mais informações, consulte gerenciar perfis de versão da API no Hub Azure Stack.For more information, see Manage API version profiles in Azure Stack Hub.

Administrador do Hub Azure StackAzure Stack Hub administrator

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.Azure Stack Hub exposes a set of resource providers to the cloud operator so that the operator can install and maintain Azure Stack Hub. No Azure global, essa interação é dissociada do usuário e manipulada em segundo plano como parte do Azure.In global Azure, this interaction is abstracted from the user and handled behind the scenes as part of Azure. Com hub de Azure Stack; no entanto, as empresas podem dar suporte a uma nuvem privada.With Azure Stack Hub; however, enterprises can support a private cloud. Para executar essas tarefas, o operador interage com as APIs de administração do Hub Azure Stack.To do these tasks, the operator interacts with the Azure Stack Hub Admin APIs. Para obter mais informações, consulte instalar o PowerShell para Azure Stack Hub.For more information, see Install PowerShell for Azure Stack Hub.

Ponto de extremidade com privilégios de Hub Azure StackAzure Stack Hub privileged endpoint

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).For operator activities in Azure Stack Hub, such as testing the installation and accessing logs, operators can interact with the privileged endpoint (PEP). O PEP é um console do PowerShell remoto pré-configurado que oferece aos operadores acesso suficiente a tarefas específicas.The PEP is a pre-configured remote PowerShell console that gives operators enough access to do specific tasks. O ponto de extremidade usa a administração do PowerShell apenas (JEA) para expor um conjunto restrito de cmdlets.The endpoint uses PowerShell Just Enough Administration (JEA) to expose a restricted set of cmdlets. Para obter mais informações, confira usar o ponto de extremidade privilegiado no Azure Stack Hub.For more information, see Use the privileged endpoint in Azure Stack Hub.

Ferramentas de Hub de Azure StackAzure Stack Hub Tools

Azure Stack Hub torna scripts e cmdlets adicionais disponíveis em um repositório GitHub, AzureStack-Tools.Azure Stack Hub makes scripts and additional cmdlets available in a GitHub repository, AzureStack-Tools. AzureStack-Tools hospeda módulos do PowerShell para gerenciar e implantar recursos no Azure Stack Hub.AzureStack-Tools hosts PowerShell modules for managing and deploying resources to 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 no Windows.If you're planning to establish VPN connectivity, you can download these PowerShell modules to the Azure Stack Development Kit, or to a Windows-based external client. Para obter mais informações, vá para a página AzureStack-Tools .For more information, go to the AzureStack-Tools page.

Trabalhar com o PowerShell no Hub de Azure StackWork with PowerShell in Azure Stack Hub

O PowerShell fornece uma maneira programática de interagir com Azure Resource Manager.PowerShell provides a programmatic way to interact with Azure Resource Manager. Você pode trabalhar com um prompt de comando interativo ou, se estiver automatizando tarefas, pode escrever scripts.You can work with an interactive command prompt or, if you're automating tasks, you can write scripts.

Se você gastar muito tempo trabalhando com o PowerShell Azure Stack Hub, você encontrará Instalando e reinstalando os módulos.If you spend much time working with Azure Stack Hub PowerShell, you'll find yourself installing and reinstalling the modules. 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.If you're working with global Azure at the same time, this routine can be challenging, because you'll need to uninstall and reinstall your modules depending on your target.

Você pode usar contêineres do Docker para isolar cada versão do PowerShell em seu computador local.You can use Docker containers to isolate each version of PowerShell on your local machine. 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.To use Docker containers so that you can switch from PowerShell module set to PowerShell module set, see Use Docker to run PowerShell.

Próximas etapasNext steps