Distribuera ASDK från kommando raden med hjälp av PowerShellDeploy ASDK from the command line using PowerShell

Azure Stack Development Kit (ASDK) är en test-och utvecklings miljö som du kan distribuera för att utvärdera och demonstrera Azure Stack funktioner och tjänster.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. Du måste förbereda miljö maskin varan och köra vissa skript för att komma igång.To get it up and running, you need to prepare the environment hardware and run some scripts. Det tar flera timmar att köra skripten.The scripts take several hours to run. Sedan kan du logga in på administratörs-och användar portalerna för att börja använda Azure Stack.After that, you can sign in to the admin and user portals to start using Azure Stack.

FörutsättningarPrerequisites

Förbered ASDK-värddatorn.Prepare the ASDK host computer. Planera maskin vara, program vara och nätverk.Plan your hardware, software, and network. Datorn som är värd för ASDK måste uppfylla kraven på maskin vara, program vara och nätverk.The computer that hosts the ASDK must meet hardware, software, and network requirements. Välj mellan att använda Azure Active Directory (Azure AD) eller Active Directory Federation Services (AD FS) (AD FS).Choose between using Azure Active Directory (Azure AD) or Active Directory Federation Services (AD FS). Se till att följa dessa krav innan du påbörjar distributionen så att installations processen körs smidigt.Be sure to follow these prerequisites before starting your deployment so that the installation process runs smoothly.

Innan du distribuerar ASDK ska du kontrol lera att den planerade ASDK värddatorns maskin vara, operativ system, konto och nätverkskonfigurationer uppfyller minimi kraven för att installera 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.

Granska ASDK-distributionens krav och överväganden.Review the ASDK deployment requirements and considerations.

Hämta och extrahera distributions paketetDownload and extract the deployment package

När du har kontrollerat att ASDK-värddatorn uppfyller de grundläggande kraven för att installera ASDK, är nästa steg att ladda ned och extrahera ASDK-distributionspaketet.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. Distributions paketet innehåller filen Cloudbuilder. vhdx, som är en virtuell hård disk som innehåller ett startbart operativ system och Azure Stack-installationsfilerna.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.

Du kan ladda ned distributions paketet till ASDK-värden eller till en annan dator.You can download the deployment package to the ASDK host or to another computer. De extraherade distributions filerna tar upp 60 GB ledigt disk utrymme så att du kan minska maskin varu kraven för ASDK-värden med hjälp av en annan dator.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.

Ladda ned och extrahera Azure Stack Development Kit (ASDK)Download and extract the Azure Stack Development Kit (ASDK)

Förbereda ASDK-värddatornPrepare the ASDK host computer

Innan du kan installera ASDK på värddatorn måste miljön förberedas och systemet har kon figurer ATS för att starta från VHD.Before you can install the ASDK on the host computer, the environment must be prepared and the system configured to boot from VHD. Efter det här steget kommer ASDK-värden att starta till Cloudbuilder. vhdx (en virtuell hård disk som innehåller ett startbart operativ system och Azure Stack-installationsfilerna).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).

Använd PowerShell för att konfigurera ASDK-värddatorn för att starta från CloudBuilder. vhdx.Use PowerShell to configure the ASDK host computer to boot from CloudBuilder.vhdx. Dessa kommandon konfigurerar ASDK-värddatorn för start från den nedladdade och extraherade Azure Stack virtuella hård disken (CloudBuilder. vhdx).These commands configure your ASDK host computer to boot from the downloaded and extracted Azure Stack virtual harddisk (CloudBuilder.vhdx). När du har slutfört de här stegen startar du om ASDK-värddatorn.After completing these steps, restart the ASDK host computer.

Konfigurera ASDK-värddatorn för att starta från CloudBuilder. vhdx:To configure the ASDK host computer to boot from CloudBuilder.vhdx:

  1. Starta en kommando tolk som administratör.Launch a command prompt as admin.
  2. Kör bcdedit /copy {current} /d "Azure Stack".Run bcdedit /copy {current} /d "Azure Stack".
  3. Kopiera (CTRL + C) det returnerade CLSID-värdet, inklusive obligatoriska klammerparenteser ( {} ).Copy (CTRL+C) the CLSID value returned, including the required curly brackets ({}). Det här värdet kallas {CLSID} och måste klistras in i (Ctrl + V eller högerklicka) i de återstående stegen.This value is referred to as {CLSID} and needs to be pasted in (CTRL+V or right-click) in the remaining steps.
  4. Kör bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.Run bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.
  5. Kör bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.Run bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.
  6. Kör bcdedit /set {CLSID} detecthal on.Run bcdedit /set {CLSID} detecthal on.
  7. Kör bcdedit /default {CLSID}.Run bcdedit /default {CLSID}.
  8. Kör för att verifiera Start Inställningar bcdedit .To verify boot settings, run bcdedit.
  9. Se till att filen CloudBuilder. vhdx har flyttats till roten för C:\ enhet ( C:\CloudBuilder.vhdx ) och startar om ASDK-värddatorn.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. När ASDK-värddatorn startas om, bör den starta från den virtuella hård disken för CloudBuilder. vhdx för att påbörja ASDK-distributionen.When the ASDK host computer is restarted, it should boot from the CloudBuilder.vhdx virtual machine (VM) hard drive to begin ASDK deployment.

Viktigt

Se till att du har direkt fysisk eller KVM åtkomst till ASDK-värddatorn innan du startar om den.Ensure that you have direct physical or KVM access to the ASDK host computer before restarting it. När den virtuella datorn startas uppmanas du att slutföra installationen av Windows Server.When the VM first starts, it prompts you to complete Windows Server Setup. Ange samma admin-autentiseringsuppgifter som du använde för att logga in på ASDK-värddatorn.Provide the same admin credentials you used to log into the ASDK host computer.

Förbered ASDK-värden med PowerShellPrepare the ASDK host using PowerShell

När ASDK-värddatorn har startats i CloudBuilder. vhdx-avbildningen loggar du in med samma autentiseringsuppgifter för lokal administratör som du använde för att logga in på ASDK-värddatorn.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. Detta är också samma autentiseringsuppgifter som du angav som en del av installationen av Windows Server när värddatorn startades från VHD.These are also the same credentials you provided as part of completing the Windows Server Setup when the host computer booted from VHD.

Anteckning

Alternativt kan du också konfigurera inställningarna för Azure Stack telemetri innan du installerar ASDK.Optionally, you can also configure Azure Stack telemetry settings before installing the ASDK.

Öppna en upphöjd PowerShell-konsol och kör kommandona i det här avsnittet för att distribuera ASDK på ASDK-värden.Open an elevated PowerShell console and run the commands in this section to deploy the ASDK on the ASDK host.

Viktigt

ASDK-installationen stöder exakt ett nätverkskort (NIC) för nätverk.ASDK installation supports exactly one network interface card (NIC) for networking. Om du har flera nätverkskort kontrollerar du att endast ett är aktiverat (och att alla andra är inaktiverade) innan du kör distributions skriptet.If you have multiple NICs, make sure that only one is enabled (and all others are disabled) before running the deployment script.

Du kan distribuera Azure Stack med Azure AD eller Windows Server AD FS som identitets leverantör.You can deploy Azure Stack with Azure AD or Windows Server AD FS as the identity provider. Azure Stack, resurs leverantörer och andra appar fungerar på samma sätt med båda.Azure Stack, resource providers, and other apps work the same way with both.

Tips

Om du inte anger några installations parametrar (se InstallAzureStackPOC.ps1 valfria parametrar och exempel nedan) uppmanas du att ange de parametrar som krävs.If you don't supply any setup parameters (see InstallAzureStackPOC.ps1 optional parameters and examples below), you're prompted for the required parameters.

Distribuera Azure Stack med Azure ADDeploy Azure Stack using Azure AD

Om du vill distribuera Azure Stack med Azure AD som identitetsprovider måste du ha Internet anslutning antingen direkt eller via en transparent proxy.To deploy Azure Stack using Azure AD as the identity provider, you must have internet connectivity either directly or through a transparent proxy.

Kör följande PowerShell-kommandon för att distribuera ASDK med hjälp av 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

Några minuter i ASDK-installationen uppmanas du att ange autentiseringsuppgifter för Azure AD.A few minutes into ASDK installation you'll be prompted for Azure AD credentials. Ange autentiseringsuppgifter för den globala administratören för din Azure AD-klient.Provide the global admin credentials for your Azure AD tenant.

Efter distributionen krävs Azure Active Directory global administratörs behörighet inte.After deployment, Azure Active Directory global admin permission isn't required. Vissa åtgärder kan dock kräva en global administratörs behörighet.However, some operations may require the global admin credential. Exempel på sådana åtgärder är ett installations skript för en resurs leverantör eller en ny funktion som kräver behörighet att beviljas.Examples of such operations include a resource provider installer script or a new feature requiring a permission to be granted. Du kan antingen återställa kontots globala administratörs behörigheter tillfälligt eller använda ett separat globalt administratörs konto som är ägare till standard prenumerationen för providern.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.

Distribuera Azure Stack med AD FSDeploy Azure Stack using AD FS

Om du vill distribuera ASDK med AD FS som identitetsprovider kör du följande PowerShell-kommandon (du behöver bara lägga till parametern-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

I AD FS distributioner används standard katalog tjänsten som identitets leverantör.In AD FS deployments, the default stamp Directory Service is used as the identity provider. Standard kontot för att logga in med är azurestackadmin@azurestack.local och lösen ordet anges till det du angav som en del av PowerShell-installationsprogrammet.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.

Distributions processen kan ta några timmar, då systemet startar om automatiskt en gång.The deployment process can take a few hours, during which time the system automatically reboots once. När distributionen har slutförts visar PowerShell-konsolen: Slutför: åtgärds distribution.When the deployment succeeds, the PowerShell console displays: COMPLETE: Action 'Deployment'. Om distributionen Miss lyckas kan du försöka köra skriptet igen med parametern-kör igen.If the deployment fails, try running the script again using the -rerun parameter. Eller så kan du distribuera om ASDK från grunden.Or, you can redeploy ASDK from scratch.

Viktigt

Om du vill övervaka distributions förloppet efter att ASDK-värden har startats om måste du logga in som AzureStack\AzureStackAdmin.If you want to monitor the deployment progress after the ASDK host reboots, you must sign in as AzureStack\AzureStackAdmin. Om du loggar in som lokal administratör när värddatorn har startats om (och anslutits till azurestack. local), visas inte distributions förloppet.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. Kör inte om distributionen, i stället logga in som AzureStack\AzureStackAdmin med samma lösen ord som den lokala administratören för att kontrol lera att installationen körs.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.

Skript exempel för Azure AD-distributionAzure AD deployment script examples

Du kan skripta hela Azure AD-distributionen.You can script the entire Azure AD deployment. Här följer några kommenterade exempel som innehåller några valfria parametrar.Here are a few commented examples that include some optional parameters.

Om din Azure AD-identitet endast är associerad med en Azure AD-katalog: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.

Om din Azure AD-identitet är associerad med fler än en Azure AD-katalog: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.

Om din miljö inte har DHCP aktiverat måste du ta med följande ytterligare parametrar till något av alternativen ovan (exempel på användning finns):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 valfria parametrarASDK InstallAzureStackPOC.ps1 optional parameters

ParameterParameter Obligatorisk/valfriRequired/Optional DescriptionDescription
AdminPasswordAdminPassword ObligatorisktRequired Anger det lokala administratörs kontot och alla andra användar konton på alla virtuella datorer som skapats som en del av ASDK-distributionen.Sets the local admin account and all other user accounts on all the VMs created as part of ASDK deployment. Lösen ordet måste överensstämma med det aktuella lokala administratörs lösen ordet på värden.This password must match the current local admin password on the host.
InfraAzureDirectoryTenantNameInfraAzureDirectoryTenantName ObligatorisktRequired Anger klient katalogen.Sets the tenant directory. Använd den här parametern för att ange en särskild katalog där Azure AD-kontot har behörighet att hantera flera kataloger.Use this parameter to specify a specific directory where the Azure AD account has permissions to manage multiple directories. Fullständigt namn på en Azure AD-klient i formatet. onmicrosoft.com eller ett verifierat anpassat domän namn i Azure AD.Full name of an Azure AD tenant in the format of .onmicrosoft.com or an Azure AD verified custom domain name.
TimeServerTimeServer ObligatorisktRequired Använd den här parametern för att ange en angiven tids Server.Use this parameter to specify a specific time server. Den här parametern måste anges som en giltig tids Server-IP-adress.This parameter must be provided as a valid time server IP address. Server namn stöds inte.Server names aren't supported.
InfraAzureDirectoryTenantAdminCredentialInfraAzureDirectoryTenantAdminCredential ValfrittOptional Anger Azure Active Directory användar namn och lösen ord.Sets the Azure Active Directory user name and password. Dessa Azure-autentiseringsuppgifter måste vara ett org-ID.These Azure credentials must be an Org ID.
InfraAzureEnvironmentInfraAzureEnvironment ValfrittOptional Välj den Azure-miljö som du vill registrera den här Azure Stack distributionen med.Select the Azure Environment with which you want to register this Azure Stack deployment. Alternativen inkluderar Global Azure, Azure-Kina, Azure-amerikanska myndigheter.Options include global Azure, Azure - China, Azure - US Government.
DNSForwarderDNSForwarder ValfrittOptional En DNS-server skapas som en del av distributionen av Azure Stack.A DNS server is created as part of the Azure Stack deployment. Om du vill tillåta att datorer inuti lösningen matchar namn utanför stämpeln, anger du din befintliga infrastruktur-DNS-server.To allow computers inside the solution to resolve names outside of the stamp, provide your existing infrastructure DNS server. Den systemstämplade DNS-servern vidarebefordrar okända namn matchnings begär anden till den här servern.The in-stamp DNS server forwards unknown name resolution requests to this server.
Kör igenRerun ValfrittOptional Använd den här flaggan för att köra distributionen igen.Use this flag to rerun deployment. Alla tidigare inmatade värden används.All previous input is used. Det finns inte stöd för att ange de data som angetts tidigare eftersom flera unika värden genereras och används för distribution.Reentering data previously provided isn't supported because several unique values are generated and used for deployment.

Utför konfigurationer efter distributionPerform post-deployment configurations

När du har installerat ASDK finns det några rekommenderade kontroller efter installationen och konfigurations ändringar som bör göras.After installing the ASDK, there are a few recommended post-installation checks and configuration changes that should be made. Verifiera att installationen har installerats med hjälp av cmdleten test-AzureStack och installera sedan Azure Stack PowerShell-och GitHub-verktyg.Validate your installation was installed successfully by using the test-AzureStack cmdlet, then install Azure Stack PowerShell and GitHub tools.

Vi rekommenderar att du återställer lösen ordets giltighets princip för att se till att lösen ordet för ASDK-värden inte upphör att gälla förrän utvärderings perioden är slut.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.

Anteckning

Alternativt kan du också konfigurera inställningarna för Azure Stack telemetri när du har installerat ASDK.Optionally, you can also configure Azure Stack telemetry settings after installing the ASDK.

Publicera ASDK-distributions uppgifterPost ASDK deployment tasks

Registrera dig för AzureRegister with Azure

Du måste registrera Azure Stack med Azure så att du kan Ladda ned Azure Marketplace-objekt till Azure Stack.You must register Azure Stack with Azure so that you can download Azure Marketplace items to Azure Stack.

Registrera Azure Stack med AzureRegister Azure Stack with Azure

Nästa stegNext steps

Grattis!Congratulations! När du har slutfört de här stegen har du en ASDK-miljö med både administratörs- https://adminportal.local.azurestack.external och användar https://portal.local.azurestack.external portaler.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.

Publicera konfigurations uppgifter för ASDK-installationPost ASDK installation configuration tasks