Partilhar via

Remove-AzureEnvironment

  • Referência
Módulo:
Azure

Exclui um ambiente do Azure do Windows PowerShell.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para 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. Este cmdlet não exclui o ambiente do Microsoft Azure nem altera o ambiente real de qualquer forma.

Um ambiente do Azure uma implantação independente do Microsoft Azure, como AzureCloud para Azure global e AzureChinaCloud para Azure operado pela 21Vianet na China. Você também pode criar ambientes locais do Azure usando o Azure Pack 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

Este 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 }

Este 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 é obrigató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 é lido. 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.