Remove-AzureEnvironment

  • Referência
Módulo:
Azure

Exclui um ambiente do Azure do Windows PowerShell.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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

Description

O cmdlet Remove-AzureEnvironment exclui um ambiente do Azure do seu perfil móvel para que o Windows PowerShell não possa encontrá-lo. Esse cmdlet não exclui o ambiente do Microsoft Azure nem altera o ambiente real de forma alguma.

Um ambiente do Azure uma implantação independente do Microsoft Azure, como o AzureCloud para Azure global e o AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Pacote do Azure e os cmdlets WAPack. Para obter mais informações, consulte Pacote do Azure.

Exemplos

Exemplo 1: Excluir um ambiente

PS C:\> Remove-AzureEnvironment -Name ContosoEnv

Esse comando exclui o ambiente ContosoEnv do Windows PowerShell.

Exemplo 2: Excluir vários ambientes

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

Esse comando exclui ambientes cujos nomes começam com "Contoso" do Windows PowerShell.

Parâmetros

-Force

Suprime o prompt de confirmação.

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

-Name

Especifica o nome do ambiente a ser removido. Este parâmetro é necessário. Esse valor de parâmetro diferencia maiúsculas de minúsculas. Caracteres curinga não são permitidos.

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

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

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

Entradas

None

Você pode canalizar a entrada para esse cmdlet pelo nome da propriedade, mas não pelo valor.

Saídas

None or System.Boolean

Se você usar o parâmetro PassThru , esse cmdlet retornará um valor booleano. Caso contrário, ele não retorna nenhuma saída.