Configurações pós-implantação para ASDKPost deployment configurations for ASDK

Depois de instalar o kit de desenvolvimento do Azure Stack (ASDK), você deve fazer algumas alterações de configuração de pós-implantação recomendadas enquanto estiver conectado como AzureStack\AzureStackAdmin no computador host ASDK.After you install the Azure Stack Development Kit (ASDK), you should make a few recommended post deployment configuration changes while signed in as AzureStack\AzureStackAdmin on the ASDK host computer.

Instalar o PowerShell do Azure StackInstall Azure Stack PowerShell

Azure Stack módulos Azure PowerShell compatíveis são necessários para trabalhar com Azure Stack.Azure Stack compatible Azure PowerShell modules are required to work with Azure Stack.

Os comandos do PowerShell para Azure Stack são instalados por meio do Galeria do PowerShell.PowerShell commands for Azure Stack are installed through the PowerShell Gallery. Para registrar o repositório PSGallery, abra uma sessão do PowerShell com privilégios elevados e execute o seguinte comando:To register the PSGallery repository, open an elevated PowerShell session and run the following command:

Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

Use perfis de versão de API para especificar Azure Stack módulos AZ compatíveis.Use API version profiles to specify Azure Stack compatible Az modules. Os perfis de versão de API fornecem uma maneira de gerenciar diferenças de versão entre o Azure e o Azure Stack.API version profiles provide a way to manage version differences between Azure and Azure Stack. Um perfil de versão de API é um conjunto de módulos AZ PowerShell com versões de API específicas.An API version profile is a set of Az PowerShell modules with specific API versions. O módulo AZ. Bootstrapper que está disponível por meio do Galeria do PowerShell fornece cmdlets do PowerShell que são necessários para trabalhar com perfis de versão de API.The Az.BootStrapper module that's available through the PowerShell Gallery provides PowerShell cmdlets that are required to work with API version profiles.

Você pode instalar o mais recente Azure Stack módulo do PowerShell com ou sem conectividade com a Internet para o computador host ASDK:You can install the latest Azure Stack PowerShell module with or without internet connectivity to the ASDK host computer:

Importante

Antes de instalar a versão necessária, certifique-se de desinstalar os módulos existentes do Azure PowerShell.Before installing the required version, make sure that you uninstall any existing Azure PowerShell modules.

  • Com uma conexão com a Internet do computador host ASDK: execute o seguinte script do PowerShell para instalar esses módulos em sua instalação do ASDK:With an internet connection from the ASDK host computer: Run the following PowerShell script to install these modules on your ASDK installation:
Get-Module -Name Azs.* -ListAvailable | Uninstall-Module -Force -Verbose
Get-Module -Name Azure* -ListAvailable | Uninstall-Module -Force -Verbose

# Install the Az.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name Az.BootStrapper

# Install and import the API Version Profile required by Azure Stack into the current PowerShell session.
Use-AzProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 2.0.2-preview -AllowPrerelease

Se a instalação for bem-sucedida, os módulos AZ e AzureStack serão exibidos na saída.If the installation is successful, the Az and AzureStack modules are displayed in the output.

  • Sem uma conexão com a Internet do computador host ASDK: em um cenário desconectado, você deve primeiro baixar os módulos do PowerShell para um computador que tenha conectividade com a Internet usando os seguintes comandos do PowerShell:Without an internet connection from the ASDK host computer: In a disconnected scenario, you must first download the PowerShell modules to a machine that has internet connectivity using the following PowerShell commands:
$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 2.3.0

Save-Package `
  -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.5.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 deste repositório:Next, copy the downloaded packages to the ASDK computer and register the location as the default repository and install the Az and AzureStack modules from this repository:

$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

Baixar as ferramentas de Azure StackDownload the Azure Stack tools

AzureStack-Tools é um repositório GitHub que hospeda módulos do PowerShell para gerenciar e implantar recursos no Azure Stack.AzureStack-Tools is a GitHub repository that hosts PowerShell modules for managing and deploying resources to Azure Stack. Use as ferramentas usando os módulos AZ PowerShell ou os módulos AzureRM.You use the tools using the Az PowerShell modules, or the AzureRM modules.

Para obter essas ferramentas, clone o repositório GitHub do az Branch ou baixe a pasta AzureStack-Tools executando o seguinte script:To get these tools, clone the GitHub repository from the az branch or download the AzureStack-Tools folder by running the following 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 ASDKValidate the ASDK installation

Para garantir que a implantação do ASDK foi bem-sucedida, use o cmdlet Test-AzureStack seguindo estas etapas:To ensure that your ASDK deployment was successful, use the Test-AzureStack cmdlet by following these steps:

  1. Entre como AzureStack\AzureStackAdmin no computador host do ASDK.Sign in as AzureStack\AzureStackAdmin on the ASDK host computer.
  2. Abra o PowerShell como administrador (não ISE do PowerShell).Open PowerShell as an admin (not PowerShell ISE).
  3. Execute: Enter-PSSession -ComputerName AzS-ERCS01 -ConfigurationName PrivilegedEndpointRun: Enter-PSSession -ComputerName AzS-ERCS01 -ConfigurationName PrivilegedEndpoint
  4. Execute: Test-AzureStackRun: Test-AzureStack

Os testes levam alguns minutos para serem concluídos.The tests take a few minutes to complete. Se a instalação tiver sido bem-sucedida, a saída será semelhante a:If the installation was successful, the output looks something like:

Azure Stack de teste-instalação bem-sucedida

Se houve uma falha, siga as etapas de solução de problemas para obter ajuda.If there was a failure, follow the troubleshooting steps to get help.

Habilitar multilocaçãoEnable multi-tenancy

Para implantações usando o Azure AD, você precisa habilitar a multilocação para a instalação do ASDK.For deployments using Azure AD, you need to enable multi-tenancy for your ASDK installation.

Observação

Quando as contas de usuário ou administrador de domínios diferentes daquelas usadas para registrar Azure Stack são usadas para fazer logon em um portal de Azure Stack, o nome de domínio usado para registrar Azure Stack deve ser anexado à URL do Portal.When admin or user accounts from domains other than the one used to register Azure Stack are used to log in to an Azure Stack portal, the domain name used to register Azure Stack must be appended to the portal URL. Por exemplo, se Azure Stack tiver sido registrado com fabrikam.onmicrosoft.com e o logon da conta de usuário no for admin@contoso.com , a URL a ser usada para fazer logon no portal do usuário será: https : //Portal.local.azurestack.external/fabrikam.onmicrosoft.com.For example, if Azure Stack has been registered with fabrikam.onmicrosoft.com and the user account logging in is admin@contoso.com, the URL to use to log in to the user portal would be: https://portal.local.azurestack.external/fabrikam.onmicrosoft.com.

Próximas etapasNext steps

Registrar o ASDK com o AzureRegister the ASDK with Azure