Condividi tramite

Remove-AzureSubscription

  • Riferimento
Modulo:
Azure

Elimina una sottoscrizione di 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-AzureSubscription
      -SubscriptionName <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureSubscription
      -SubscriptionId <String>
      [-Force]
      [-PassThru]
      [-Profile <AzureSMProfile>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-AzureSubscription elimina una sottoscrizione di Azure dal file di dati della sottoscrizione in modo che Windows PowerShell non possa trovarla. Questo cmdlet non elimina la sottoscrizione da Microsoft Azure o modifica la sottoscrizione effettiva in alcun modo.

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: Eliminare una sottoscrizione

C:\PS> Remove-AzureSubscription -SubscriptionName Test

Confirm
Are you sure you want to perform this action?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

Questo comando elimina la sottoscrizione "Test" dal file di dati di sottoscrizione predefinito.

Esempio 2: Eliminare da un file di dati di sottoscrizione alternativo

C:\PS> Remove-AzureSubscription -SubscriptionName Test -SubscriptionDataFile C:\Subs\MySubscriptions.xml -Force

Questo comando elimina la sottoscrizione test dal file di dati della sottoscrizione MySubscriptions.xml. Il comando usa il parametro Force per eliminare il prompt di conferma.

Esempio 3: Eliminare una sottoscrizione in uno script

C:\PS> ...if (Remove-AzureSubscription -SubscriptionName Test -PassThru) {...}

Questo comando usa il comando Remove-AzureSubscription in un'istruzione If . Usa il parametro PassThru , che restituisce un valore booleano, per determinare se viene eseguito il blocco di script nell'istruzione If .

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.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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

-SubscriptionId

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

-SubscriptionName

Tipo:String
Alias:Name
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
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.