Set-AzureRmEnvironment
Establece las propiedades de un entorno de Azure.
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente 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 se mantiene ni se admite, colocando cualquier uso continuado 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.
Syntax
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 |
| Aliases: | AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority |
| Position: | 5 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Position: | 8 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AdTenant
Especifica el inquilino predeterminado de Active Directory.
| Tipo: | String |
| Position: | 17 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ARMEndpoint
Punto de conexión de Azure Resource Manager.
| Tipo: | String |
| Aliases: | ArmUrl |
| Position: | 1 |
| valor predeterminado: | None |
| Requerido: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureAnalysisServicesEndpointSuffix
Sufijo DNS de puntos de conexión de servicio de Azure Analysis Services
| Tipo: | String |
| Position: | 15 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix
Sufijo DNS de los servicios de catálogo y trabajos de Azure Data Lake Analytics
| Tipo: | String |
| Position: | 15 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureDataLakeStoreFileSystemEndpointSuffix
Sufijo DNS de FileSystem de Azure Data Lake Store. Ejemplo: azuredatalake.net
| Tipo: | String |
| Position: | 14 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultDnsSuffix
Especifica el sufijo de nombre de dominio para los servicios de Key Vault.
| Tipo: | String |
| Position: | 10 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureKeyVaultServiceEndpointResourceId
Especifica la audiencia de los tokens de acceso que autorizan solicitudes para servicios de Key Vault.
| Tipo: | String |
| Position: | 11 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureOperationalInsightsEndpoint
Especifica el punto de conexión para el acceso de consulta de Ideas operativo.
| Tipo: | String |
| Position: | 22 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-AzureOperationalInsightsEndpointResourceId
Especifica la audiencia para los tokens de acceso que autorizan las solicitudes de servicios de Ideas operativos.
| Tipo: | String |
| Position: | 21 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BatchEndpointResourceId
Identificador de recurso del servicio Azure Batch que es el destinatario del token solicitado.
| Tipo: | String |
| Aliases: | BatchResourceId, BatchAudience |
| Position: | 20 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valor predeterminado: | False |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataLakeAudience
Audiencia para la autenticación de tokens con el punto de conexión de servicios de AD Data Lake.
| Tipo: | String |
| Aliases: | DataLakeEndpointResourceId, DataLakeResourceId |
| Position: | 19 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAdfsAuthentication
Indica que se permite la autenticación local Servicios de federación de Active Directory (AD FS) (ADFS).
| Tipo: | SwitchParameter |
| Aliases: | OnPremise |
| Position: | 16 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GalleryEndpoint
Especifica el punto de conexión de la galería de Azure Resource Manager de plantillas de implementación.
| Tipo: | String |
| Aliases: | Gallery, GalleryUrl |
| Position: | 7 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GraphAudience
Audiencia para la autenticación de tokens con el punto de conexión de Graph de AD.
| Tipo: | String |
| Aliases: | GraphEndpointResourceId, GraphResourceId |
| Position: | 18 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-GraphEndpoint
Especifica la dirección URL de las solicitudes de Graph (metadatos de Active Directory).
| Tipo: | String |
| Aliases: | Graph, GraphUrl |
| Position: | 9 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManagementPortalUrl
Especifica la dirección URL del Portal de administración.
| Tipo: | String |
| Position: | 3 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica el nombre del entorno que se va a modificar.
| Tipo: | String |
| Position: | 0 |
| valor predeterminado: | None |
| Requerido: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublishSettingsFileUrl
Especifica la dirección URL desde la que se pueden descargar los archivos .publishsettings.
| Tipo: | String |
| Position: | 1 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceManagerEndpoint
Especifica la dirección URL de las solicitudes de Azure Resource Manager.
| Tipo: | String |
| Aliases: | ResourceManager, ResourceManagerUrl |
| Position: | 6 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceEndpoint
Especifica el punto de conexión para las solicitudes de Administración de servicios (RDFE).
| Tipo: | String |
| Aliases: | ServiceManagement, ServiceManagementUrl |
| Position: | 2 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SqlDatabaseDnsSuffix
Especifica el sufijo de nombre de dominio para los servidores de Azure SQL Database.
| Tipo: | String |
| Position: | 13 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageEndpoint
Especifica el punto de conexión para el acceso al almacenamiento (blob, tabla, cola y archivo).
| Tipo: | String |
| Aliases: | StorageEndpointSuffix |
| Position: | 4 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TrafficManagerDnsSuffix
Especifica el sufijo de nombre de dominio para los servicios de Azure Traffic Manager.
| Tipo: | String |
| Position: | 12 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valor predeterminado: | False |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |