Freigeben über

Remove-AzureEnvironment

  • Referenz
Modul:
Azure

Löscht eine Azure-Umgebung aus Windows PowerShell.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

Remove-AzureEnvironment
      -Name <String>
      [-Force]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-AzureEnvironment löscht eine Azure-Umgebung aus Ihrem Roamingprofil, sodass Windows PowerShell sie nicht finden kann. Dieses Cmdlet löscht die Umgebung nicht aus Microsoft Azure, oder ändert die tatsächliche Umgebung in keiner Weise.

Eine Azure-Umgebung eine unabhängige Bereitstellung von Microsoft Azure, z. B. AzureCloud für globale Azure und AzureChinaCloud für Azure, betrieben von 21Vianet in China. Sie können auch lokale Azure-Umgebungen mithilfe von Azure Pack und den WAPack-Cmdlets erstellen. Weitere Informationen finden Sie unter Azure Pack.

Beispiele

Beispiel 1: Löschen einer Umgebung

PS C:\> Remove-AzureEnvironment -Name ContosoEnv

Mit diesem Befehl wird die ContosoEnv-Umgebung aus Windows PowerShell gelöscht.

Beispiel 2: Löschen mehrerer Umgebungen

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

Mit diesem Befehl werden Umgebungen gelöscht, deren Namen mit "Contoso" aus Windows PowerShell beginnen.

Parameter

-Force

Unterdrückt die Bestätigungsaufforderung.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der zu entfernenden Umgebung an. Dieser Parameter ist erforderlich. Bei diesem Parameterwert wird die Groß-/Kleinschreibung beachtet. Platzhalterzeichen sind nicht zulässig.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können Eingaben nach Eigenschaftsname an dieses Cmdlet weiterleiten, aber nicht nach Wert.

Ausgaben

None or System.Boolean

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet einen booleschen Wert zurück. Andernfalls wird keine Ausgabe zurückgegeben.