Condividi tramite


Remove-AzureAccount

Elimina un account Azure da Windows PowerShell.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet Remove-AzureAccount elimina un account Azure e le relative sottoscrizioni dal file di dati della sottoscrizione nel profilo utente mobile. Non elimina l'account da Microsoft Azure o modifica l'account effettivo in alcun modo.

L'uso di questo cmdlet è molto simile alla disconnessione dall'account Azure. Se si vuole accedere di nuovo all'account, usare di nuovo Add-AzureAccount o Import-AzurePublishSettingsFile per aggiungere di nuovo l'account a Windows PowerShell.

È anche possibile usare il cmdlet Remove-AzureAccount per modificare il modo in cui i cmdlet di Azure PowerShell accedono all'account Azure. Se l'account ha sia un certificato di gestione di Import-AzurePublishSettingsFile che un token di accesso da Add-AzureAccount, i cmdlet di Azure PowerShell usano solo il token di accesso e ignorano il certificato di gestione. Per usare il certificato di gestione, eseguire Remove-AzureAccount. Quando Remove-AzureAccount trova sia un certificato di gestione che un token di accesso, elimina solo il token di accesso, invece di eliminare l'account. Il certificato di gestione è ancora presente, quindi l'account è ancora disponibile per Windows PowerShell.

Questo argomento descrive il cmdlet nella versione 0.8.10 del modulo Microsoft Azure PowerShell. Per ottenere la versione del modulo in uso, nella console di Azure PowerShell digitare (Get-Module -Name Azure).Version.

Esempio

Esempio 1: Rimuovere un account

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

Questo comando rimuove l'oggetto admin@contoso.com dal file di dati della sottoscrizione. Al termine del comando, l'account non è più disponibile per Windows PowerShell.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Elimina la richiesta di conferma. Per impostazione predefinita, Remove-AzureAccount richiede di rimuovere l'account da Windows PowerShell.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome dell'account da rimuovere. Il valore del parametro fa distinzione tra maiuscole e minuscole. I caratteri jolly non sono supportati.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Restituisce $True se il comando ha esito positivo e $False in caso di errore. Per impostazione predefinita, questo cmdlet non restituisce alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

È possibile inviare tramite pipe l'input a questo cmdlet in base al nome della proprietà, ma non in base al valore.

Output

None or System.Boolean

Se si usa il parametro PassThru , questo cmdlet restituisce un valore booleano. In caso contrario, non restituisce alcun output.