Set-AzureRmEnvironment

Módulo:

AzureRM.Profile

Establece las propiedades de un entorno de Azure.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Set-AzureRmEnvironment
   [-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>]
   [[-AzureDataLakeStoreFileSystemEndpointSuffix] <String>]
   [[-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix] <String>]
   [-EnableAdfsAuthentication]
   [[-AdTenant] <String>]
   [[-GraphAudience] <String>]
   [[-DataLakeAudience] <String>]
   [[-BatchEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpoint] <String>]
   [[-AzureAnalysisServicesEndpointSuffix] <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmEnvironment
   [-Name] <String>
   [[-StorageEndpoint] <String>]
   [-ARMEndpoint] <String>
   [[-AzureKeyVaultDnsSuffix] <String>]
   [[-AzureKeyVaultServiceEndpointResourceId] <String>]
   [[-DataLakeAudience] <String>]
   [[-BatchEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpoint] <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzureRMEnvironment establece puntos de conexión y metadatos para conectarse a una instancia de Azure.

Ejemplos

Ejemplo 1: Creación y modificación de un nuevo entorno

PS C:\> Add-AzureRmEnvironment -Name TestEnvironment `
        -ActiveDirectoryEndpoint TestADEndpoint `
        -ActiveDirectoryServiceEndpointResourceId TestADApplicationId `
        -ResourceManagerEndpoint TestRMEndpoint `
        -GalleryEndpoint TestGalleryEndpoint `
        -GraphEndpoint TestGraphEndpoint

Name            Resource Manager Url ActiveDirectory Authority
----            -------------------- -------------------------
TestEnvironment TestRMEndpoint       TestADEndpoint/

PS C:\> Set-AzureRmEnvironment -Name TestEnvironment
        -ActiveDirectoryEndpoint NewTestADEndpoint
        -GraphEndpoint NewTestGraphEndpoint | Format-List

Name                                              : TestEnvironment
EnableAdfsAuthentication                          : False
ActiveDirectoryServiceEndpointResourceId          : TestADApplicationId
AdTenant                                          :
GalleryUrl                                        : TestGalleryEndpoint
ManagementPortalUrl                               :
ServiceManagementUrl                              : 
PublishSettingsFileUrl                            :
ResourceManagerUrl                                : TestRMEndpoint
SqlDatabaseDnsSuffix                              :
StorageEndpointSuffix                             :
ActiveDirectoryAuthority                          : NewTestADEndpoint
GraphUrl                                          : NewTestGraphEndpoint
GraphEndpointResourceId                           :
TrafficManagerDnsSuffix                           :
AzureKeyVaultDnsSuffix                            :
AzureDataLakeStoreFileSystemEndpointSuffix        :
AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix :
AzureKeyVaultServiceEndpointResourceId            :
BatchEndpointResourceId                           :
AzureOperationalInsightsEndpoint                  :
AzureOperationalInsightsEndpointResourceId        :

En este ejemplo se crea un nuevo entorno de Azure con puntos de conexión de ejemplo mediante Add-AzureRmEnvironment y, a continuación, se cambia el valor de los atributos ActiveDirectoryEndpoint y GraphEndpoint del entorno creado mediante el cmdlet Set-AzureRmEnvironment.

Parámetros

-ActiveDirectoryEndpoint

Especifica la entidad base para la autenticación de Microsoft Entra.

Tipo:	String
Alias:	AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Posición:	5
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ActiveDirectoryServiceEndpointResourceId

Especifica la audiencia de los tokens que autentican las solicitudes a los puntos de conexión de Azure Resource Manager o Service Management (RDFE).

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

-AdTenant

Especifica el inquilino predeterminado de Active Directory.

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

-ARMEndpoint

Punto de conexión de Azure Resource Manager.

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

-AzureAnalysisServicesEndpointSuffix

Sufijo DNS de puntos de conexión de servicio de Azure Analysis Services

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

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

Sufijo DNS de los servicios de catálogo y trabajos de Azure Data Lake Analytics

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

-AzureDataLakeStoreFileSystemEndpointSuffix

Sufijo DNS de FileSystem de Azure Data Lake Store. Ejemplo: azuredatalake.net

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

-AzureKeyVaultDnsSuffix

Especifica el sufijo de nombre de dominio para los servicios de Key Vault.

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

-AzureKeyVaultServiceEndpointResourceId

Especifica la audiencia de los tokens de acceso que autorizan solicitudes para servicios de Key Vault.

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

-AzureOperationalInsightsEndpoint

Especifica el punto de conexión para el acceso de consulta de Operational Insights.

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

-AzureOperationalInsightsEndpointResourceId

Especifica la audiencia para los tokens de acceso que autorizan las solicitudes de servicios de Operational Insights.

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

-BatchEndpointResourceId

Identificador de recurso del servicio Azure Batch que es el destinatario del token solicitado.

Tipo:	String
Alias:	BatchResourceId, BatchAudience
Posición:	20
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-DataLakeAudience

Audiencia para la autenticación de tokens con el punto de conexión de servicios de AD Data Lake.

Tipo:	String
Alias:	DataLakeEndpointResourceId, DataLakeResourceId
Posición:	19
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EnableAdfsAuthentication

Indica que se permite la autenticación local Servicios de federación de Active Directory (AD FS) (ADFS).

Tipo:	SwitchParameter
Alias:	OnPremise
Posición:	16
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 de plantillas de implementación.

Tipo:	String
Alias:	Gallery, GalleryUrl
Posición:	7
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-GraphAudience

Audiencia para la autenticación de tokens con el punto de conexión de Graph de AD.

Tipo:	String
Alias:	GraphEndpointResourceId, GraphResourceId
Posición:	18
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-GraphEndpoint

Especifica la dirección URL de las solicitudes de Graph (metadatos de Active Directory).

Tipo:	String
Alias:	Graph, GraphUrl
Posición:	9
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.

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

-Name

Especifica el nombre del entorno que se va a modificar.

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

-PublishSettingsFileUrl

Especifica la dirección URL desde la que se pueden descargar los archivos .publishsettings.

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

-ResourceManagerEndpoint

Especifica la dirección URL de las solicitudes de Azure Resource Manager.

Tipo:	String
Alias:	ResourceManager, ResourceManagerUrl
Posición:	6
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Scope

Determina el ámbito de los cambios de contexto, por ejemplo, si los cambios solo se aplican al proceso actual o a todas las sesiones iniciadas por este usuario.

Tipo:	ContextModificationScope
Valores aceptados:	Process, CurrentUser
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ServiceEndpoint

Especifica el punto de conexión para las solicitudes de Administración de servicios (RDFE).

Tipo:	String
Alias:	ServiceManagement, ServiceManagementUrl
Posición:	2
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-SqlDatabaseDnsSuffix

Especifica el sufijo de nombre de dominio para los servidores de Azure SQL Database.

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

-StorageEndpoint

Especifica el punto de conexión para el acceso al almacenamiento (blob, tabla, cola y archivo).

Tipo:	String
Alias:	StorageEndpointSuffix
Posición:	4
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TrafficManagerDnsSuffix

Especifica el sufijo de nombre de dominio para los servicios de Azure Traffic Manager.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

String

SwitchParameter

Salidas

PSAzureEnvironment

Vínculos relacionados

• Add-AzureRMEnvironment
• Get-AzureRMEnvironment
• Remove-AzureRMEnvironment