Azure PowerShell Kontextobjekte

Azure PowerShell verwendet Azure PowerShell Kontextobjekte (Azure Kontexte) zum Speichern von Abonnement- und Authentifizierungsinformationen. Wenn Sie Zugriff auf mehrere Abonnements haben, ermöglicht Ihnen die Azure Kontextverwaltung, das Abonnement auszuwählen, für das die Azure PowerShell-Cmdlets ausgeführt werden sollen. Azure Kontexte werden auch verwendet, um Anmeldeinformationen in mehreren PowerShell-Sitzungen zu speichern und Hintergrundaufgaben auszuführen.

In diesem Artikel wird die Verwaltung von Azure-Kontexten behandelt, nicht die Verwaltung von Abonnements oder Konten. Wenn Sie Benutzer, Abonnements, Mandanten oder andere Kontoinformationen verwalten möchten, lesen Sie die Dokumentation Microsoft Entra ID. Informationen zum Verwenden von Kontexten zum Ausführen von Hintergrund- oder parallelen Aufgaben finden Sie unter Run Azure PowerShell Cmdlets in PowerShell-Aufträgen nachdem Sie sich mit Azure Kontexten vertraut machen.

Übersicht über Azure Kontextobjekte

Azure Kontexte sind PowerShell-Objekte, die Ihr aktives Abonnement zum Ausführen von Befehlen darstellen, und die Authentifizierungsinformationen, die zum Herstellen einer Verbindung mit einer Azure Cloud erforderlich sind. Bei Azure Kontexten muss Azure PowerShell Ihr Konto nicht jedes Mal erneut authentifizieren, wenn Sie Abonnements wechseln. Ein Azure Kontext besteht aus:

• Das account, das zum Anmelden bei Azure mit Connect-AzAccount verwendet wurde. Azure Kontexte behandeln Benutzer, Anwendungs-IDs und Dienstprinzipale aus Kontosicht gleich.
• Die aktive Abonnement, eine Servicevereinbarung mit Microsoft zum Erstellen und Ausführen von Azure-Ressourcen, die einem Mandant zugeordnet sind. Mandanten werden häufig als Organisationen in der Dokumentation oder bei der Arbeit mit Microsoft Entra bezeichnet.
• Ein Verweis auf einen token-Cache, ein gespeichertes Authentifizierungstoken für den Zugriff auf eine Azure Cloud. Die Einstellungen für das automatische Speichern des Kontexts bestimmen, wo das Token gespeichert wird und wie lange es beibehalten wird.

Weitere Informationen zu diesen Begriffen finden Sie unter Microsoft Entra Terminologie. Authentifizierungstoken, die von Azure Kontexten verwendet werden, sind identisch mit anderen gespeicherten Token, die Teil einer persistenten Sitzung sind.

Wenn Sie sich mit Connect-AzAccount anmelden, wird mindestens ein Azure Kontext für Ihr Standardabonnement erstellt. Das von Connect-AzAccount zurückgegebene Objekt ist der Standardkontext Azure, der für die restliche PowerShell-Sitzung verwendet wird.

Azure Kontexte abrufen

Verfügbare Azure Kontexte werden mit dem Cmdlet Get-AzContext abgerufen. Auflisten der verfügbaren Kontexte mit dem Parameter ListAvailable :

Get-AzContext -ListAvailable

Oder rufen Sie einen Kontext anhand des Namens ab:

Get-AzContext -Name MyContextName

Kontextnamen unterscheiden sich möglicherweise vom Namen des zugehörigen Abonnements. Um den Kontextnamen zu ermitteln, verwenden Sie den Wert der Name-Eigenschaft , die standardmäßig nicht angezeigt wird.

Get-AzContext -ListAvailable | Select-Object -Property *

Erstellen eines neuen Azure Kontexts aus Abonnementinformationen

Mit dem Cmdlet Set-AzContext werden neue Azure Kontexte als aktiver Kontext erstellt und festgelegt. Die einfachste Möglichkeit zum Erstellen eines neuen Azure Kontexts besteht darin, vorhandene Abonnementinformationen zu verwenden. Das Cmdlet Set-AzContext ist so konzipiert, dass es das Ausgabeobjekt von Get-AzSubscription als weitergeleiteten Wert entgegennimmt und einen neuen Azure-Kontext konfiguriert.

Get-AzSubscription -SubscriptionName MySubscriptionName |
  Set-AzContext -Name MyContextName

Oder geben Sie bei Bedarf den Namen oder die ID des Abonnements und die Mandanten-ID an:

Set-AzContext -Name MyContextName -Subscription MySubscriptionName -Tenant 00000000-0000-0000-0000-000000000000

Wenn der Parameter Name nicht angegeben wird, werden der Name und die ID des Abonnements als Kontextname im Format Subscription Name (subscription-id)verwendet.

Ändern des aktiven Azure Kontexts

Sowohl Set-AzContext als auch Select-AzContext können verwendet werden, um den aktiven Azure Kontext zu ändern. Wie in "Erstellen Sie einen neuen Azure-Kontext" beschrieben, erstellt Set-AzContext einen neuen Azure-Kontext für ein Abonnement, falls keiner vorhanden ist, und wechselt dann den aktiven Kontext zu diesem.

Select-AzContext soll nur mit vorhandenen Azure Kontexten verwendet werden und funktioniert ähnlich wie die Verwendung von Set-AzContext -Context, ist jedoch für die Verwendung mit Rohrleitungen vorgesehen:

Set-AzContext -Context (Get-AzContext -Name MyContextName) # Set a context with an inline Azure context object
Get-AzContext -Name MyContextName | Select-AzContext # Set a context with a piped Azure context object

Wie viele andere Konto- und Kontextverwaltungsbefehle in Azure PowerShell unterstützen Set-AzContext und Select-AzContext den Parameter Scope, damit Sie steuern können, wie lange der Kontext aktiv ist. Scope ermöglicht Ihnen, den aktiven Kontext einer einzelnen Sitzung zu ändern, ohne die Standardeinstellung zu verändern:

Get-AzContext -Name MyContextName | Select-AzContext -Scope Process

Um den Wechsel von Kontexten für eine gesamte PowerShell-Sitzung zu vermeiden, können Azure PowerShell Befehle mit einem AzContextParameter für einen bestimmten Kontext ausgeführt werden:

$context = Get-AzContext -Name MyContextName
New-AzVM -Name ExampleVM -AzContext $context

Die andere primäre Verwendung von Kontexten mit Azure PowerShell Cmdlets besteht darin, Hintergrundbefehle auszuführen. Weitere Informationen zum Ausführen von PowerShell-Aufträgen mit Azure PowerShell finden Sie unter Run Azure PowerShell Cmdlets in PowerShell-Aufträgen.

Azure-Kontexte über PowerShell-Sitzungen hinweg speichern

Standardmäßig werden Azure Kontexte für die Verwendung zwischen PowerShell-Sitzungen gespeichert. Sie können dieses Verhalten auf folgende Weise ändern:

• Melden Sie sich mit -Scope Process über Connect-AzAccount an.

  Connect-AzAccount -Scope Process
  

  Der im Rahmen dieser Anmeldung zurückgegebene Azure-Kontext ist für die aktuelle Sitzung nur gültig und wird unabhängig von der Einstellung für das automatische Speichern des Azure PowerShell-Kontexts nicht automatisch gespeichert.

• Deaktivieren Sie das automatische Speichern von Kontexten in Azure PowerShell mit dem Cmdlet Disable-AzContextAutosave. Durch deaktivieren des automatischen Speicherns von Kontexten werden keine gespeicherten Token gelöscht. Informationen zum Löschen gespeicherter Azure Kontextinformationen finden Sie unter Remove Azure Kontexte und gespeicherte Anmeldeinformationen.

• Explizites Aktivieren von Azure-Kontextautomatischem Speichern kann mit dem Cmdlet Enable-AzContextAutosave aktiviert werden. Wenn das automatische Speichern aktiviert ist, werden die Kontexte eines Benutzers für spätere PowerShell-Sitzungen lokal gespeichert.

• Speichern Sie Kontexte manuell mit Save-AzContext, damit sie in zukünftigen PowerShell-Sitzungen verwendet und mit Import-AzContext geladen werden können.

  Save-AzContext -Path current-context.json # Save the current context
  Import-AzContext -Path other-context.json # Load the context from a file and set it to the current context
  

Jeder dieser Befehle unterstützt den Scope-Parameter, der nur auf den aktuell laufenden Prozess angewendet werden kann. Um beispielsweise sicherzustellen, dass neu erstellte Kontexte nach dem Beenden einer PowerShell-Sitzung nicht gespeichert werden:

Disable-AzContextAutosave -Scope Process
Set-AzContext -Subscription 'Subscription ID or Name' -Tenant 00000000-0000-0000-0000-000000000000

Kontextinformationen und Token werden im Verzeichnis $env:USERPROFILE\.Azure auf Windows und $HOME/.Azure auf anderen Plattformen gespeichert. Vertrauliche Informationen wie Abonnement-IDs und Mandanten-IDs können weiterhin in gespeicherten Informationen, über Protokolle oder gespeicherte Kontexte verfügbar gemacht werden. Informationen zum Löschen gespeicherter Informationen finden Sie unter Remove Azure Kontexte und gespeicherte Anmeldeinformationen.

Entfernen von Azure Kontexten und gespeicherten Anmeldeinformationen

So löschen Sie Azure Kontexte und Anmeldeinformationen:

• Melden Sie sich von einem Konto mit Disconnect-AzAccount ab. Sie können sich von jedem Konto entweder nach Konto oder Kontext abmelden:

  Disconnect-AzAccount # Disconnect active account
  Disconnect-AzAccount -Username 'user@contoso.com' # Disconnect by account name
  Disconnect-AzAccount -ContextName MyContextName # Disconnect by context name
  
  $context = Get-AzContext
  Disconnect-AzAccount -AzureContext $context # Disconnect using context object information
  

  Durch die Trennung werden gespeicherte Authentifizierungstoken immer entfernt und gespeicherte Kontexte gelöscht, die dem getrennten Benutzer oder Kontext zugeordnet sind.

• Verwenden Sie Clear-AzContext. Dieses Cmdlet entfernt immer gespeicherte Kontexte und Authentifizierungstoken und meldet Sie ab.

• Entfernen eines Kontexts mit Remove-AzContext:

  Remove-AzContext -Name MyContextName # Remove by name
  Get-AzContext -Name MyContextName | Remove-AzContext # Remove by piping an Azure context object
  

  Wenn Sie den aktiven Kontext entfernen, werden Sie von Azure getrennt und müssen mit Connect-AzAccount erneut authentifizieren.

Siehe auch

• Connect-AzAccount
• Disconnect-AzAccount
• Get-AzContext
• Set-AzContext
• Save-AzContext
• Select-AzContext
• Import-AzContext
• Clear-AzContext
• Remove-AzContext
• Enable-AzContextAutosave
• Disable-AzContextAutosave
• Get-AzSubscription