Freigeben über

Remove-AzureAccount

  • Referenz
Modul:
Azure

Löscht ein Azure-Konto aus Windows PowerShell.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

Remove-AzureAccount
      -Name <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-AzureAccount löscht ein Azure-Konto und seine Abonnements aus der Abonnementdatendatei in Ihrem Roamingbenutzerprofil. Das Konto wird nicht aus Microsoft Azure gelöscht oder das tatsächliche Konto auf irgendeine Weise geändert.

Die Verwendung dieses Cmdlets ähnelt dem Abmelden Ihres Azure-Kontos. Und wenn Sie sich erneut beim Konto anmelden möchten, verwenden Sie das Add-AzureAccount oder Import-AzurePublishSettingsFile , um das Konto erneut zu Windows PowerShell hinzuzufügen.

Sie können auch das Cmdlet Remove-AzureAccount verwenden, um die Art und Weise zu ändern, wie sich die Azure PowerShell-Cmdlets bei Ihrem Azure-Konto anmelden. Wenn Ihr Konto sowohl über ein Verwaltungszertifikat aus Import-AzurePublishSettingsFile als auch über ein Zugriffstoken aus Add-AzureAccount verfügt, verwenden die Azure PowerShell-Cmdlets nur das Zugriffstoken. Sie ignorieren das Verwaltungszertifikat. Um das Verwaltungszertifikat zu verwenden, führen Sie Remove-AzureAccount aus. Wenn Remove-AzureAccount sowohl ein Verwaltungszertifikat als auch ein Zugriffstoken findet, löscht es nur das Zugriffstoken, anstatt das Konto zu löschen. Das Verwaltungszertifikat ist noch vorhanden, sodass das Konto weiterhin für Windows PowerShell verfügbar ist.

In diesem Thema wird das Cmdlet in der Version 0.8.10 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls abzurufen, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Beispiele

Beispiel 1: Entfernen eines Kontos

PS C:\> Remove-AzureAccount -Name admin@contoso.com

Mit diesem Befehl wird die admin@contoso.com Abonnementdatendatei entfernt. Nach Abschluss des Befehls ist das Konto nicht mehr für Windows PowerShell verfügbar.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Unterdrückt die Bestätigungsaufforderung. Standardmäßig werden Sie von Remove-AzureAccount aufgefordert, bevor Sie das Konto aus Windows PowerShell entfernen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des zu entfernenden Kontos an. Bei dem Parameterwert wird die Groß-/Kleinschreibung beachtet. Platzhalterzeichen werden nicht unterstützt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt $True zurück, wenn der Befehl erfolgreich ist, und $False, wenn er fehlschlägt. Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.

Ausgaben

None or System.Boolean

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet einen booleschen Wert zurück. Andernfalls wird keine Ausgabe zurückgegeben.