Delen via

Remove-AzureEnvironment

  • Referentie
Module:
Azure

Hiermee verwijdert u een Azure-omgeving uit Windows PowerShell.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

Description

Met de cmdlet Remove-AzureEnvironment wordt een Azure-omgeving verwijderd uit uw zwervende profiel, zodat Windows PowerShell deze niet kan vinden. Met deze cmdlet wordt de omgeving niet uit Microsoft Azure verwijderd of wordt de werkelijke omgeving op geen enkele manier gewijzigd.

Een Azure-omgeving een onafhankelijke implementatie van Microsoft Azure, zoals AzureCloud voor wereldwijde Azure en AzureChinaCloud voor Azure beheerd door 21Vianet in China. U kunt ook on-premises Azure-omgevingen maken met behulp van Azure Pack en de WAPack-cmdlets. Zie Azure Pack voor meer informatie.

Voorbeelden

Voorbeeld 1: Een omgeving verwijderen

PS C:\> Remove-AzureEnvironment -Name ContosoEnv

Met deze opdracht wordt de ContosoEnv-omgeving uit Windows PowerShell verwijderd.

Voorbeeld 2: Meerdere omgevingen verwijderen

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

Met deze opdracht worden omgevingen verwijderd waarvan de namen beginnen met Contoso uit Windows PowerShell.

Parameters

-Force

Onderdrukt de bevestigingsprompt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de omgeving die moet worden verwijderd. Deze parameter is vereist. Deze parameterwaarde is hoofdlettergevoelig. Jokertekens zijn niet toegestaan.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt invoer naar deze cmdlet doorsluisen op eigenschapsnaam, maar niet op waarde.

Uitvoerwaarden

None or System.Boolean

Als u de parameter PassThru gebruikt, retourneert deze cmdlet een Booleaanse waarde. Anders retourneert deze geen uitvoer.