Add-AzureEnvironment
Crea un entorno de Azure.
Nota:
Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos heredados de Azure que usan las API de Azure Service Manager (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 powerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.
Sintaxis
Add-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 Add-AzureEnvironment crea un nuevo entorno de cuenta de Azure personalizado y lo guarda en el perfil de usuario móvil. El cmdlet devuelve un objeto que representa el nuevo entorno. Cuando se complete el comando, puede usar el entorno en Windows PowerShell.
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.
Solo el parámetro Name de este cmdlet es obligatorio. Si omite un parámetro, su valor es NULL ($Null) y el servicio que usa ese punto de conexión podría no funcionar correctamente. Para agregar o cambiar el valor de una propiedad de entorno, use el cmdlet Set-AzureEnvironment .
NOTA: Cambiar el entorno puede provocar un error en la cuenta. Normalmente, los entornos solo se agregan para pruebas o solución de problemas.
En este tema se describe el cmdlet en la versión 0.8.10 del módulo de Microsoft Azure PowerShell.
Para obtener la versión del módulo que usa, en la consola de Azure PowerShell, escriba (Get-Module -Name Azure).Version
.
Ejemplos
Ejemplo 1: Adición de un entorno de Azure
PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102
Name : ContosoEnv
PublishSettingsFileUrl : https://contoso.com/fwlink/?LinkID=101
ServiceEndpoint : https://contoso.com/fwlink/?LinkID=102
ResourceManagerEndpoint :
ManagementPortalUrl :
ActiveDirectoryEndpoint :
ActiveDirectoryCommonTenantId :
StorageEndpointSuffix :
StorageBlobEndpointFormat :
StorageQueueEndpointFormat :
StorageTableEndpointFormat :
GalleryEndpoint :
Este comando crea el entorno de Azure ContosoEnv.
Parámetros
-ActiveDirectoryEndpoint
Especifica el punto de conexión para la autenticación de Microsoft Entra en el nuevo entorno.
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
Especifica el punto de conexión de la galería de Azure Resource Manager, que almacena 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.https://go.microsoft.com/fwlink/?LinkID=393052.
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
Especifica la dirección URL del Portal de administración de Azure en el nuevo entorno.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Name
Especifica un nombre para el entorno. Este parámetro es obligatorio. No use los nombres de los entornos predeterminados, AzureCloud y AzureChinaCloud.
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
Especifica la dirección URL de los archivos de configuración de publicación de la cuenta. 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
Especifica el punto de conexión para 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
Especifica la dirección URL del punto de conexión de servicio de Azure. 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
Especifica el punto de conexión predeterminado de los servicios de almacenamiento en el nuevo entorno.
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