Dela via


Distribuera ASDK från kommandoraden med PowerShell

Azure Stack Development Kit (ASDK) är en test- och utvecklingsmiljö som du kan distribuera för att utvärdera och demonstrera Funktioner och tjänster i Azure Stack. För att få igång den måste du förbereda miljöns maskinvara och köra några skript. Skripten tar flera timmar att köra. Därefter kan du logga in på administratörs- och användarportalerna för att börja använda Azure Stack.

Förutsättningar

Förbered ASDK-värddatorn. Planera maskinvara, programvara och nätverk. Den dator som är värd för ASDK måste uppfylla maskinvaru-, programvaru- och nätverkskraven. Välj mellan att använda Microsoft Entra-ID eller Active Directory usluge za ujedinjavanje (AD FS). Se till att följa dessa förutsättningar innan du startar distributionen så att installationsprocessen fungerar smidigt.

Innan du distribuerar ASDK ska du se till att den planerade ASDK-värddatorns maskinvaru-, operativsystem-, konto- och nätverkskonfigurationer uppfyller minimikraven för att installera ASDK.

Granska kraven och övervägandena för ASDK-distributionen.

Ladda ned och extrahera distributionspaketet

När du har säkerställt att DIN ASDK-värddator uppfyller de grundläggande kraven för att installera ASDK är nästa steg att ladda ned och extrahera ASDK-distributionspaketet. Distributionspaketet innehåller filen Cloudbuilder.vhdx, som är en virtuell hårddisk som innehåller ett startbart operativsystem och Azure Stack-installationsfilerna.

Du kan ladda ned distributionspaketet till ASDK-värden eller till en annan dator. De extraherade distributionsfilerna tar upp 60 GB ledigt diskutrymme, så att använda en annan dator kan bidra till att minska maskinvarukraven för ASDK-värden.

Ladda ned och extrahera Azure Stack Development Kit (ASDK)

Förbereda ASDK-värddatorn

Innan du kan installera ASDK:t på värddatorn måste miljön förberedas och systemet konfigureras för att starta från VHD. Efter det här steget startar ASDK-värden till Cloudbuilder.vhdx (en virtuell hårddisk som innehåller ett startbart operativsystem och Azure Stack-installationsfilerna).

Använd PowerShell för att konfigurera ASDK-värddatorn så att den startar från CloudBuilder.vhdx. Dessa kommandon konfigurerar din ASDK-värddator att starta från den nedladdade och extraherade virtuella Azure Stack-hårddisken (CloudBuilder.vhdx). När du har slutfört de här stegen startar du om ASDK-värddatorn.

Så här konfigurerar du ASDK-värddatorn så att den startar från CloudBuilder.vhdx:

  1. Starta en kommandotolk som administratör.
  2. Kör bcdedit /copy {current} /d "Azure Stack".
  3. Kopiera (CTRL+C) CLSID-värdet som returneras, inklusive nödvändiga klammerparenteser ({}). Det här värdet kallas {CLSID} och måste klistras in (CTRL+V eller högerklicka) i de återstående stegen.
  4. Kör bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx.
  5. Kör bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx.
  6. Kör bcdedit /set {CLSID} detecthal on.
  7. Kör bcdedit /default {CLSID}.
  8. Kontrollera startinställningarna genom att köra bcdedit.
  9. Kontrollera att filen CloudBuilder.vhdx har flyttats till roten på C:\-enheten (C:\CloudBuilder.vhdx) och starta om ASDK-värddatorn. När ASDK-värddatorn startas om bör den starta från den virtuella datorn CloudBuilder.vhdx (VM) för att påbörja ASDK-distributionen.

Viktigt!

Kontrollera att du har direkt fysisk eller KVM-åtkomst till ASDK-värddatorn innan du startar om den. När den virtuella datorn startas först uppmanas du att slutföra Installationen av Windows Server. Ange samma administratörsautentiseringsuppgifter som du använde för att logga in på ASDK-värddatorn.

Förbereda ASDK-värden med Hjälp av PowerShell

När ASDK-värddatorn har startats i CloudBuilder.vhdx-avbildningen loggar du in med samma lokala administratörsautentiseringsuppgifter som du använde för att logga in på ASDK-värddatorn. Det här är också samma autentiseringsuppgifter som du angav när du slutförde Installationsprogrammet för Windows Server när värddatorn startade från den virtuella hårddisken.

Kommentar

Du kan också konfigurera Telemetriinställningar för Azure Stack innan du installerar ASDK.

Öppna en upphöjd PowerShell-konsol och kör kommandona i det här avsnittet för att distribuera ASDK:t på ASDK-värden.

Viktigt!

ASDK-installationen stöder exakt ett nätverkskort (NIC) för nätverk. Om du har flera nätverkskort kontrollerar du att endast en är aktiverad (och alla andra är inaktiverade) innan du kör distributionsskriptet.

Du kan distribuera Azure Stack med Microsoft Entra-ID eller Windows Server AD FS som identitetsprovider. Azure Stack, resursprovidrar och andra appar fungerar på samma sätt med båda.

Dricks

Om du inte anger några konfigurationsparametrar (se Valfria parametrar och exempel för InstallAzureStackPOC.ps1 nedan) uppmanas du att ange de parametrar som krävs.

Distribuera Azure Stack med Microsoft Entra-ID

Om du vill distribuera Azure Stack med Microsoft Entra-ID som identitetsprovider måste du ha internetanslutning antingen direkt eller via en transparent proxy.

Kör följande PowerShell-kommandon för att distribuera ASDK med microsoft entra-ID:

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

Några minuter in i ASDK-installationen uppmanas du att ange Microsoft Entra-autentiseringsuppgifter. Ange autentiseringsuppgifterna för global administratör för din Microsoft Entra-klientorganisation.

Efter distributionen krävs inte den globala administratörsbehörigheten för Microsoft Entra. Vissa åtgärder kan dock kräva den globala administratörens autentiseringsuppgifter. Exempel på sådana åtgärder är ett installationsskript för resursprovidern eller en ny funktion som kräver att en behörighet beviljas. Du kan antingen tillfälligt återställa kontots globala administratörsbehörigheter eller använda ett separat globalt administratörskonto som är ägare till standardleverantörsprenumerationen.

Distribuera Azure Stack med 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):

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

I AD FS-distributioner används standardstämpeln Katalogtjänst som identitetsprovider. Standardkontot som ska loggas in med är azurestackadmin@azurestack.local, och lösenordet är inställt på det du angav som en del av PowerShell-konfigurationskommandona.

Distributionsprocessen kan ta några timmar, under vilken tiden systemet startas om automatiskt en gång. När distributionen lyckas visas PowerShell-konsolen: COMPLETE: Action 'Deployment'. Om distributionen misslyckas kan du försöka köra skriptet igen med parametern -rerun. Eller så kan du distribuera om ASDK från grunden.

Viktigt!

Om du vill övervaka distributionsförloppet efter att ASDK-värden har startats om måste du logga in som AzureStack\AzureStackAdmin. Om du loggar in som lokal administratör när värddatorn har startats om (och anslutits till domänen azurestack.local) ser du inte distributionsförloppet. Kör inte distributionen igen utan logga i stället in som AzureStack\AzureStackAdmin med samma lösenord som den lokala administratören för att verifiera att installationen körs.

Exempel på Microsoft Entra-distributionsskript

Du kan skripta hela Microsoft Entra-distributionen. Här följer några kommenterade exempel som innehåller några valfria parametrar.

Om din Microsoft Entra-identitet endast är associerad med en Microsoft Entra-katalog:

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 Microsoft Entra-identitet är associerad med större än en Microsoft Entra-katalog:

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 inkludera följande ytterligare parametrar i något av alternativen ovan (exempel på användning):

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

Valfria parametrar för ASDK InstallAzureStackPOC.ps1

Parameter Obligatoriskt/valfritt beskrivning
AdminPassword Obligatoriskt Anger det lokala administratörskontot och alla andra användarkonton på alla virtuella datorer som skapats som en del av ASDK-distributionen. Det här lösenordet måste matcha det aktuella lokala administratörslösenordet på värden.
InfraAzureDirectoryTenantName Obligatoriskt Anger klientkatalogen. Använd den här parametern för att ange en specifik katalog där Microsoft Entra-kontot har behörighet att hantera flera kataloger. Fullständigt namn på en Microsoft Entra-klientorganisation i formatet .onmicrosoft.com eller ett Microsoft Entra-ID verifierat anpassat domännamn.
TimeServer Obligatoriskt Använd den här parametern för att ange en specifik tidsserver. Den här parametern måste anges som en giltig tidsservers IP-adress. Servernamn stöds inte.
InfraAzureDirectoryTenantAdminCredential Valfritt Anger Användarnamn och lösenord för Microsoft Entra. Dessa Azure-autentiseringsuppgifter måste vara ett organisations-ID.
InfraAzureEnvironment Valfritt Välj den Azure-miljö som du vill registrera den här Azure Stack-distributionen med. Alternativen är globala Azure, Azure – Kina, Azure – US Government.
DNSForwarder Valfritt En DNS-server skapas som en del av Azure Stack-distributionen. Om du vill att datorer i lösningen ska kunna matcha namn utanför stämpeln anger du din befintliga DNS-infrastrukturserver. Dns-servern vidarebefordrar okända namnmatchningsbegäranden till den här servern.
Kör igen Valfritt Använd den här flaggan för att köra distributionen igen. Alla tidigare indata används. Återaktivering av data som tidigare angavs stöds inte eftersom flera unika värden genereras och används för distribution.

Utföra konfigurationer efter distributionen

När du har installerat ASDK:t finns det några rekommenderade kontroller efter installationen och konfigurationsändringar som bör göras. Verifiera att installationen har installerats med hjälp av cmdleten test-AzureStack och installera sedan Azure Stack PowerShell- och GitHub-verktyg.

Vi rekommenderar att du återställer förfalloprincipen för lösenord för att se till att lösenordet för ASDK-värden inte upphör att gälla innan utvärderingsperioden är slut.

Kommentar

Du kan också konfigurera Telemetriinställningar för Azure Stack när du har installerat ASDK.

Publicera ASDK-distributionsuppgifter

Registrera dig med Azure

Du måste registrera Azure Stack med Azure så att du kan ladda ned Azure Marketplace-objekt till Azure Stack.

Registrera Azure Stack med Azure

Nästa steg

Grattis! 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ändarportaler https://portal.local.azurestack.external .

Publicera konfigurationsuppgifter för ASDK-installation