Set-AzureEnvironment
Cambia las propiedades de un entorno de Azure.
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
Set-AzureEnvironment
-Name <String>
[-PublishSettingsFileUrl <String>]
[-ServiceEndpoint <String>]
[-ManagementPortalUrl <String>]
[-StorageEndpoint <String>]
[-ActiveDirectoryEndpoint <String>]
[-ResourceManagerEndpoint <String>]
[-GalleryEndpoint <String>]
[-ActiveDirectoryServiceEndpointResourceId <String>]
[-GraphEndpoint <String>]
[-AzureKeyVaultDnsSuffix <String>]
[-AzureKeyVaultServiceEndpointResourceId <String>]
[-TrafficManagerDnsSuffix <String>]
[-SqlDatabaseDnsSuffix <String>]
[-EnableAdfsAuthentication]
[-AdTenant <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
El cmdlet Set-AzureEnvironment cambia las propiedades de un entorno de Azure. Devuelve un objeto que representa el entorno con sus nuevos valores de propiedad. Use el parámetro Name para identificar el entorno y los demás parámetros para cambiar los valores de propiedad. No puede usar Set-AzureEnvironment para cambiar el nombre de un entorno de Azure.
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.
NOTA: No cambie las propiedades de los entornos de AzureCloud o AzureChinaCloud. Use este cmdlet para cambiar los valores de los entornos privados que cree.
Ejemplos
Ejemplo 1: Cambiar las propiedades del entorno
PS C:\> Set-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl "https://contoso.com" -StorageEndpoint "contoso.com"Este comando cambia los valores de las propiedades PublishSettingsFileUrl y StorageEndpoint del entorno ContosoEnv.
Parámetros
-ActiveDirectoryEndpoint
Cambia el punto de conexión de la autenticación de Microsoft Entra al valor especificado.
| Tipo: | String |
| Alias: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ActiveDirectoryServiceEndpointResourceId
Especifica el identificador de recurso de una API de administración cuyo acceso se administra mediante el identificador de Entra de Microsoft.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-AdTenant
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-AzureKeyVaultDnsSuffix
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-AzureKeyVaultServiceEndpointResourceId
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-EnableAdfsAuthentication
| Tipo: | SwitchParameter |
| Alias: | OnPremise |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-GalleryEndpoint
Cambia el punto de conexión de la galería de Azure Resource Manager al valor especificado. El punto de conexión de la galería es la ubicación de las plantillas de la galería de grupos de recursos. Para más información sobre los grupos de recursos de Azure y las plantillas de galería, consulte el tema de ayuda de Get-AzureResourceGroupGalleryTemplate.
| Tipo: | String |
| Alias: | Gallery, GalleryUrl |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-GraphEndpoint
| Tipo: | String |
| Alias: | Graph, GraphUrl |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ManagementPortalUrl
Cambia la dirección URL del Portal de administración de Azure al valor especificado.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Name
Identifica el entorno que se va a cambiar. Este parámetro es obligatorio. El valor del 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 |
-PublishSettingsFileUrl
Cambia la dirección URL de los archivos de configuración de publicación en el entorno especificado. Un archivo de configuración de publicación de Azure es un archivo XML que contiene información sobre su cuenta y un certificado de administración que permite a Windows PowerShell iniciar sesión en su cuenta de Azure en su nombre.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ResourceManagerEndpoint
Cambia el punto de conexión de los datos de Azure Resource Manager, incluidos los datos sobre los grupos de recursos asociados a la cuenta. Para más información sobre Azure Resource Manager, consulte Cmdlets de Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) y Uso de Windows PowerShell con Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).
| Tipo: | String |
| Alias: | ResourceManager, ResourceManagerUrl |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ServiceEndpoint
Cambia la dirección URL del punto de conexión de servicio de Azure en el entorno especificado. El punto de conexión de servicio de Azure determina si la aplicación está administrada por la plataforma global de Azure, Azure operado por 21Vianet en China o una instalación privada de Azure.
| Tipo: | String |
| Alias: | ServiceManagement, ServiceManagementUrl |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-SqlDatabaseDnsSuffix
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-StorageEndpoint
Cambia el punto de conexión predeterminado de los servicios de almacenamiento en el entorno especificado.
| Tipo: | String |
| Alias: | StorageEndpointSuffix |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-TrafficManagerDnsSuffix
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
Entradas
None
Puede canalizar la entrada a este cmdlet por nombre de propiedad, pero no por valor.
Salidas
Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment