Udostępnij za pośrednictwem

Remove-AzureAccount

  • Odwołanie
Moduł:
Azure

Usuwa konto platformy Azure z programu Windows PowerShell.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Remove-AzureAccount usuwa konto platformy Azure i jego subskrypcje z pliku danych subskrypcji w profilu użytkownika mobilnego. Nie usuwa konta z platformy Microsoft Azure ani nie zmienia rzeczywistego konta w żaden sposób.

Użycie tego polecenia cmdlet jest bardzo podobne do wylogowania się z konta platformy Azure. Jeśli chcesz ponownie zalogować się do konta, ponownie użyj polecenia Add-AzureAccount lub Import-AzurePublishSettingsFile , aby ponownie dodać konto do programu Windows PowerShell.

Możesz również użyć polecenia cmdlet Remove-AzureAccount , aby zmienić sposób logowania poleceń cmdlet programu Azure PowerShell do konta platformy Azure. Jeśli twoje konto ma zarówno certyfikat zarządzania z polecenia Import-AzurePublishSettingsFile , jak i token dostępu z polecenia Add-AzureAccount, polecenia cmdlet programu Azure PowerShell używają tylko tokenu dostępu; ignorują certyfikat zarządzania. Aby użyć certyfikatu zarządzania, uruchom polecenie Remove-AzureAccount. Gdy polecenie Remove-AzureAccount znajdzie zarówno certyfikat zarządzania, jak i token dostępu, usuwa tylko token dostępu, zamiast usuwać konto. Certyfikat zarządzania jest nadal dostępny dla programu Windows PowerShell.

W tym temacie opisano polecenie cmdlet w wersji 0.8.10 modułu Microsoft Azure PowerShell. Aby uzyskać wersję używanego modułu, w konsoli programu Azure PowerShell wpisz (Get-Module -Name Azure).Version.

Przykłady

Przykład 1. Usuwanie konta

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

To polecenie usuwa element admin@contoso.com z pliku danych subskrypcji. Po zakończeniu wykonywania polecenia konto nie jest już dostępne dla programu Windows PowerShell.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliases:cf
Position:Named
wartość domyślna:False
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Pomija monit o potwierdzenie. Domyślnie polecenie Remove-AzureAccount wyświetla monit przed usunięciem konta z programu Windows PowerShell.

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę konta do usunięcia. W wartości parametru jest uwzględniana wielkość liter. Symbole wieloznaczne nie są obsługiwane.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Zwraca $True, jeśli polecenie powiedzie się i $False, jeśli zakończy się niepowodzeniem. Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliases:wi
Position:Named
wartość domyślna:False
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

Możesz przekazać dane wejściowe do tego polecenia cmdlet według nazwy właściwości, ale nie według wartości.

Dane wyjściowe

None or System.Boolean

Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca wartość logiczną. W przeciwnym razie nie zwraca żadnych danych wyjściowych.