Condividi tramite

Remove-AzureEnvironment

  • Riferimento
Modulo:
Azure

Elimina un ambiente 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-AzureEnvironment
      -Name <String>
      [-Force]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-AzureEnvironment elimina un ambiente Azure dal profilo mobile in modo che Windows PowerShell non lo trovi. Questo cmdlet non elimina l'ambiente da Microsoft Azure o modifica l'ambiente effettivo in alcun modo.

Un ambiente Azure una distribuzione indipendente di Microsoft Azure, ad esempio AzureCloud per Azure globale e AzureChinaCloud per Azure gestito da 21Vianet in Cina. È anche possibile creare ambienti di Azure locali usando Azure Pack e i cmdlet WAPack. Per altre informazioni, vedere Azure Pack.

Esempio

Esempio 1: Eliminare un ambiente

PS C:\> Remove-AzureEnvironment -Name ContosoEnv

Questo comando elimina l'ambiente ContosoEnv da Windows PowerShell.

Esempio 2: Eliminare più ambienti

PS C:\> Get-AzureEnvironment | Where-Object EnvironmentName -like "Contoso*" | ForEach-Object {Remove-AzureEnvironment -Name $_.EnvironmentName }

Questo comando elimina gli ambienti i cui nomi iniziano con "Contoso" da Windows PowerShell.

Parametri

-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

-Name

Specifica il nome dell'ambiente da rimuovere. Questo parametro è obbligatorio. Questo valore del parametro fa distinzione tra maiuscole e minuscole. I caratteri jolly non sono consentiti.

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

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.