Problemen met de 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 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'

Aankondigingsberichten in automatiseringsscenario's

Wanneer u verbinding maakt met Azure met Azure PowerShell, worden aankondigingsberichten weergegeven met behulp van de informatiestroom van PowerShell om te voorkomen dat ze de geretourneerde objectuitvoer wijzigen. Hoewel we alles hebben gedaan om ervoor te zorgen dat de aankondigingsberichten niet van invloed zijn op uw ervaring, zijn er enkele automatiseringsscenario's waarin ze van invloed kunnen zijn op het gebruik. Als u problemen ondervindt, wordt u aangeraden de informatiestroom in deze scenario's te onderdrukken:

Connect-AzAccount -Subscription '<subscription name or id>' -InformationAction Ignore

Webaccountbeheerder (WAM)

• De interactieve aanmeldingsmethode kan geen venster voor WAM openen en retourneert de fout: door gebruiker geannuleerde verificatie.
• Azure PowerShell-cmdlets kunnen niet worden uitgevoerd nadat u zich hebt aangemeld met een gebruikersnaam en wachtwoord of apparaatcode.
• In het pop-upvenster van WAM wordt de optie werk- en schoolaccount niet weergegeven.
• De interactieve aanmeldingsmethode kan geen WAM-venster openen in de Windows PowerShell ISE-console.

De tijdelijke oplossing voor deze problemen is om WAM uit te schakelen:

Update-AzConfig -EnableLoginByWam $false

• Het pop-upvenster van WAM om een account te selecteren, is niet gemakkelijk te vinden. Minimaliseer andere vensters om het pop-upvenster te vinden.

Installatie

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

Az en AzureRM coëxistentie

In een scenario waarin u zowel de AzureRM- als de Az PowerShell-module op hetzelfde Windows-systeem moet installeren:

• AzureRM moet alleen worden geïnstalleerd in het huidige gebruikersbereik van Windows PowerShell 5.1.
• Installeer de Az PowerShell-module in PowerShell 7.2 of hoger.

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 handmatig installeren de Az PowerShell-module.

Proxy blokkeert de verbinding

Als u van Install-Module fouten ontvangt dat de PowerShell Gallery onbereikbaar is, bevindt u zich mogelijk achter een proxy. Verschillende besturingssystemen en netwerkomgevingen hebben verschillende vereisten voor het configureren van een systeembrede proxy. Neem contact op met uw systeembeheerder voor uw proxy-instellingen en hoe u deze configureert voor uw omgeving.

PowerShell zelf is mogelijk niet geconfigureerd om deze proxy automatisch te gebruiken. Configureer met PowerShell 5.1 en hoger de PowerShell-sessie om een proxy te gebruiken met behulp van de volgende opdrachten:

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

Als de referenties van uw besturingssysteem correct zijn geconfigureerd, routeert deze configuratie PowerShell-aanvragen via de proxy. Als u deze instelling tussen sessies wilt behouden, voegt u de opdrachten toe aan uw PowerShell-profiel.

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

Objectverwijzing is niet ingesteld op een exemplaar van een object

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

$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

Problemen met toestemmingen voor AzAD-cmdlets

De Az PowerShell-module maakt gebruik van de Microsoft Graph API. Voor het beheren of beheren van resources in Azure met de Az PowerShell-module zijn dezelfde machtigingen vereist als het uitvoeren van de identieke taak vanuit Azure Portal of een ander azure-opdrachtregelprogramma. Zie de Microsoft Graph-machtigingenreferentiesvoor specifieke vragen over machtigingen.

Microsoft Graph-queryparameters

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

Get-AzAdGroupMember retourneert geen service-principals

Vanwege beperkingen van de huidige Graph API worden service principals niet teruggegeven door Get-AzAdGroupMember in Az 7.x. Als tijdelijke oplossing kan Invoke-AzRestMethod- worden gebruikt met de bètaversie van de 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 een van de Az PowerShell-opdrachten probeert 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 u zowel de Az- als AzureRM PowerShell-modules hebt geïnstalleerd op hetzelfde Windows-systeem en deze aanwezig zijn in de $env:PSModulePath- voor dezelfde versie van PowerShell.

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

In macOS wordt een fout geretourneerd wanneer de sleutelhangerautorisatie mislukt

Wanneer u Azure PowerShell uitvoert op 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 steeds Connect-AzAccount uitvoeren wanneer u een nieuwe PowerShell-sessie start.

Disable-AzContextAutosave

De verbinding voor deze site is niet beveiligd

Wanneer uw standaardbrowser Microsoft Edge is, kan er een fout optreden wanneer u zich interactief probeert aan te melden bij Azure met Connect-AzAccount: 'De verbinding voor deze site is niet beveiligd." Ga naar edge://net-internals/#hsts in Microsoft Edge om dit probleem op te lossen. Voeg localhost toe onder "Domeinbeveiligingsbeleid verwijderen" en klik op Verwijderen.

Fout met geverifieerd domein van Service Principal IdentifierUri

Fout: de eigenschap IdentifierUris moet een geverifieerd domein van de organisatie of het bijbehorende subdomein gebruiken wordt weergegeven bij het uitvoeren van New-AzADServicePrincipal of New-AzADApplication.

Vanwege de breaking change in Microsoft Entra waarbij de AppId URI in toepassingen met één tenant vereist is om gebruik te maken van het standaardschema of geverifieerde domeinen, moet u de module Az.Resources upgraden naar versie 4.1.0 of hoger om door te kunnen gaan met het gebruik van New-AzADServicePrincipal of New-AzADApplication cmdlets.

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

Tijdlijn

De eis is van kracht geworden op 15 oktober 2021.

Getroffen versies

De volgende versies van Azure PowerShell worden beïnvloed door de breaking change in AzureAD:

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

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

Tijdelijke oplossing

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

• Voeg indien nodig uw aangepaste domeinnaam toe met behulp van het Microsoft Entra-beheercentrum
• Een toepassing maken met een geaccepteerde IdentifierUri
• Een service-principal maken die naar deze toepassing verwijst

Andere problemen

Als u een productprobleem ondervindt met Azure PowerShell die niet in dit artikel wordt vermeld of als u meer hulp nodig hebt, een probleem op GitHubindienen.