Az Azure Stack Hubhoz készült PowerShell AzureRM-modul telepítése

Azure PowerShell Azure Resource Manager (AzureRM) olyan parancsmagokat biztosít, amelyek az Azure Resource Manager modellt használják az Azure Stack Hub-erőforrások kezeléséhez.

Fontos

Elérte az Azure Stack Hub PowerShell elavult verziójának weblapját. Az Azure Resource Manager (AzureRM) PowerShell-modul minden verziója elavult és nem támogatott. Az AzureRM-modulok a jövőbeni Azure Stack Hub-buildekben már nem frissülnek. Az az modulokat a 2002-s és újabb buildekhez kell használni. A 2020-09-01-hibrid profil nem támogatott az AzureRM-modulokhoz.

Az Az PowerShell-modul mostantól az Azure-ral és az Azure Stack Hubbal való kommunikációhoz ajánlott PowerShell-modul. Az Az PowerShell-modul használatának megkezdéséhez lásd: Az Azure Stack Hubhoz készült PowerShell Az előzetes verziós modul telepítése. Megtudhatja, hogyan migrálhat az Az PowerShell-modulba. Lásd: Migrálás az AzureRM-ből Azure PowerShell Az-be az Azure Stack Hubban. A globális Azure-ban elfogadott Az-modulok fokozott funkcióiról az Azure Az PowerShell-modul bemutatása című témakörben olvashat bővebben.

Api-profilokkal is meg kell adnia az Azure Stack Hub-erőforrás-szolgáltatók kompatibilis végpontjait.

Az API-profilok lehetővé teszik az Azure és az Azure Stack Hub közötti verziókülönbségek kezelését. Az API-verzióprofilok az Azure Resource Manager PowerShell-modulok meghatározott API-verziókkal rendelkező készletei. Minden felhőplatform támogatott API-verzióprofilokat biztosít. Az Azure Stack Hub például egy adott profilverziót támogat, például a 2019-03-01-hybrid verziót. Profil telepítésekor a rendszer telepíti a megadott profilnak megfelelő Azure Resource Manager PowerShell-modulokat.

Az Azure Stack Hub-kompatibilis PowerShell-modulokat internetkapcsolattal, részlegesen csatlakoztatott vagy leválasztott forgatókönyvekben telepítheti. Ez a cikk végigvezeti az ilyen forgatókönyvekre vonatkozó részletes utasításokon.

Az Azure Stack Hubhoz készült Azure Resource Manager-modulokat egy Docker-tárolóban is futtathatja. Útmutatásért lásd: A Docker használata az Azure Stack Hubhoz készült PowerShell futtatásához.

1. Az előfeltételek ellenőrzése

Az Azure Stack Hub és a PowerShell Azure Resource Manager modul használatának megkezdése előtt a következő előfeltételekkel kell rendelkeznie:

• PowerShell 5.1-es verzió
  A verzió ellenőrzéséhez futtassa a $PSVersionTable.PSVersion parancsot, és hasonlítsa össze a főverziót . Ha nem rendelkezik PowerShell 5.1-et, kövesse a Telepítés Windows PowerShell című témakört.

  Megjegyzés

  A PowerShell 5.1 használatához Windows rendszerű gép szükséges.

• Futtassa a PowerShellt egy emelt szintű parancssorban.

• PowerShell-galéria hozzáférés
  Hozzáférésre van szüksége a PowerShell-galéria. A gyűjtemény a PowerShell-tartalmak központi adattára. A PowerShellGet modul a PowerShell-összetevők felderítésére, telepítésére, frissítésére és közzétételére szolgáló parancsmagokat tartalmaz. Ilyen összetevők például a modulok, a DSC-erőforrások, a szerepkör-képességek és a PowerShell-galéria és más magánadattárak szkriptjei. Ha leválasztott forgatókönyvben használja a PowerShellt, le kell kérnie az erőforrásokat egy internetkapcsolattal rendelkező gépről, és azokat a leválasztott gép számára elérhető helyen kell tárolnia.

2. A PowerShell-galéria akadálymentességének ellenőrzése

Ellenőrizze, hogy a PSGallery adattárként van-e regisztrálva.

Megjegyzés

Ehhez a lépéshez internet-hozzáférés szükséges.

Nyisson meg egy emelt szintű PowerShell-parancssort, és futtassa a következő parancsmagokat:

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

Ha az adattár nincs regisztrálva, nyisson meg egy emelt szintű PowerShell-munkamenetet, és futtassa a következő parancsot:

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

3. Az Azure Stack Hub PowerShell-modulok meglévő verzióinak eltávolítása

A szükséges verzió telepítése előtt távolítsa el a korábban telepített Azure Stack Hub Azure Resource Manager PowerShell-modulokat. Távolítsa el a modulokat az alábbi két módszer egyikével:

1. A meglévő Azure Resource Manager- és Az PowerShell-modulok eltávolításához zárja be az összes aktív PowerShell-munkamenetet, és futtassa a következő parancsmagokat:

   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
   

   Ha "A modul már használatban van" hibaüzenetet kapja, zárja be a modulokat használó PowerShell-munkameneteket, és futtassa újra a fenti szkriptet.

2. Törölje az összes mappát, amely a következővel Azurekezdődik: , Az vagy Azs. a és C:\Users\{yourusername}\Documents\WindowsPowerShell\Modules a C:\Program Files\WindowsPowerShell\Modules mappából. A mappák törlése eltávolítja a meglévő PowerShell-modulokat.

4. Csatlakoztatva: Az Azure Stack Hubhoz készült PowerShell telepítése internetkapcsolattal

Az API-verzióprofil és a szükséges Azure Stack Hub PowerShell-modulok a futó Azure Stack Hub verziójától függnek.

Az Azure Stack Hub PowerShell telepítése

A következő PowerShell-szkript futtatásával telepítse ezeket a modulokat a fejlesztői munkaállomásra:

Az Azure Stack Hub 2002-ben vagy újabb verzióiban:

Használhat felhasználói AzureRm-modulokat vagy az Az előzetes verziójú modulokat. Az Az-modulok használatához az Azure Stack Hub 2002 vagy újabb verziója szükséges.

Az előzetes verziójú modulok használatához kövesse a PowerShell Az modul telepítése című témakör utasításait.

# 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.3 

A PowerShell telepítésének megerősítése

A telepítés megerősítéséhez futtassa a következő parancsot:

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

Ha a telepítés sikeres, a és AzureStack a AzureRm modulok megjelennek a kimenetben.

5. Leválasztva: A PowerShell telepítése internetkapcsolat nélkül

Leválasztott forgatókönyv esetén először letölti a PowerShell-modulokat egy internetkapcsolattal rendelkező gépre. Ezután át kell vinnie őket az Azure Stack Fejlesztői Készletbe (ASDK) a telepítéshez.

Jelentkezzen be egy internetkapcsolattal rendelkező számítógépre, és az alábbi szkriptekkel töltse le az Azure Resource Manager és az Azure Stack Hub csomagokat az Azure Stack Hub verziójától függően.

A telepítés öt lépésből áll:

1. Telepítse az Azure Stack Hub PowerShellt egy csatlakoztatott gépre.
2. További tárolási funkciók engedélyezése.
3. A PowerShell-csomagok átvitele a leválasztott munkaállomásra.
4. Manuálisan indítsa el a NuGet-szolgáltatót a leválasztott munkaállomáson.
5. Ellenőrizze a PowerShell telepítését.

Az Azure Stack Hub PowerShell telepítése

Azure Stack Hub 2002 vagy újabb.

Használhatja az Azure Resource Manager vagy az az előzetes verziójú modulokat. Az modulokért lásd a PowerShell Az-modul telepítésére vonatkozó utasításokat.

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.3

Megjegyzés

Internetkapcsolattal nem rendelkező gépeken javasoljuk, hogy hajtsa végre az alábbi parancsmagot a telemetriai adatgyűjtés letiltására. Előfordulhat, hogy a parancsmagok teljesítménycsökkenését tapasztalja a telemetriai adatgyűjtés letiltása nélkül. Ez csak az internetkapcsolattal nem rendelkező gépekre vonatkozik

Disable-AzureRmDataCollection

Csomagok hozzáadása a munkaállomáshoz

1. Másolja a letöltött csomagokat egy USB-eszközre.

2. Jelentkezzen be a leválasztott munkaállomásra, és másolja a csomagokat az USB-eszközről a munkaállomás egy helyére.

3. Manuálisan indítsa el a NuGet-szolgáltatót a leválasztott munkaállomáson. Útmutatásért lásd: A NuGet-szolgáltató manuális rendszerindítása olyan gépen, amely nem csatlakozik az internethez.

4. Regisztrálja ezt a helyet alapértelmezett adattárként, és telepítse az Azure Resource Manager és AzureStack modulokat ebből az adattárból:

   # 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
   

A PowerShell telepítésének megerősítése

Erősítse meg a telepítést a következő parancs futtatásával:

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

6. A PowerShell konfigurálása proxykiszolgáló használatára

Azokban az esetekben, amikor proxykiszolgálóra van szükség az internethez való hozzáféréshez, először konfigurálja a PowerShellt egy meglévő proxykiszolgáló használatára:

1. Nyisson meg egy emelt szintű PowerShell-parancssort.

2. Futtassa az alábbi parancsot:

   #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
   

Ismert probléma

Get_SerializationSettings metódus hibája

• Ok: A PowerShell Az modul és a PowerShell Azure Resource Manager-modulok nem kompatibilisek.

  A következő hiba azt jelzi, hogy az Azure Resource Manager-modulok és az Az-modulok ugyanabban a munkamenetben töltődnek be:

  >  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.
  

• Szervizelés: Távolítsa el az ütköző modulokat.

  Ha az Azure Resource Manager modulokat szeretné használni, távolítsa el az Az modulokat. Vagy távolítsa el az Azure Resource Manager, ha az Az-modulokat szeretné használni. Zárja be a PowerShell-munkamenetet, és távolítsa el az Az vagy az Azure Resource Manager modult.

  Útmutatást az Azure Stack Hub PowerShell-modulok meglévő verzióinak eltávolítása című témakörben talál.

Hiba történt a NewAzureRMADServicePrincipal és a NewAzureRMAdApplication hiba miatt

• Alkalmazható: Azure Stack-környezetek Microsoft Entra ID használatával.

• Ok: Az Azure Active Directory Graph kompatibilitástörő változást vezetett be, amely korlátozza, hogy az IdentifierUri Active Directory-alkalmazások egy ellenőrzött tartomány altartományai legyenek a címtárban. A módosítás előtt ezt a korlátozást csak a több-bérlős alkalmazásokra kényszerítették. Ez a korlátozás mostantól az egybérlős alkalmazásokra is vonatkozik. A módosítás a következő hibát eredményezi: Values of identifierUris property must use a verified domain of the organization or its subdomain' is displayed when running.

• Szervizelés: Ezt a korlátozást kétféleképpen megkerülheti.

  • Olyan egyszerű szolgáltatásnevet kell használnia, amely a címtárbérlő altartománya. Ha például a könyvtár , contoso.onmicrosoft.coma szolgáltatásnévnek a következő formában <foo>.contoso.onmicrosoft.comkell lennie: . Használja a következő parancsmagot:

    NewAzureRMADServicePrincipal -Role Owner -DisplayName <foo>.contoso.onmicrosoft.com
    

    Az identitással és a szolgáltatásnevek Azure Stack Hubbal való használatával kapcsolatos további információkért lásd: Az Azure Stack Hub identitásszolgáltatóinak áttekintése.

  • Hozza létre a Microsoft Entra alkalmazást, amely érvényesIdentifierUri, majd hozza létre a szolgáltatásnevet az alkalmazás társításával a következő parancsmag használatával:

    $app=NewAzureRMAdApplication -DisplayName 'newapp' -IdentifierUris http://anything.contoso.onmicrosoft.com
    NewAzureRMADServicePrincipal -Role Owner -ApplicationId $app.ApplicationId
    

• Előfordulás: Gyakori

Következő lépések

• Azure Stack Hub-eszközök letöltése a GitHubról
• Az Azure Stack Hub-felhasználó PowerShell-környezetének konfigurálása
• Az Azure Stack Hub-operátor PowerShell-környezetének konfigurálása
• API-verzióprofilok kezelése az Azure Stack Hubban