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

PowerShell foi concebido para gerir e administrar recursos a partir da linha de comando.PowerShell is designed for managing and administering resources from the command line. Pode utilizar o PowerShell quando pretender construir ferramentas automatizadas que utilizem o modelo Azure Resource Manager.You can use PowerShell when you want to build automated tools that use the Azure Resource Manager model. Um módulo PowerShell pode ser definido como um conjunto de funções PowerShell que são agrupadas para gerir todos os aspetos de uma determinada área.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 Azure Stack Hub, você precisa fazer malabarismos com vários conjuntos de cmdlets PowerShell.To work with Azure Stack Hub, you need to juggle various sets of PowerShell cmdlets.

Este artigo ajuda-o a orientar-se para a variedade de módulos PowerShell que são usados no Azure Stack Hub.This article helps you orient yourself to the variety of PowerShell modules that are used in Azure Stack Hub. Quando utilizar o PowerShell no Azure Stack Hub, pode interagir com qualquer um dos quatro conjuntos de APIs, como mostra a seguinte tabela: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
Global Azure Resource ManagerGlobal Azure Resource Manager dos módulos do Azure PowerShellAzure PowerShell modules Navegador REST APIREST API browser
Gestor de recursos do hub de pilha de AzureAzure Stack Hub Resource Manager Gerir perfis de versão API no Azure Stack HubManage API version profiles in Azure Stack Hub Gerir perfis de versão API no Azure Stack HubManage API version profiles in Azure Stack Hub
Pontos finais do administrador do Azure Stack HubAzure Stack Hub administrator endpoints Módulo de administração Azure Stack HubAzure Stack Hub admin module [RESE O navegador API - Azure Stack HubREST API browser - Azure Stack Hub](/rest/api/?term=Azure Azure Stack Admin)
Ponta final privilegiada do Azure Stack HubAzure Stack Hub privileged endpoint Use o ponto final privilegiado no Azure Stack HubUse the privileged endpoint in Azure Stack Hub

Cada interface contacta fornecedores de recursos no Azure global ou no Azure Stack Hub.Each interface contacts resource providers in global Azure or Azure Stack Hub. Os fornecedores de recursos permitem capacidades Azure.Resource providers enable Azure capabilities. Por exemplo, o fornecedor de recursos Azure Compute dá-lhe acesso programático à criação e gestão de máquinas virtuais e seus recursos de apoio.For example, the Azure Compute resource provider gives you programmatic access to the creation and management of virtual machines and their supporting resources.

Os fornecedores de recursos fornecem funcionalidade e controlos para gerir e configurar o recurso.Resource providers provide both functionality and controls for managing and configuring the resource. Pode aceder programáticamente aos fornecedores de recursos utilizando o 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 Azure CLI e os 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 Hub PowerShellWhere to find Azure Stack Hub PowerShell

O diagrama de blocos seguinte mostra as relações entre os conjuntos de módulos PowerShell.The following block diagram shows the relationships between the sets of PowerShell modules. A partir da sua máquina, pode carregar os módulos PowerShell e gerir o Azure global e o Azure Stack Hub.From your machine, you can load the PowerShell modules and manage both global Azure and Azure Stack Hub.

Azure Stack Hub PowerShell

Global AzureGlobal Azure

O Azure PowerShell contém um conjunto de cmdlets que utilizam a versão atual do Azure Resource Manager para trabalhar com os seus recursos Azure.Azure PowerShell contains a set of cmdlets that use the current version of Azure Resource Manager for working with your Azure resources. O Azure PowerShell utiliza a versão .NET Standard, o que significa que pode utilizar 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, veja Introdução ao Azure PowerShell.For more information, see Get started with Azure PowerShell.

Gestor de recursos do hub de pilha de AzureAzure Stack Hub Resource Manager

Azure Stack Hub PowerShell fornece um conjunto de cmdlets que utilizam versões anteriores do Azure Resource Manager.Azure Stack Hub PowerShell provides a set of cmdlets that use previous versions of Azure Resource Manager. Estes cmdlets são compatíveis com os fornecedores de recursos no Azure Stack Hub.These cmdlets are compatible with the resource providers in Azure Stack Hub. Cada fornecedor de recursos no Azure Stack Hub utiliza uma versão mais antiga do fornecedor 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 fornecedor que é suportado pelo Azure Stack Hub, pode utilizar perfis 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 os perfis de versão API em Azure Stack Hub.For more information, see Manage API version profiles in Azure Stack Hub.

Administrador do Azure Stack HubAzure Stack Hub administrator

O Azure Stack Hub expõe um conjunto de fornecedores de recursos ao operador de nuvem para que o operador possa instalar e manter o Azure Stack Hub.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, esta interação é abstrata do utilizador e tratada nos bastidores como parte do Azure.In global Azure, this interaction is abstracted from the user and handled behind the scenes as part of Azure. Com Azure Stack Hub; no entanto, as empresas podem suportar uma nuvem privada.With Azure Stack Hub; however, enterprises can support a private cloud. Para fazer estas tarefas, o operador interage com as APIs Admin hub Azure Stack.To do these tasks, the operator interacts with the Azure Stack Hub Admin APIs. Para obter mais informações, consulte Instalar PowerShell para Azure Stack Hub.For more information, see Install PowerShell for Azure Stack Hub.

Ponta final privilegiada do Azure Stack HubAzure Stack Hub privileged endpoint

Para as atividades do operador no Azure Stack Hub, como testar a instalação e aceder a registos, os operadores podem interagir com o ponto final 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 é uma consola remota pré-configurada PowerShell que dá aos operadores acesso suficiente para fazer tarefas específicas.The PEP is a pre-configured remote PowerShell console that gives operators enough access to do specific tasks. O ponto final utiliza a PowerShell Just Enough Administration (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, veja Utilizar o ponto final privilegiado no Azure Stack Hub.For more information, see Use the privileged endpoint in Azure Stack Hub.

Ferramentas do hub Azure StackAzure Stack Hub Tools

Azure Stack Hub disponibiliza scripts e cmdlets adicionais num repositório GitHub, AzureStack-Tools.Azure Stack Hub makes scripts and additional cmdlets available in a GitHub repository, AzureStack-Tools. AzureStack-Tools acolhe módulos PowerShell para gerir e implantar recursos para o Azure Stack Hub.AzureStack-Tools hosts PowerShell modules for managing and deploying resources to Azure Stack Hub. Se estiver a planear estabelecer conectividade VPN, pode transferir estes módulos PowerShell para o Kit de Desenvolvimento da Pilha Azure 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 mais informações, aceda à página AzureStack-Tools.For more information, go to the AzureStack-Tools page.

Trabalhar com PowerShell no Azure Stack HubWork with PowerShell in Azure Stack Hub

O PowerShell fornece uma forma programática de interagir com o Azure Resource Manager.PowerShell provides a programmatic way to interact with Azure Resource Manager. Pode trabalhar com uma solicitação de comando interativo ou, se estiver a automatizar tarefas, pode escrever scripts.You can work with an interactive command prompt or, if you're automating tasks, you can write scripts.

Se passar muito tempo a trabalhar com o Azure Stack Hub PowerShell, vai encontrar-se a instalar e reinstalar os módulos.If you spend much time working with Azure Stack Hub PowerShell, you'll find yourself installing and reinstalling the modules. Se estiver a trabalhar com o Global Azure ao mesmo tempo, esta rotina pode ser um desafio, porque terá de desinstalar e reinstalar os seus módulos dependendo do seu alvo.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.

Pode utilizar recipientes Docker para isolar cada versão do PowerShell na sua máquina local.You can use Docker containers to isolate each version of PowerShell on your local machine. Para utilizar os recipientes Docker para que possa mudar do módulo PowerShell para o conjunto do módulo PowerShell, consulte Use 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.

Passos seguintesNext steps