ASDK implementeren vanaf de opdrachtregel met behulp van PowerShell

  • Artikel

De Azure Stack Development Kit (ASDK) is een test- en ontwikkelomgeving die u kunt implementeren om Azure Stack-functies en -services te evalueren en te demonstreren. U moet de omgevingshardware voorbereiden en enkele scripts uitvoeren om het aan de slag te laten gaan. Het uitvoeren van de scripts duurt enkele uren. Daarna kunt u zich aanmelden bij de beheer- en gebruikersportals om Azure Stack te gaan gebruiken.

Vereisten

Bereid de ASDK-hostcomputer voor. Plan uw hardware, software en netwerk. De computer waarop de ASDK wordt gehost, moet voldoen aan de hardware-, software- en netwerkvereisten. Kies tussen het gebruik van Microsoft Entra-id of Active Directory Federation Services (AD FS). Zorg ervoor dat u aan deze vereisten voldoet voordat u de implementatie start, zodat het installatieproces soepel verloopt.

Voordat u de ASDK implementeert, moet u ervoor zorgen dat de hardware, het besturingssysteem, het account en de netwerkconfiguraties van uw geplande ASDK-hostcomputer voldoen aan de minimale vereisten voor het installeren van de ASDK.

Bekijk de vereisten en overwegingen voor ASDK-implementatie.

Het implementatiepakket downloaden en uitpakken

Nadat u ervoor hebt gezorgd dat uw ASDK-hostcomputer voldoet aan de basisvereisten voor het installeren van de ASDK, is de volgende stap het downloaden en extraheren van het ASDK-implementatiepakket. Het implementatiepakket bevat het bestand Cloudbuilder.vhdx. Dit is een virtuele harde schijf met een opstartbaar besturingssysteem en de Azure Stack-installatiebestanden.

U kunt het implementatiepakket downloaden naar de ASDK-host of naar een andere computer. De geëxtraheerde implementatiebestanden nemen 60 GB vrije schijfruimte in beslag, dus het gebruik van een andere computer kan helpen de hardwarevereisten voor de ASDK-host te verminderen.

De Azure Stack Development Kit (ASDK) downloaden en uitpakken

De ASDK-hostcomputer voorbereiden

Voordat u de ASDK op de hostcomputer kunt installeren, moet de omgeving worden voorbereid en moet het systeem zijn geconfigureerd om op te starten vanaf VHD. Na deze stap wordt de ASDK-host opgestart naar cloudbuilder.vhdx (een virtuele harde schijf met een opstartbaar besturingssysteem en de Azure Stack-installatiebestanden).

Gebruik PowerShell om de ASDK-hostcomputer te configureren om op te starten vanuit CloudBuilder.vhdx. Met deze opdrachten configureert u uw ASDK-hostcomputer om op te starten vanaf de gedownloade en geëxtraheerde virtuele harde schijf van Azure Stack (CloudBuilder.vhdx). Nadat u deze stappen hebt voltooid, start u de ASDK-hostcomputer opnieuw op.

De ASDK-hostcomputer configureren om op te starten vanuit CloudBuilder.vhdx:

  1. Start een opdrachtprompt als beheerder.
  2. Voer bcdedit /copy {current} /d "Azure Stack" uit.
  3. Kopieer (Ctrl+C) de geretourneerde CLSID-waarde, inclusief de vereiste accolades ({}). Deze waarde wordt aangeduid als {CLSID} en moet in de resterende stappen worden geplakt (Ctrl+V of klikken met de rechtermuisknop).
  4. Voer bcdedit /set {CLSID} device vhd=[C:]\CloudBuilder.vhdx uit.
  5. Voer bcdedit /set {CLSID} osdevice vhd=[C:]\CloudBuilder.vhdx uit.
  6. Voer bcdedit /set {CLSID} detecthal on uit.
  7. Voer bcdedit /default {CLSID} uit.
  8. Voer uit bcdeditom de opstartinstellingen te controleren.
  9. Zorg ervoor dat het bestand CloudBuilder.vhdx is verplaatst naar de hoofdmap van station C:\ (C:\CloudBuilder.vhdx) en start de ASDK-hostcomputer opnieuw op. Wanneer de ASDK-hostcomputer opnieuw wordt opgestart, moet deze worden opgestart vanaf de harde schijf van de virtuele machine (VM) CloudBuilder.vhdx om de ASDK-implementatie te starten.

Belangrijk

Zorg ervoor dat u directe fysieke of KVM-toegang hebt tot de ASDK-hostcomputer voordat u deze opnieuw opstart. Wanneer de VM voor het eerst wordt gestart, wordt u gevraagd windows server setup te voltooien. Geef dezelfde beheerdersreferenties op die u hebt gebruikt om u aan te melden bij de ASDK-hostcomputer.

De ASDK-host voorbereiden met behulp van PowerShell

Nadat de ASDK-hostcomputer is opgestart in de installatiekopie CloudBuilder.vhdx, meldt u zich aan met dezelfde lokale beheerdersreferenties die u hebt gebruikt om u aan te melden bij de ASDK-hostcomputer. Dit zijn ook dezelfde referenties die u hebt opgegeven als onderdeel van het voltooien van de Windows Server Setup toen de hostcomputer opstartte vanaf VHD.

Notitie

U kunt ook telemetrie-instellingen voor Azure Stack configureren voordat u de ASDK installeert.

Open een PowerShell-console met verhoogde bevoegdheid en voer de opdrachten in deze sectie uit om de ASDK op de ASDK-host te implementeren.

Belangrijk

ASDK-installatie ondersteunt precies één netwerkinterfacekaart (NIC) voor netwerken. Als u meerdere NIC's hebt, moet u ervoor zorgen dat er slechts één is ingeschakeld (en alle andere zijn uitgeschakeld) voordat u het implementatiescript uitvoert.

U kunt Azure Stack implementeren met Microsoft Entra-id of Windows Server AD FS als id-provider. Azure Stack, resourceproviders en andere apps werken op dezelfde manier met beide.

Tip

Als u geen installatieparameters opgeeft (zie InstallAzureStackPOC.ps1 optionele parameters en voorbeelden hieronder), wordt u gevraagd om de vereiste parameters.

Azure Stack implementeren met behulp van Microsoft Entra-id

Als u Azure Stack wilt implementeren met behulp van Microsoft Entra ID als id-provider, moet u rechtstreeks of via een transparante proxy een internetverbinding hebben.

Voer de volgende PowerShell-opdrachten uit om de ASDK te implementeren met behulp van Microsoft Entra-id:

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

Een paar minuten na de INSTALLATIE van ASDK wordt u gevraagd om Microsoft Entra referenties. Geef de referenties van de globale beheerder op voor uw Microsoft Entra-tenant.

Na de implementatie is Microsoft Entra globale beheerdersmachtiging niet vereist. Voor sommige bewerkingen is echter mogelijk de referenties van de globale beheerder vereist. Voorbeelden van dergelijke bewerkingen zijn een installatiescript voor de resourceprovider of een nieuwe functie waarvoor een machtiging moet worden verleend. U kunt de globale beheerdersmachtigingen van het account tijdelijk herstellen of een afzonderlijk globale beheerdersaccount gebruiken dat eigenaar is van het standaardproviderabonnement.

Azure Stack implementeren met behulp van AD FS

Als u de ASDK wilt implementeren met AD FS als id-provider, voert u de volgende PowerShell-opdrachten uit (u hoeft alleen de parameter -UseADFS toe te voegen):

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

In AD FS-implementaties wordt de standaardstempel directoryservice gebruikt als de id-provider. Het standaardaccount waarmee u zich kunt aanmelden, is azurestackadmin@azurestack.localen het wachtwoord is ingesteld op wat u hebt opgegeven als onderdeel van de PowerShell-installatieopdrachten.

Het implementatieproces kan enkele uren duren, gedurende welke tijd het systeem automatisch opnieuw wordt opgestart. Wanneer de implementatie is voltooid, wordt in de PowerShell-console het volgende weergegeven: VOLTOOID: Actie 'Implementatie'. Als de implementatie mislukt, probeert u het script opnieuw uit te voeren met behulp van de parameter -rerun. U kunt ASDK ook helemaal opnieuw implementeren .

Belangrijk

Als u de voortgang van de implementatie wilt controleren nadat de ASDK-host opnieuw is opgestart, moet u zich aanmelden als AzureStack\AzureStackAdmin. Als u zich aanmeldt als een lokale beheerder nadat de hostcomputer opnieuw is opgestart (en toegevoegd aan het domein azurestack.local), ziet u de voortgang van de implementatie niet. Voer de implementatie niet opnieuw uit. Meld u in plaats daarvan aan als AzureStack\AzureStackAdmin met hetzelfde wachtwoord als de lokale beheerder om te controleren of de installatie wordt uitgevoerd.

voorbeelden van Microsoft Entra-implementatiescripts

U kunt de hele Microsoft Entra-implementatie uitvoeren. Hier volgen enkele voorbeelden van opmerkingen die enkele optionele parameters bevatten.

Als uw Microsoft Entra-identiteit slechts aan één Microsoft Entra directory is gekoppeld:

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.

Als uw Microsoft Entra-identiteit is gekoppeld aan meer dan één Microsoft Entra 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.

Als DHCP niet is ingeschakeld voor uw omgeving, moet u de volgende extra parameters opnemen in een van de bovenstaande opties (voorbeeld van gebruik):

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

ASDK InstallAzureStackPOC.ps1 optionele parameters

Parameter Vereist/optioneel Description
AdminPassword Vereist Hiermee stelt u het lokale beheerdersaccount en alle andere gebruikersaccounts in op alle VM's die zijn gemaakt als onderdeel van de ASDK-implementatie. Dit wachtwoord moet overeenkomen met het huidige lokale beheerderswachtwoord op de host.
InfraAzureDirectoryTenantName Vereist Hiermee stelt u de tenantmap in. Gebruik deze parameter om een specifieke map op te geven waarin het Microsoft Entra-account machtigingen heeft voor het beheren van meerdere mappen. Volledige naam van een Microsoft Entra tenant in de indeling .onmicrosoft.com of een Microsoft Entra id geverifieerde aangepaste domeinnaam.
TimeServer Vereist Gebruik deze parameter om een specifieke tijdserver op te geven. Deze parameter moet worden opgegeven als een geldig IP-adres van de tijdserver. Servernamen worden niet ondersteund.
InfraAzureDirectoryTenantAdminCredential Optioneel Hiermee stelt u de Microsoft Entra gebruikersnaam en wachtwoord. Deze Azure-referenties moeten een organisatie-id zijn.
InfraAzureEnvironment Optioneel Selecteer de Azure-omgeving waarmee u deze Azure Stack-implementatie wilt registreren. Opties zijn onder andere globale Azure, Azure - China, Azure - Amerikaanse overheid.
DNSForwarder Optioneel Er wordt een DNS-server gemaakt als onderdeel van de Azure Stack-implementatie. Als u wilt toestaan dat computers in de oplossing namen buiten het stempel kunnen omzetten, geeft u uw bestaande INFRASTRUCTUUR DNS-server op. De in-stamp DNS-server stuurt onbekende aanvragen voor naamomzetting door naar deze server.
Opnieuw uitvoeren Optioneel Gebruik deze vlag om de implementatie opnieuw uit te voeren. Alle vorige invoer wordt gebruikt. Het opnieuw invoeren van gegevens die eerder zijn opgegeven, wordt niet ondersteund omdat er verschillende unieke waarden worden gegenereerd en gebruikt voor implementatie.

Configuraties na implementatie uitvoeren

Na de installatie van de ASDK zijn er enkele aanbevolen controles na installatie en configuratiewijzigingen die moeten worden aangebracht. Controleer of uw installatie is geïnstalleerd met behulp van de cmdlet test-AzureStack en installeer vervolgens Azure Stack PowerShell- en GitHub-hulpprogramma's.

We raden u aan het wachtwoordverloopbeleid opnieuw in te stellen om ervoor te zorgen dat het wachtwoord voor de ASDK-host niet verloopt voordat uw evaluatieperiode afloopt.

Notitie

U kunt desgewenst ook telemetrie-instellingen voor Azure Stack configureren na de installatie van de ASDK.

Taken na ASDK-implementatie

Registreren bij Azure

U moet Azure Stack registreren bij Azure zodat u Azure Marketplace items kunt downloaden naar Azure Stack.

Azure Stack registreren bij Azure

Volgende stappen

Gefeliciteerd! Nadat u deze stappen hebt voltooid, hebt u een ASDK-omgeving met zowel beheer https://adminportal.local.azurestack.external - als gebruikersportals https://portal.local.azurestack.external .

Configuratietaken na ASDK-installatie