Implementar ASDK a partir da linha de comando usando PowerShellDeploy ASDK from the command line using PowerShell

O Azure Stack Development Kit (ASDK) é um ambiente de testes e desenvolvimento que pode implementar para avaliar e demonstrar funcionalidades e serviços do Azure Stack.The Azure Stack Development Kit (ASDK) is a testing and development environment that you can deploy to evaluate and demonstrate Azure Stack features and services. Para o pôr a funcionar, tens de preparar o hardware ambiental e executar alguns scripts.To get it up and running, you need to prepare the environment hardware and run some scripts. Os guiões demoram várias horas a ser executados.The scripts take several hours to run. Depois disso, pode iniciar seduca nos portais de administração e utilizador para começar a usar Azure Stack.After that, you can sign in to the admin and user portals to start using Azure Stack.

Pré-requisitosPrerequisites

Prepare o computador anfitrião ASDK.Prepare the ASDK host computer. Planeie o seu hardware, software e rede.Plan your hardware, software, and network. O computador que acolhe o ASDK deve satisfazer os requisitos de hardware, software e rede.The computer that hosts the ASDK must meet hardware, software, and network requirements. Escolha entre a utilização do Azure Ative Directory (Azure AD) ou dos Serviços da Federação de Diretórios Ativos (AD FS).Choose between using Azure Active Directory (Azure AD) or Active Directory Federation Services (AD FS). Certifique-se de que segue estes pré-requisitos antes de iniciar a sua colocação de modo a que o processo de instalação decorra sem problemas.Be sure to follow these prerequisites before starting your deployment so that the installation process runs smoothly.

Antes de implementar o ASDK, certifique-se de que o hardware, sistema operativo, conta e configurações de rede do seu computador anfitrião asdK planeado satisfazem os requisitos mínimos para a instalação do ASDK.Before you deploy the ASDK, make sure your planned ASDK host computer's hardware, operating system, account, and network configurations meet the minimum requirements for installing the ASDK.

Reveja os requisitos e considerações de implantação da ASDK.Review the ASDK deployment requirements and considerations.

Descarregue e extraia o pacote de implementaçãoDownload and extract the deployment package

Depois de garantir que o seu computador anfitrião ASDK satisfaz os requisitos básicos para instalar o ASDK, o próximo passo é descarregar e extrair o pacote de implementação ASDK.After ensuring that your ASDK host computer meets the basic requirements for installing the ASDK, the next step is to download and extract the ASDK deployment package. O pacote de implementação inclui o ficheiro Cloudbuilder.vhdx, que é um disco rígido virtual que inclui um sistema operativo inicializável e os ficheiros de instalação do Azure Stack.The deployment package includes the Cloudbuilder.vhdx file, which is a virtual hard drive that includes a bootable operating system and the Azure Stack installation files.

Pode baixar o pacote de implementação para o anfitrião ASDK ou para outro computador.You can download the deployment package to the ASDK host or to another computer. Os ficheiros de implementação extraídos assumem 60 GB de espaço livre em disco, pelo que a utilização de outro computador pode ajudar a reduzir os requisitos de hardware para o hospedeiro ASDK.The extracted deployment files take up 60 GB of free disk space, so using another computer can help reduce the hardware requirements for the ASDK host.

Descarregue e extrate o Kit de Desenvolvimento da Pilha de Azure (ASDK)Download and extract the Azure Stack Development Kit (ASDK)

Preparar o computador anfitrião do ASDKPrepare the ASDK host computer

Antes de poder instalar o ASDK no computador anfitrião, o ambiente deve estar preparado e o sistema configurado para arrancar a partir de VHD.Before you can install the ASDK on the host computer, the environment must be prepared and the system configured to boot from VHD. Após este passo, o anfitrião ASDK irá arrancar para o Cloudbuilder.vhdx (um disco rígido virtual que inclui um sistema operativo bootable e os ficheiros de instalação Azure Stack).After this step, the ASDK host will boot to the Cloudbuilder.vhdx (a virtual hard drive that includes a bootable operating system and the Azure Stack installation files).

Utilize o PowerShell para configurar o computador anfitrião ASDK para arrancar a partir de CloudBuilder.vhdx.Use PowerShell to configure the ASDK host computer to boot from CloudBuilder.vhdx. Estes comandos configuram o seu computador anfitrião ASDK para arrancar a partir do harddisk virtual Azure Stack descarregado e extraído (CloudBuilder.vhdx).These commands configure your ASDK host computer to boot from the downloaded and extracted Azure Stack virtual harddisk (CloudBuilder.vhdx). Após completar estes passos, reinicie o computador anfitrião ASDK.After completing these steps, restart the ASDK host computer.

Para configurar o computador anfitrião ASDK para arrancar a partir de CloudBuilder.vhdx:To configure the ASDK host computer to boot from CloudBuilder.vhdx:

  1. Lance um pedido de comando como administrador.Launch a command prompt as admin.
  2. Execute bcdedit /copy {current} /d "Azure Stack".Run bcdedit /copy {current} /d "Azure Stack".
  3. Copiar (CTRL+C) o valor CLSID devolvido, incluindo os suportes curvos necessários {} ().Copy (CTRL+C) the CLSID value returned, including the required curly brackets ({}). Este valor é referido como {CLSID} e precisa de ser colado em (CTRL+V ou clique à direita) nos passos restantes.This value is referred to as {CLSID} and needs to be pasted in (CTRL+V or right-click) in the remaining steps.
  4. Execute bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.Run bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.
  5. Execute bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.Run bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.
  6. Execute bcdedit /set {CLSID} detecthal on.Run bcdedit /set {CLSID} detecthal on.
  7. Execute bcdedit /default {CLSID}.Run bcdedit /default {CLSID}.
  8. Para verificar as definições do arranque, corra bcdedit .To verify boot settings, run bcdedit.
  9. Certifique-se de que o ficheiro CloudBuilder.vhdx foi movido para a raiz do C:\ unidade C:\CloudBuilder.vhdx () e reinicie o computador anfitrião ASDK.Ensure that the CloudBuilder.vhdx file has been moved to the root of the C:\ drive (C:\CloudBuilder.vhdx) and restart the ASDK host computer. Quando o computador anfitrião ASDK for reiniciado, deve arrancar a partir do disco rígido virtual CloudBuilder.vhdx (VM) para iniciar a implantação da ASDK.When the ASDK host computer is restarted, it should boot from the CloudBuilder.vhdx virtual machine (VM) hard drive to begin ASDK deployment.

Importante

Certifique-se de que tem acesso físico ou KVM direto ao computador anfitrião ASDK antes de reiniciá-lo.Ensure that you have direct physical or KVM access to the ASDK host computer before restarting it. Quando o VM começa, solicita-lhe que complete a configuração do servidor do Windows.When the VM first starts, it prompts you to complete Windows Server Setup. Forneça as mesmas credenciais de administração que usou para iniciar sessão no computador anfitrião ASDK.Provide the same admin credentials you used to log into the ASDK host computer.

Prepare o anfitrião ASDK usando PowerShellPrepare the ASDK host using PowerShell

Depois de o computador anfitrião ASDK ter entrado com sucesso na imagem CloudBuilder.vhdx, inicie sessão com as mesmas credenciais de administração local que usou para iniciar sessão no computador anfitrião ASDK.After the ASDK host computer successfully boots into the CloudBuilder.vhdx image, sign in with the same local admin credentials you used to log into the ASDK host computer. Estas são também as mesmas credenciais que forneceu como parte do preenchimento da Configuração do Servidor do Windows quando o computador anfitrião foi iniciado a partir de VHD.These are also the same credentials you provided as part of completing the Windows Server Setup when the host computer booted from VHD.

Nota

Opcionalmente, também pode configurar as definições de telemetria Azure Stack antes de instalar o ASDK.Optionally, you can also configure Azure Stack telemetry settings before installing the ASDK.

Abra uma consola PowerShell elevada e execute os comandos nesta secção para implantar o ASDK no anfitrião ASDK.Open an elevated PowerShell console and run the commands in this section to deploy the ASDK on the ASDK host.

Importante

A instalação ASDK suporta exatamente um cartão de interface de rede (NIC) para networking.ASDK installation supports exactly one network interface card (NIC) for networking. Se tiver vários NICs, certifique-se de que apenas um está ativado (e todos os outros estão desativados) antes de executar o script de implementação.If you have multiple NICs, make sure that only one is enabled (and all others are disabled) before running the deployment script.

Pode implementar o Azure Stack com Azure AD ou Windows Server AD FS como fornecedor de identidade.You can deploy Azure Stack with Azure AD or Windows Server AD FS as the identity provider. Azure Stack, fornecedores de recursos e outras aplicações funcionam da mesma forma com ambas.Azure Stack, resource providers, and other apps work the same way with both.

Dica

Se não fornecer parâmetros de configuração (ver InstallAzureStackPOC.ps1 parâmetros e exemplos opcionais abaixo), é solicitado para os parâmetros necessários.If you don't supply any setup parameters (see InstallAzureStackPOC.ps1 optional parameters and examples below), you're prompted for the required parameters.

Implementar Azure Stack usando Azure ADDeploy Azure Stack using Azure AD

Para implementar a Azure Stack utilizando o Azure AD como fornecedor de identidade, tem de ter conectividade na Internet, quer diretamente quer através de um representante transparente.To deploy Azure Stack using Azure AD as the identity provider, you must have internet connectivity either directly or through a transparent proxy.

Executar os seguintes comandos PowerShell para implantar o ASDK utilizando a Azure AD:Run the following PowerShell commands to deploy the ASDK using Azure AD:

cd C:\CloudDeployment\Setup     
$adminpass = Get-Credential Administrator     
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password

A poucos minutos da instalação da ASDK, você será solicitado para credenciais AZure AD.A few minutes into ASDK installation you'll be prompted for Azure AD credentials. Forneça as credenciais de administração global para o seu inquilino AZure AD.Provide the global admin credentials for your Azure AD tenant.

Após a implementação, a permissão de administração global do Azure Ative Directory não é necessária.After deployment, Azure Active Directory global admin permission isn't required. No entanto, algumas operações podem requerer a credencial de administração global.However, some operations may require the global admin credential. Exemplos de tais operações incluem um script de instalador de recursos ou um novo recurso que requer permissão para ser concedido.Examples of such operations include a resource provider installer script or a new feature requiring a permission to be granted. Pode restabelecer temporariamente as permissões de administração global da conta ou utilizar uma conta de administração global separada que seja proprietária da subscrição do fornecedor predefinido.You can either temporarily reinstate the account's global admin permissions or use a separate global admin account that's an owner of the default provider subscription.

Implementar Azure Stack usando AD FSDeploy Azure Stack using AD FS

Para implementar o ASDK utilizando o AD FS como fornecedor de identidade, executar os seguintes comandos PowerShell (basta adicionar o parâmetro -UseADFS):To deploy the ASDK using AD FS as the identity provider, run the following PowerShell commands (you just need to add the -UseADFS parameter):

cd C:\CloudDeployment\Setup     
$adminpass = Get-Credential Administrator 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -UseADFS

Nas implementações de FS AD, o Serviço de Diretório de Selos predefinidos é utilizado como fornecedor de identidade.In AD FS deployments, the default stamp Directory Service is used as the identity provider. A conta predefinida para iniciar scontabilidade é azurestackadmin@azurestack.local , e a palavra-passe é definida como parte dos comandos de configuração PowerShell.The default account to sign in with is azurestackadmin@azurestack.local, and the password is set to what you provided as part of the PowerShell setup commands.

O processo de implementação pode demorar algumas horas, período durante o qual o sistema reinicia automaticamente uma vez.The deployment process can take a few hours, during which time the system automatically reboots once. Quando a implementação tiver sucesso, a consola PowerShell apresenta: COMPLETA: Ação 'Implantação'.When the deployment succeeds, the PowerShell console displays: COMPLETE: Action 'Deployment'. Se a implementação falhar, tente executar novamente o script utilizando o parâmetro de re-repetição.If the deployment fails, try running the script again using the -rerun parameter. Ou, pode recolocar o ASDK do zero.Or, you can redeploy ASDK from scratch.

Importante

Se quiser monitorizar o progresso da implementação após o reinício do anfitrião ASDK, tem de iniciar sessão como AzureStackAdmin.If you want to monitor the deployment progress after the ASDK host reboots, you must sign in as AzureStack\AzureStackAdmin. Se iniciar sessão como administrador local após o reinício do computador anfitrião (e se juntar ao domínio azurestack.local), não verá o progresso da implementação.If you sign in as a local admin after the host computer is restarted (and joined to the azurestack.local domain), you won't see the deployment progress. Não reencaminhe a implementação, em vez disso, inscreva-se como AzureStack\AzureStackAdmin com a mesma palavra-passe que o administrador local para validar que a configuração está em execução.Don't rerun deployment, instead sign in as AzureStack\AzureStackAdmin with the same password as the local admin to validate that the setup is running.

Exemplos de scripts de implementação AD AZureAzure AD deployment script examples

Pode escrever toda a implementação da AD Azure.You can script the entire Azure AD deployment. Aqui estão alguns exemplos comentados que incluem alguns parâmetros opcionais.Here are a few commented examples that include some optional parameters.

Se a sua identidade AD Azure estiver apenas associada a um diretório AD Azure:If your Azure AD identity is only associated with one Azure AD directory:

cd C:\CloudDeployment\Setup 
$adminpass = Get-Credential Administrator 
$aadcred = Get-Credential "<Azure AD global administrator account name>" 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 52.168.138.145 #Example time server IP address.

Se a sua identidade AD AZure estiver associada a um diretório AD maior do que um Azure:If your Azure AD identity is associated with greater than one Azure AD directory:

cd C:\CloudDeployment\Setup 
$adminpass = Get-Credential Administrator 
$aadcred = Get-Credential "<Azure AD global administrator account name>" #Example: user@AADDirName.onmicrosoft.com 
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -InfraAzureDirectoryTenantName "<Azure AD directory in the form of domainname.onmicrosoft.com or an Azure AD verified custom domain name>" -TimeServer 52.168.138.145 #Example time server IP address.

Se o seu ambiente não tiver DHCP ativado, então deve incluir os seguintes parâmetros adicionais para uma das opções acima (por exemplo, utilização fornecida):If your environment doesn't have DHCP enabled, then you must include the following additional parameters to one of the options above (example usage provided):

.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 10.222.112.26

ASDK InstallAzureStackPOC.ps1 parâmetros opcionaisASDK InstallAzureStackPOC.ps1 optional parameters

ParâmetroParameter Obrigatório/OpcionalRequired/Optional DescriçãoDescription
AdminPasswordAdminPassword NecessárioRequired Define a conta de administração local e todas as outras contas de utilizador em todos os VMs criados como parte da implementação da ASDK.Sets the local admin account and all other user accounts on all the VMs created as part of ASDK deployment. Esta palavra-passe deve corresponder à atual palavra-passe de administração local no anfitrião.This password must match the current local admin password on the host.
InfraAzureDirectoryTenantNameInfraAzureDirectoryTenantName NecessárioRequired Define o diretório do inquilino.Sets the tenant directory. Utilize este parâmetro para especificar um diretório específico onde a conta Azure AD tem permissões para gerir vários diretórios.Use this parameter to specify a specific directory where the Azure AD account has permissions to manage multiple directories. Nome completo de um inquilino AZure AD no formato de .onmicrosoft.com ou um nome de domínio personalizado Azure AD.Full name of an Azure AD tenant in the format of .onmicrosoft.com or an Azure AD verified custom domain name.
Relógio de tempoTimeServer NecessárioRequired Utilize este parâmetro para especificar um servidor de tempo específico.Use this parameter to specify a specific time server. Este parâmetro deve ser fornecido como um endereço IP do servidor de tempo válido.This parameter must be provided as a valid time server IP address. Os nomes do servidor não são suportados.Server names aren't supported.
InfraAzureDirectoryTenantAdminCredentialInfraAzureDirectoryTenantAdminCredential OpcionalOptional Define o nome de utilizador e a palavra-passe do Azure Ative Directory.Sets the Azure Active Directory user name and password. Estas credenciais Azure devem ser uma identificação org.These Azure credentials must be an Org ID.
InfraAzureEnvironmentInfraAzureEnvironment OpcionalOptional Selecione o Ambiente Azure com o qual pretende registar esta implementação Azure Stack.Select the Azure Environment with which you want to register this Azure Stack deployment. As opções incluem Azure global, Azure - China, Azure - Governo dos EUA.Options include global Azure, Azure - China, Azure - US Government.
DNSForwarderDNSForwarder OpcionalOptional Um servidor DNS é criado como parte da implementação do Azure Stack.A DNS server is created as part of the Azure Stack deployment. Para permitir que os computadores dentro da solução resolvam nomes fora do carimbo, forneça o servidor DNS da sua infraestrutura existente.To allow computers inside the solution to resolve names outside of the stamp, provide your existing infrastructure DNS server. O servidor DNS in-stamp reencaminha pedidos de resolução de nomes desconhecidos para este servidor.The in-stamp DNS server forwards unknown name resolution requests to this server.
Executar novamenteRerun OpcionalOptional Utilize esta bandeira para reencassear a implantação.Use this flag to rerun deployment. Toda a entrada anterior é utilizada.All previous input is used. A reentrada de dados previamente fornecidos não é suportada porque vários valores únicos são gerados e usados para implantação.Reentering data previously provided isn't supported because several unique values are generated and used for deployment.

Executar configurações pós-implantaçãoPerform post-deployment configurations

Após a instalação do ASDK, existem algumas verificações de pós-instalação recomendadas e alterações de configuração que devem ser feitas.After installing the ASDK, there are a few recommended post-installation checks and configuration changes that should be made. Validar a sua instalação foi instalada com sucesso utilizando o cmdlet test-AzureStack e, em seguida, instale as ferramentas Azure Stack PowerShell e GitHub.Validate your installation was installed successfully by using the test-AzureStack cmdlet, then install Azure Stack PowerShell and GitHub tools.

Recomendamos que reinicie a política de expiração da palavra-passe para garantir que a palavra-passe do anfitrião ASDK não expire antes do fim do período de avaliação.We recommend you reset the password expiration policy to make sure that the password for the ASDK host doesn't expire before your evaluation period ends.

Nota

Opcionalmente, também pode configurar as definições de telemetria Azure Stack após a instalação do ASDK.Optionally, you can also configure Azure Stack telemetry settings after installing the ASDK.

Publicar tarefas de implantação ASDKPost ASDK deployment tasks

Registe-se com a AzureRegister with Azure

Tem de registar o Azure Stack com a Azure para que possa baixar os itens do Azure Marketplace para a Azure Stack.You must register Azure Stack with Azure so that you can download Azure Marketplace items to Azure Stack.

Registar Pilha Azure com AzureRegister Azure Stack with Azure

Passos seguintesNext steps

Parabéns!Congratulations! Depois de completar estes passos, terá um ambiente ASDK com portais de administração https://adminportal.local.azurestack.external e https://portal.local.azurestack.external utilizador.After completing these steps, you'll have an ASDK environment with both admin https://adminportal.local.azurestack.external and user https://portal.local.azurestack.external portals.

Publicar tarefas de configuração de instalação ASDKPost ASDK installation configuration tasks