Partilhar via


Configurações pós-implantação para ASDK

Depois de instalar o Azure Stack Development Kit (ASDK), você deve fazer algumas alterações de configuração pós-implantação recomendadas enquanto estiver conectado como AzureStack\AzureStackAdmin no computador host ASDK.

Instalar o Azure Stack PowerShell

Os módulos do Azure PowerShell compatíveis com o Azure Stack são necessários para trabalhar com o Azure Stack.

Os comandos do PowerShell para o Azure Stack são instalados por meio da Galeria do PowerShell. Para registrar o repositório do PSGallery, abra uma sessão do PowerShell com privilégios elevados e execute o seguinte comando:

Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

Use perfis de versão da API para especificar módulos Az compatíveis com o Azure Stack. Os perfis de versão da API fornecem uma maneira de gerenciar as diferenças de versão entre o Azure e o Azure Stack. Um perfil de versão da API é um conjunto de módulos do Az PowerShell com versões específicas da API. O módulo Az.BootStrapper que está disponível por meio da Galeria do PowerShell fornece cmdlets do PowerShell necessários para lidar com perfis de versões da API.

Você pode instalar o módulo PowerShell do Azure Stack mais recente com ou sem conectividade com a Internet para o computador host ASDK.

  1. Valide seus pré-requisitos em sua máquina Windows. Para obter instruções, consulte Pré-requisitos para o Windows.
  2. Antes de instalar a versão necessária do PowerShell, certifique-se de desinstalar todos os módulos existentes do Azure PowerShell.
  • Com um de conexão com a Internet do computador host ASDK: Execute o seguinte script do PowerShell para instalar esses módulos em sua instalação ASDK:
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

  Install-Module -Name Az.BootStrapper -Force
  Install-AzProfile -Profile 2020-09-01-hybrid -Force
  Install-Module -Name AzureStack -RequiredVersion 2.1.0

  Get-Module -Name "Az*" -ListAvailable
  Get-Module -Name "Azs*" -ListAvailable

Se a instalação for bem-sucedida, os módulos Az e AzureStack serão exibidos na saída.

  • Sem um de conexão com a Internet do computador host ASDK: Em um cenário desconectado, você deve primeiro baixar os módulos do PowerShell para uma máquina que tenha conectividade com a Internet usando os seguintes comandos do PowerShell:
$Path = "<Path that is used to save the packages>"

Save-Package `
  -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name Az -Path $Path -Force -RequiredVersion 1.10.0

Save-Package `
  -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 2.1.0

Em seguida, copie os pacotes baixados para o computador ASDK e registre o local como o repositório padrão e instale os módulos Az e AzureStack a partir deste repositório:

$SourceLocation = "<Location on the development kit that contains the PowerShell packages>"
$RepoName = "MyNuGetSource"

Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted

Install-Module Az -Repository $RepoName

Install-Module AzureStack -Repository $RepoName

Baixe as ferramentas do Azure Stack

AzureStack-Tools é um repositório GitHub que hospeda módulos do PowerShell para gerenciar e implantar recursos no Azure Stack. Você usa as ferramentas usando os módulos do Az PowerShell ou os módulos do AzureRM.

Para obter essas ferramentas, clone o repositório GitHub da ramificação ou baixe a pasta AzureStack-Tools executando o seguinte script:

# Change directory to the root directory.
cd \

# Download the tools archive.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 
invoke-webrequest `
  https://github.com/Azure/AzureStack-Tools/archive/az.zip `
  -OutFile az.zip

# Expand the downloaded files.
expand-archive az.zip `
  -DestinationPath . `
  -Force

# Change to the tools directory.
cd AzureStack-Tools-az

Validar a instalação do ASDK

Para garantir que sua implantação ASDK foi bem-sucedida, use o cmdlet Test-AzureStack seguindo estas etapas:

  1. Inicie sessão como AzureStack\AzureStackAdmin no servidor host ASDK.
  2. Abra o PowerShell como administrador (não o PowerShell ISE).
  3. Execução: Enter-PSSession -ComputerName AzS-ERCS01 -ConfigurationName PrivilegedEndpoint
  4. Execução: Test-AzureStack

Os testes levam alguns minutos para serem concluídos. Se a instalação foi bem-sucedida, a saída será algo como:

Test Azure Stack - Instalação bem-sucedida

Se houve uma falha, siga as etapas de solução de problemas para obter ajuda.

Habilite a multilocação

Para implantações usando o Microsoft Entra ID, você precisa habilitar de multilocação para sua instalação ASDK.

Observação

Quando contas de administrador ou de usuário de domínios diferentes daquele usado para registrar o Azure Stack são usadas para fazer logon em um portal do Azure Stack, o nome de domínio usado para registrar o Azure Stack deve ser anexado à URL do portal. Por exemplo, se o Azure Stack estiver registado com fabrikam.onmicrosoft.com e a conta de utilizador para iniciar sessão for admin@contoso.com, o URL a utilizar para entrar no portal do utilizador será: https://portal.local.azurestack.external/fabrikam.onmicrosoft.com.

Próximos passos

Registrar o ASDK com Azure