Compartir a través de


Remove-AzureEnvironment

Elimina un entorno de Azure de Windows PowerShell.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

Description

El cmdlet Remove-AzureEnvironment elimina un entorno de Azure del perfil móvil para que Windows PowerShell no lo encuentre. Este cmdlet no elimina el entorno de Microsoft Azure ni cambia el entorno real de ninguna manera.

Un entorno de Azure que es una implementación independiente de Microsoft Azure, como AzureCloud para Azure global y AzureChinaCloud para Azure operado por 21Vianet en China. También puede crear entornos de Azure locales mediante Azure Pack y los cmdlets WAPack. Para más información, consulte Azure Pack.

Ejemplos

Ejemplo 1: Eliminación de un entorno

PS C:\> Remove-AzureEnvironment -Name ContosoEnv

Este comando elimina el entorno ContosoEnv de Windows PowerShell.

Ejemplo 2: Eliminación de varios entornos

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

Este comando elimina entornos cuyos nombres comienzan por "Contoso" de Windows PowerShell.

Parámetros

-Force

Suprime el mensaje de confirmación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre del entorno que se va a quitar. Este parámetro es obligatorio. Este valor de parámetro distingue mayúsculas de minúsculas. No se admite el uso de caracteres comodín.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Puede canalizar la entrada a este cmdlet por nombre de propiedad, pero no por valor.

Salidas

None or System.Boolean

Si usa el parámetro PassThru , este cmdlet devuelve un valor booleano. De lo contrario, no devuelve ningún resultado.