Problemen met de Azure Az PowerShell-module oplossen

Logboekregistratie voor foutopsporing inschakelen

Een van de eerste stappen die u moet uitvoeren bij het oplossen van een probleem met de Azure Az PowerShell-module is het inschakelen van logboekregistratie voor foutopsporing.

Als u logboekregistratie voor foutopsporing per opdracht wilt inschakelen, geeft u de parameter Foutopsporing op.

Get-AzResource -Name 'DoesNotExist' -Debug

Als u logboekregistratie voor foutopsporing wilt inschakelen voor een volledige PowerShell-sessie, stelt u de waarde van de variabele DebugPreference in op Continue.

$DebugPreference = 'Continue'

Installatie

Deze sectie bevat een lijst met oplossingen voor veelvoorkomende problemen bij het installeren van de Azure Az PowerShell-module.

Az en AzureRM co-existentie

Waarschuwing

We ondersteunen niet dat zowel de AzureRM- als de Az-module tegelijkertijd zijn geïnstalleerd voor PowerShell 5.1 onder Windows.

In een scenario waarin u zowel AzureRM als de Az PowerShell-module op hetzelfde systeem wilt installeren, moet AzureRM alleen worden geïnstalleerd in het gebruikersbereik voor Windows PowerShell. Installeer de Az PowerShell-module voor PowerShell 7.0.6 LTS, PowerShell 7.1.3 of hoger op hetzelfde systeem.

Belangrijk

Omdat Az PowerShell-modules nu alle mogelijkheden van AzureRM PowerShell-modules en meer hebben, wordt AzureRM PowerShell-modules op 29 februari 2024 buiten gebruik gesteld.

Als u serviceonderbrekingen wilt voorkomen, werkt u uw scripts bij die gebruikmaken van AzureRM PowerShell-modules voor het gebruik van Az PowerShell-modules op 29 februari 2024. Volg de snelstartgids om uw scripts automatisch bij te werken.

Visual Studio

Oudere versies van Visual Studio kunnen Azure PowerShell installeren als onderdeel van de Azure-ontwikkelworkload, waarmee de AzureRM-module wordt geïnstalleerd. Azure PowerShell kan worden verwijderd met behulp van het Visual Studio-installatieprogramma of met behulp van 'Verwijderen' in apps-functies&. Als u PowerShell 7.x al hebt geïnstalleerd, moet u mogelijk de Azure Az PowerShell-module handmatig installeren .

Proxy blokkeert verbinding

Als u fouten krijgt van Install-Module die PowerShell Gallery niet bereikbaar is, bevindt u zich mogelijk achter een proxy. Verschillende besturingssystemen en netwerkomgevingen hebben verschillende vereisten om een systeembrede proxy te configureren. Neem contact op met uw systeembeheerder voor uw proxyinstellingen en voor instructies voor het configureren van deze instellingen voor uw omgeving.

PowerShell zelf is mogelijk niet geconfigureerd om deze proxy automatisch te gebruiken. Met PowerShell 5.1 en hoger configureert u de PowerShell-sessie zo dat een proxy wordt gebruikt met de volgende opdrachten:

$webClient = New-Object -TypeName System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Als de referenties voor uw besturingssysteem correct zijn geconfigureerd, worden met deze configuratie PowerShell-aanvragen via de proxy gerouteerd. Als u deze instelling tussen verschillende sessies wilt behouden, voegt u de opdracht toe aan een PowerShell-profiel.

Als u het pakket wilt installeren, moet uw proxy HTTPS-verbindingen met www.powershellgallery.com toestaan.

Objectverwijzing is niet ingesteld op een exemplaar van een object

Het bericht 'Objectverwijzing is niet ingesteld op een exemplaar van een object' betekent dat u verwijst naar een object dat null of een Azure-resource is die niet bestaat of dat u geen machtigingen hebt voor toegang.

$resourceId =  '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<resource-group-name>/providers/Microsoft.Web/sites/<webapp-name>/privateEndpointConnections/<endpoint-name>'
Get-AzPrivateEndpointConnection -ResourceId $resourceId
Get-AzPrivateEndpointConnection: Object reference not set to an instance of an object.

U kunt de Get-AzResource cmdlet gebruiken om te controleren of de opgegeven Azure-resource bestaat.

Get-AzResource -ResourceId $resourceId

Machtigingsproblemen met AzAD-cmdlets

Naslaginformatie over Microsoft Graph-machtigingen

Microsoft Graph-queryparameters

AzAd-cmdlets onder Az.Resources ondersteunen nu queryparameters en zoekqueryparameters. Zie de eerder opgegeven koppelingen voor meer informatie over de syntaxis.

Get-AzAdGroupMember retourneert geen service-principals

Vanwege beperkingen met de huidige Graph API worden service-principals niet geretourneerd door Get-AzAdGroupMember in Az 7.x. Als tijdelijke oplossing kan Invoke-AzRestMethod worden gebruikt met de bètaversie van microsoft Graph API.

Voor het volgende voorbeeld is de Az PowerShell-module vereist. Vervang myGroupName in de eerste regel door de naam van uw groep.

$Group = Get-AzADGroup -DisplayName myGroupName
((Invoke-AzRestMethod -Uri "https://graph.microsoft.com/beta/groups/$($Group.id)/members").Content |
  ConvertFrom-Json).value |
  Select-Object -Property DisplayName, Id, @{label='OdataType';expression={$_.'@odata.type'}}

Opdracht gevonden, maar kan niet worden geladen

Het volgende bericht wordt geretourneerd door PowerShell wanneer u probeert een van de Az PowerShell-opdrachten uit te voeren.

Connect-AzAccount: The 'Connect-AzAccount' command was found in the module 'Az.Accounts', but the module could not be loaded. For more information, run 'Import-Module Az.Accounts'.

Dit bericht treedt op wanneer de Az- en AzureRM PowerShell-modules zijn geïnstalleerd op hetzelfde Windows-systeem en deze aanwezig zijn in de $env:PSModulePath voor dezelfde versie van PowerShell.

Belangrijk

Wanneer AzureRM is geïnstalleerd in het AllUsers bereik van Windows PowerShell, wordt deze geïnstalleerd op een locatie die deel uitmaakt van powerShell $env:PSModulePath 7. Dit wordt niet ondersteund vanwege conflicten tussen de AzureRM- en Az PowerShell-modules.

Zowel Az als AzureRM kunnen naast elkaar bestaan in hetzelfde Windows-systeem, maar alleen als AzureRM is geïnstalleerd binnen het CurrentUser bereik van Windows PowerShell en Az dat is geïnstalleerd in PowerShell 7. Zie De Azure Az PowerShell-module installeren voor meer informatie.

Belangrijk

Omdat Az PowerShell-modules nu alle mogelijkheden van AzureRM PowerShell-modules en meer hebben, wordt AzureRM PowerShell-modules op 29 februari 2024 buiten gebruik gesteld.

Als u serviceonderbrekingen wilt voorkomen, werkt u uw scripts bij die gebruikmaken van AzureRM PowerShell-modules voor het gebruik van Az PowerShell-modules op 29 februari 2024. Volg de snelstartgids om uw scripts automatisch bij te werken.

In MacOS wordt een fout geretourneerd wanneer sleutelhangerautorisatie mislukt

Wanneer u Azure PowerShell uitvoert in MacOS, treedt er mogelijk een foutbericht op tijdens het aanmelden bij uw Azure-account vanuit een PowerShell-sessie.

DeviceCodeCredential authentication failed: Persistence check failed. Reason: KeyChain authorization/authentication failed. .Error code: -25293. OS error code -25293.

Als tijdelijke oplossing voor dit probleem kunt u het opslaan van referenties tussen sessies uitschakelen door de volgende opdracht uit te voeren. Nadat u deze wijziging hebt aangebracht, moet u echter elke keer worden uitgevoerd Connect-AzAccount wanneer u een nieuwe PowerShell-sessie start.

Disable-AzContextAutosave

Fout in geverifieerd domein van service-principal-id

Fout: waarden van de eigenschap identifierUris moeten een geverifieerd domein van de organisatie of het bijbehorende subdomein gebruiken bij het uitvoeren New-AzADServicePrincipal of New-AzADApplication.

Vanwege de wijziging die fouten veroorzaakt in Azure Active Directory waarvoor AppId Uri in toepassingen met één tenant vereist is om het gebruik van standaardschema of geverifieerde domeinen te vereisen , moet u de Az.Resources-module upgraden naar versie 4.1.0 of hoger om door te gaan met het gebruik New-AzADServicePrincipal of New-AzADApplication cmdlets.

U kunt ook upgraden naar Az PowerShell-moduleversie 6.0 of hoger.

Tijdlijn

De vereiste wordt van kracht vanaf 10-15-2021.

Beïnvloede versies

De volgende versies van Azure PowerShell worden beïnvloed door de wijziging die fouten veroorzaakt in AzureAD:

  • Az.Resources PowerShell-module versie 3.5.1-preview of minder.
  • Az PowerShell module versie 5.9.0 of lager.

Als u na de upgrade nog steeds problemen ondervindt, kunt u een probleem openen.

Tijdelijke oplossing

Als u geen upgrade kunt uitvoeren naar de hierboven beschreven PowerShell-modules, kunt u deze stappen volgen bij het maken van een service-principal:

Overige problemen

Als u een productprobleem ondervindt met Azure PowerShell niet vermeld in dit artikel of hulp nodig hebt, dient u een probleem in op GitHub.