Distribuera ASDK från kommandoraden med Hjälp av PowerShell
Azure Stack Development Kit (ASDK) är en test- och utvecklingsmiljö som du kan distribuera för att utvärdera och demonstrera Azure Stack-funktioner och -tjänster. 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örbereda ASDK-värddatorn. Planera maskinvara, programvara och nätverk. Den dator som är värd för ASDK måste uppfylla kraven för maskinvara, programvara och nätverk. Välj mellan att använda Microsoft Entra-ID eller Active Directory Federation Services (AD FS) (AD FS). Se till att följa dessa krav innan du startar distributionen så att installationsprocessen går smidigt.
Innan du distribuerar ASDK:n kontrollerar du att den planerade ASDK-värddatorns maskinvaru-, operativsystems-, 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: et ä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 du kan minska maskinvarukraven för ASDK-värden med hjälp av en annan dator.
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 vara förberedd och systemet konfigurerat 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 Installationsfilerna för Azure Stack).
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:
- Starta en kommandotolk som administratör.
- Kör
bcdedit /copy {current} /d "Azure Stack". - 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. - Kör
bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx. - Kör
bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx. - Kör
bcdedit /set {CLSID} detecthal on. - Kör
bcdedit /default {CLSID}. - Kontrollera startinställningarna genom att köra
bcdedit. - 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 startas från cloudbuilder.vhdx-hårddisken (VM) för att starta ASDK-distributionen.
Viktigt
Kontrollera att du har direkt fysisk åtkomst eller KVM-åtkomst till ASDK-värddatorn innan du startar om den. När den virtuella datorn startar först uppmanas du att slutföra Windows Server-installationen. Ange samma administratörsautentiseringsuppgifter som du använde för att logga in på ASDK-värddatorn.
Förbereda ASDK-värden med 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.
Anteckning
Du kan också konfigurera Telemetriinställningar för Azure Stackinnan du installerar 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.
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.
Tips
Om du inte anger några konfigurationsparametrar (se InstallAzureStackPOC.ps1 valfria parametrar och exempel nedan) uppmanas du att ange nödvändiga parametrar.
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:t med hjälp av 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 Microsoft Entra global administratörsbehörighet. Vissa åtgärder kan dock kräva globala administratörsautentiseringsuppgifter. 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 tid 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.
Microsoft Entra exempel på distributionsskript
Du kan skripta hela Microsoft Entra distributionen. Här är 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 (exempelanvändning tillhandahålls):
.\InstallAzureStackPOC.ps1 -AdminPassword $adminpass.Password -InfraAzureDirectoryTenantAdminCredential $aadcred -TimeServer 10.222.112.26
ASDK InstallAzureStackPOC.ps1 valfria parametrar
| Parameter | Obligatorisk/valfri | Description |
|---|---|---|
| AdminPassword | Obligatorisk | 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 | Obligatorisk | 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 | Obligatorisk | Använd den här parametern för att ange en specifik tidsserver. Den här parametern måste anges som en giltig tidsserver-IP-adress. Servernamn stöds inte. |
| InfraAzureDirectoryTenantAdminCredential | Valfritt | Anger Microsoft Entra användarnamn och lösenord. 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 inkluderar globala Azure, Azure – Kina, Azure – US Government. |
| DNSForwarder | Valfritt | En DNS-server skapas som en del av Azure Stack-distributionen. Om du vill tillåta datorer i lösningen att matcha namn utanför stämpeln anger du din befintliga DNS-infrastrukturserver. Den stämpelbaserade 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 cmdleten test-AzureStack och installera sedan Azure Stack PowerShell- och GitHub-verktygen.
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.
Anteckning
Du kan också konfigurera telemetriinställningar för Azure Stacknä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 .
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för