Delen via

Remove-AzureAccount

  • Referentie
Module:
Azure

Hiermee verwijdert u een Azure-account uit Windows PowerShell.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Description

De cmdlet Remove-AzureAccount verwijdert een Azure-account en de bijbehorende abonnementen uit het abonnementsgegevensbestand in uw zwervende gebruikersprofiel. Het account wordt niet uit Microsoft Azure verwijderd of het werkelijke account op geen enkele manier gewijzigd.

Het gebruik van deze cmdlet lijkt veel op afmelden bij uw Azure-account. En als u zich opnieuw wilt aanmelden bij het account, gebruikt u het Add-AzureAccount of Import-AzurePublishSettingsFile om het account opnieuw toe te voegen aan Windows PowerShell.

U kunt ook de Cmdlet Remove-AzureAccount gebruiken om de manier te wijzigen waarop de Azure PowerShell-cmdlets zich aanmelden bij uw Azure-account. Als uw account zowel een beheercertificaat uit Import-AzurePublishSettingsFile als een toegangstoken van Add-AzureAccount heeft, gebruiken de Azure PowerShell-cmdlets alleen het toegangstoken; ze negeren het beheercertificaat. Als u het beheercertificaat wilt gebruiken, voert u Remove-AzureAccount uit. Wanneer Remove-AzureAccount zowel een beheercertificaat als een toegangstoken vindt, wordt alleen het toegangstoken verwijderd in plaats van het account te verwijderen. Het beheercertificaat is nog steeds aanwezig, dus het account is nog steeds beschikbaar voor Windows PowerShell.

In dit onderwerp wordt de cmdlet in de versie 0.8.10 van de Microsoft Azure PowerShell-module beschreven. Als u de versie van de module wilt ophalen die u gebruikt, typt (Get-Module -Name Azure).Versionu in de Azure PowerShell-console.

Voorbeelden

Voorbeeld 1: Een account verwijderen

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

Met deze opdracht wordt het admin@contoso.com uit uw abonnementsgegevensbestand verwijderd. Wanneer de opdracht is voltooid, is het account niet meer beschikbaar voor Windows PowerShell.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Onderdrukt de bevestigingsprompt. Met Remove-AzureAccount wordt u standaard gevraagd voordat u het account uit Windows PowerShell verwijdert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van het account te verwijderen. De parameterwaarde is hoofdlettergevoelig. Jokertekens worden niet ondersteund.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Retourneert $True als de opdracht slaagt en $False als deze mislukt. Deze cmdlet retourneert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt invoer naar deze cmdlet doorsluisen op eigenschapsnaam, maar niet op waarde.

Uitvoerwaarden

None or System.Boolean

Als u de parameter PassThru gebruikt, retourneert deze cmdlet een Booleaanse waarde. Anders retourneert deze geen uitvoer.