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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Profile

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

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.