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.