Power shell AzureRM-module voor Azure Stack hub installerenInstall PowerShell AzureRM module for Azure Stack Hub

Azure PowerShell AzureRM voorziet in een set cmdlets die gebruikmaken van het Azure Resource Manager model voor het beheren van uw Azure Stack hub-resources.Azure PowerShell AzureRM provides a set of cmdlets that use the Azure Resource Manager model for managing your Azure Stack Hub resources.

U moet ook API- profielen gebruiken om de compatibele eind punten voor de resource providers van de Azure stack hub op te geven.You also need to use API profiles to specify the compatible endpoints for the Azure Stack Hub resource providers.

API-profielen bieden een manier om versie verschillen te beheren tussen Azure en Azure Stack hub.API profiles provide a way to manage version differences between Azure and Azure Stack Hub. Een API-versie profiel is een set Azure Resource Manager Power shell-modules met specifieke API-versies.An API version profile is a set of Azure Resource Manager PowerShell modules with specific API versions. Elk cloud platform heeft een set ondersteunde API-versie profielen.Each cloud platform has a set of supported API version profiles. Azure Stack hub ondersteunt bijvoorbeeld een specifieke profiel versie, zoals 2019-03-01-hybride.For example, Azure Stack Hub supports a specific profile version such as 2019-03-01-hybrid. Wanneer u een profiel installeert, worden de Azure Resource Manager Power shell-modules die overeenkomen met het opgegeven profiel geïnstalleerd.When you install a profile, the Azure Resource Manager PowerShell modules that correspond to the specified profile are installed.

U kunt Azure Stack hub compatibele Power shell-modules installeren in met internet verbonden, gedeeltelijk verbonden of niet-verbonden scenario's.You can install Azure Stack Hub compatible PowerShell modules in internet-connected, partially connected, or disconnected scenarios. Dit artikel begeleidt u stapsgewijs door de gedetailleerde instructies voor deze scenario's.This article walks you through the detailed instructions for these scenarios.

U kunt ook de AzureRM-modules voor Azure Stack hub uitvoeren in een docker-container.You can also run the AzureRM modules for Azure Stack Hub in a Docker container. Zie docker gebruiken om Power shell uit te voeren voor Azure stack hubvoor instructies.For instructions, see Use Docker to run PowerShell for Azure Stack Hub.

1. Controleer uw vereisten1. Verify your prerequisites

Voordat u aan de slag gaat met Azure Stack hub en de Power shell AzureRM-module, moet u over de volgende vereisten beschikken:Before you get started with Azure Stack Hub and the PowerShell AzureRM module, you must have the following prerequisites:

  • Power shell-versie 5,1PowerShell Version 5.1
    Als u uw versie wilt controleren, voert u $PSVersionTable. PSVersion uit en vergelijkt u de primaire versie.To check your version, run $PSVersionTable.PSVersion and compare the Major version. Als u niet beschikt over Power shell 5,1, volgt u de installatie van Windows Power shell.If you don't have PowerShell 5.1, follow the Installing Windows PowerShell.

    Notitie

    Voor Power shell 5,1 is een Windows-computer vereist.PowerShell 5.1 requires a Windows machine.

  • Voer Power shell uit in een opdracht prompt met verhoogde bevoegdheden.Run PowerShell in an elevated command prompt.

  • Toegang PowerShell GalleryPowerShell Gallery access
    U moet toegang hebben tot de PowerShell Gallery.You need access to the PowerShell Gallery. De galerie is de centrale opslag plaats voor Power shell-inhoud.The gallery is the central repository for PowerShell content. De PowerShellGet -module bevat cmdlets voor het detecteren, installeren, bijwerken en publiceren van Power shell-artefacten.The PowerShellGet module contains cmdlets for discovering, installing, updating, and publishing PowerShell artifacts. Voor beelden van deze artefacten zijn modules, DSC-resources, functie mogelijkheden en scripts van de PowerShell Gallery en andere particuliere opslag plaatsen.Examples of these artifacts are modules, DSC resources, role capabilities, and scripts from the PowerShell Gallery and other private repositories. Als u Power shell gebruikt in een niet-verbonden scenario, moet u resources van een machine ophalen met een verbinding met internet en deze opslaan op een locatie die toegankelijk is voor uw computer zonder verbinding.If you're using PowerShell in a disconnected scenario, you must retrieve resources from a machine with a connection to the internet and store them in a location accessible to your disconnected machine.

Controleer of PSGallery is geregistreerd als opslag plaats.Validate if PSGallery is registered as a repository.

Notitie

Voor deze stap is Internet toegang vereist.This step requires internet access.

Open een Power shell-prompt met verhoogde bevoegdheden en voer de volgende cmdlets uit:Open an elevated PowerShell prompt, and run the following cmdlets:

Install-module -Name PowerShellGet -Force
Import-Module -Name PackageManagement -ErrorAction Stop
Get-PSRepository -Name "PSGallery"

Als de opslag plaats niet is geregistreerd, opent u een Power shell-sessie met verhoogde bevoegdheid en voert u de volgende opdracht uit:If the repository isn't registered, open an elevated PowerShell session and run the following command:

Register-PSRepository -Default
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

3. bestaande versies van de Azure Stack hub Power shell-modules verwijderen3. Uninstall existing versions of the Azure Stack Hub PowerShell modules

Voordat u de vereiste versie installeert, moet u ervoor zorgen dat u eerder geïnstalleerde Azure Stack hub AzureRM Power shell-modules verwijdert.Before installing the required version, make sure that you uninstall any previously installed Azure Stack Hub AzureRM PowerShell modules. Verwijder de modules met een van de volgende twee methoden:Uninstall the modules by using one of the following two methods:

  1. Als u de bestaande AzureRM-en AZ Power shell-modules wilt verwijderen, sluit u alle actieve Power shell-sessies en voert u de volgende cmdlets uit:To uninstall the existing AzureRM and Az PowerShell modules, close all the active PowerShell sessions, and run the following cmdlets:

    Get-Module -Name Azure* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    Get-Module -Name Azs.* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    Get-Module -Name Az.* -ListAvailable | Uninstall-Module -Force -Verbose -ErrorAction Continue
    

    Als u op een fout klikt, zoals ' de module is al in gebruik ', sluit u de Power shell-sessies die gebruikmaken van de modules en voert u het bovenstaande script opnieuw uit.If you hit an error such as 'The module is already in use', close the PowerShell sessions that are using the modules and rerun the above script.

  2. Verwijder alle mappen die beginnen met Azure Az of Azs. vanuit de C:\Program Files\WindowsPowerShell\Modules C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules mappen en.Delete all the folders that start with Azure, Az or Azs. from the C:\Program Files\WindowsPowerShell\Modules and C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules folders. Als u deze mappen verwijdert, worden ook alle bestaande Power shell-modules verwijderd.Deleting these folders removes any existing PowerShell modules.

4. connected: Power shell voor Azure Stack hub installeren met Internet verbinding4. Connected: Install PowerShell for Azure Stack Hub with internet connectivity

Het API-versie profiel en de Azure Stack hub Power shell-modules die u nodig hebt, zijn afhankelijk van de versie van Azure Stack hub die u uitvoert.The API version profile and Azure Stack Hub PowerShell modules you require will depend on the version of Azure Stack Hub you're running.

Azure Stack hub Power Shell installerenInstall Azure Stack Hub PowerShell

Voer het volgende Power shell-script uit om deze modules te installeren op uw ontwikkel werkstation:Run the following PowerShell script to install these modules on your development workstation:

Voor Azure Stack hub 2002 of hoger:For Azure Stack Hub 2002 or later:

U kunt gebruikers AzureRm-modules of AZ preview-modules gebruiken.You can use either user AzureRm modules or Az preview modules. Voor het gebruik van de AZ-modules is Azure Stack hub 2002 en de nieuwste hotfix vereist.The use of the Az modules requires Azure Stack Hub 2002 and the latest hotfix.

Als u AZ preview-modules wilt gebruiken, volgt u de instructies in de module Power shell AZ installeren.To use Az preview modules, follow the instructions at Install PowerShell Az module.

# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRM.BootStrapper

# Install and import the API Version Profile required by Azure Stack Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.8.2

Voor Azure Stack hub 1910:For Azure Stack Hub 1910:

# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRM.BootStrapper

# Install and import the API Version Profile required by Azure Stack Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.8.0

Notitie

  • Azure Stack-hub-module versie 1.8.0 is een belang rijke wijzigings release.Azure Stack Hub module version 1.8.0 is a breaking change release. Raadpleeg de opmerkingen bij de release voor meer informatie.Refer to the release note for details.

Voor Azure Stack hub 1908 of eerder:For Azure Stack Hub 1908 or earlier:

# Install the AzureRM.BootStrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRM.BootStrapper

# Install and import the API Version Profile required by Azure Stack Hub into the current PowerShell session.
Use-AzureRmProfile -Profile 2019-03-01-hybrid -Force
Install-Module -Name AzureStack -RequiredVersion 1.7.2

Notitie

De Azure Stack-hub-module versie 1.7.2 is een belang rijke wijzigings release.The Azure Stack Hub module version 1.7.2 is a breaking change release. Als u wilt migreren vanaf Azure Stack hub 1.6.0, raadpleegt u de migratie handleiding.To migrate from Azure Stack Hub 1.6.0, please refer to the migration guide.

Installatie van PowerShell bevestigenConfirm the installation of PowerShell

Bevestig de installatie door de volgende opdracht uit te voeren:Confirm the installation by running the following command:

Get-Module -Name "Azure*" -ListAvailable
Get-Module -Name "Azs*" -ListAvailable

Als de installatie is voltooid, worden de- AzureRm en- AzureStack modules weer gegeven in de uitvoer.If the installation is successful, the AzureRm and AzureStack modules are displayed in the output.

5. verbinding verbroken: Power shell zonder Internet verbinding installeren5. Disconnected: Install PowerShell without an internet connection

In het geval van een niet-verbonden scenario downloadt u eerst de Power shell-modules naar een computer met Internet verbinding.In a disconnected scenario, you first download the PowerShell modules to a machine that has internet connectivity. Vervolgens brengt u deze over naar de Azure Stack Development Kit (ASDK) voor installatie.Then, you transfer them to the Azure Stack Development Kit (ASDK) for installation.

Meld u aan bij een computer met Internet verbinding en gebruik de volgende scripts om de Azure Resource Manager-en Azure Stack hub-pakketten te downloaden, afhankelijk van uw versie van Azure Stack hub.Sign in to a computer with internet connectivity and use the following scripts to download the Azure Resource Manager and Azure Stack Hub packages, depending on your version of Azure Stack Hub.

De installatie bestaat uit vijf stappen:Installation has five steps:

  1. Installeer Azure Stack hub Power shell op een verbonden computer.Install Azure Stack Hub PowerShell to a connected machine.
  2. Schakel extra opslag functies in.Enable additional storage features.
  3. Transporteer de Power shell-pakketten naar uw niet-verbonden werk station.Transport the PowerShell packages to your disconnected workstation.
  4. Boots trap de NuGet-provider op uw niet-verbonden werk station hand matig.Manually bootstrap the NuGet provider on your disconnected workstation.
  5. Bevestig de installatie van Power shell.Confirm the installation of PowerShell.

Azure Stack hub Power Shell installerenInstall Azure Stack Hub PowerShell

Azure Stack hub 2002 of hoger.Azure Stack Hub 2002 or later.

U kunt de preview-modules AzureRM of AZ gebruiken.You could either use AzureRM or Az preview modules. Zie instructies bij de module Power shell AZ installerenvoor AZ-modules.For Az modules, see instructions at Install PowerShell Az module.


Install-module -Name PowerShellGet -Force 
Import-Module -Name PackageManagement -ErrorAction Stop

$Path = "<Path that is used to save the packages>"
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureRM -Path $Path -Force -RequiredVersion 2.5.0
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.8.2

Azure Stack hub 1910.Azure Stack Hub 1910.

Install-module -Name PowerShellGet -Force 
Import-Module -Name PackageManagement -ErrorAction Stop

$Path = "<Path that is used to save the packages>"
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureRM -Path $Path -Force -RequiredVersion 2.5.0
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.8.0

Notitie

Azure Stack-hub-module versie 1.8.0 is een belang rijke wijzigings release.Azure Stack Hub module version 1.8.0 is a breaking change release. Raadpleeg de opmerkingen bij de release voor meer informatie.Refer to the release note for details.

Voor Azure Stack hub 1908 of eerder:For Azure Stack Hub 1908 or earlier:

Install-module -Name PowerShellGet -Force 
Import-Module -Name PackageManagement -ErrorAction Stop

$Path = "<Path that is used to save the packages>"
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureRM -Path $Path -Force -RequiredVersion 2.5.0
Save-Package -ProviderName NuGet -Source https://www.powershellgallery.com/api/v2 -Name AzureStack -Path $Path -Force -RequiredVersion 1.7.2

Notitie

De Azure Stack-hub-module versie 1.7.1 is een belang rijke wijziging.The Azure Stack Hub module version 1.7.1 is a breaking change. Als u wilt migreren vanaf Azure Stack hub 1.6.0 raadpleegt u de migratie handleiding.To migrate from Azure Stack Hub 1.6.0 please refer to the migration guide.

Notitie

Op computers zonder Internet verbinding wordt u aangeraden de volgende cmdlet uit te voeren voor het uitschakelen van de telemetrie-gegevens verzameling.On machines without an internet connection, we recommend executing the following cmdlet for disabling the telemetry data collection. U kunt de prestaties van de cmdlets verlagen zonder het verzamelen van de telemetriegegevens uit te scha kelen.You may experience a performance degradation of the cmdlets without disabling the telemetry data collection. Dit is alleen van toepassing op de computers zonder Internet verbindingenThis is applicable only for the machines without internet connections

Disable-AzureRmDataCollection

Uw pakketten toevoegen aan uw werk stationAdd your packages to your workstation

  1. Kopieer de gedownloade pakketten naar een USB-apparaat.Copy the downloaded packages to a USB device.

  2. Meld u aan bij het niet-verbonden werk station en kopieer de pakketten van het USB-apparaat naar een locatie op het werk station.Sign in to the disconnected workstation and copy the packages from the USB device to a location on the workstation.

  3. Boots trap de NuGet-provider op uw niet-verbonden werk station hand matig.Manually bootstrap the NuGet provider on your disconnected workstation. Zie de NuGet-provider hand matig Boots trappen op een computer die geen verbinding heeft met Internetvoor instructies.For instructions, see Manually bootstrapping the NuGet provider on a machine that isn't connected to the internet.

  4. Registreer deze locatie als de standaard opslagplaats en installeer de AzureRM en AzureStack modules uit deze opslag plaats:Register this location as the default repository and install the AzureRM and AzureStack modules from this repository:

    # requires -Version 5
    # requires -RunAsAdministrator
    # requires -Module PowerShellGet
    # requires -Module PackageManagement
    
    $SourceLocation = "<Location on the development kit that contains the PowerShell packages>"
    $RepoName = "MyNuGetSource"
    
    Register-PSRepository -Name $RepoName -SourceLocation $SourceLocation -InstallationPolicy Trusted
    
    Install-Module -Name AzureRM -Repository $RepoName
    
    Install-Module -Name AzureStack -Repository $RepoName
    

Installatie van PowerShell bevestigenConfirm the installation of PowerShell

Bevestig de installatie door de volgende opdracht uit te voeren:Confirm the installation by running the following command:

Get-Module -Name "Azure*" -ListAvailable
Get-Module -Name "Azs*" -ListAvailable

6. Power shell configureren voor het gebruik van een proxy server6. Configure PowerShell to use a proxy server

In scenario's waarvoor een proxy server is vereist voor toegang tot internet, moet u Power shell eerst configureren voor het gebruik van een bestaande proxy server:In scenarios that require a proxy server to access the internet, you first configure PowerShell to use an existing proxy server:

  1. Open een Power shell-prompt met verhoogde bevoegdheden.Open an elevated PowerShell prompt.

  2. Voer de volgende opdrachten uit:Run the following commands:

    #To use Windows credentials for proxy authentication
    [System.Net.WebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials
    
    #Alternatively, to prompt for separate credentials that can be used for #proxy authentication
    [System.Net.WebRequest]::DefaultWebProxy.Credentials = Get-Credential
    

Bekend probleemKnown issue

Fout bij methode get_SerializationSettingsMethod get_SerializationSettings error

  • Oorzaak: de Power shell AZ-module en Power shell AzureRM-modules zijn niet compatibel.Cause: The PowerShell Az module and PowerShell AzureRM modules are not compatible.

    De volgende fout geeft aan dat de AzureRM-modules en AZ-modules in dezelfde sessie worden geladen:The following error indicates that the AzureRM modules and Az modules are loaded in the same session:

    >  Method 'get_SerializationSettings' in type 'Microsoft.Azure.Management.Internal.Resources.ResourceManagementClient' from assembly 'Microsoft.Azure.Commands.ResourceManager.Common, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' does 
    not have an implementation.
    
  • Herstel: Verwijder de conflicterende modules.Remediation: Uninstall the conflicting modules.

    Als u de AzureRM-modules wilt gebruiken, verwijdert u de AZ-modules.If you would like to use the AzureRM modules, uninstall the Az modules. Of verwijder de AzureRM als u de AZ-modules wilt gebruiken.Or uninstall the AzureRM if you would like to use the Az modules. Sluit de Power shell-sessie en verwijder de modules AZ of AzureRM.Close your PowerShell session and uninstall either the Az or AzureRM modules.

    U kunt instructies vinden bij het verwijderen van bestaande versies van de Azure stack hub Power shell-modules.You can find instructions at Uninstall existing versions of the Azure Stack Hub PowerShell modules.

Volgende stappenNext steps