Set-AzEnvironment
Establece las propiedades de un entorno de Azure.
Sintaxis
Name (valor predeterminado)
Set-AzEnvironment
[-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>]
[[-AdTenant] <String>]
[[-GraphAudience] <String>]
[[-DataLakeAudience] <String>]
[[-BatchEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpoint] <String>]
[-EnableAdfsAuthentication]
[-AzureAnalysisServicesEndpointSuffix <String>]
[-AzureAnalysisServicesEndpointResourceId <String>]
[-AzureAttestationServiceEndpointSuffix <String>]
[-AzureAttestationServiceEndpointResourceId <String>]
[-AzureSynapseAnalyticsEndpointSuffix <String>]
[-ContainerRegistryEndpointSuffix <String>]
[-AzureSynapseAnalyticsEndpointResourceId <String>]
[-MicrosoftGraphEndpointResourceId <String>]
[-MicrosoftGraphUrl <String>]
[-SshAuthScope <String>]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ARMEndpoint
Set-AzEnvironment
[-Name] <String>
[[-StorageEndpoint] <String>]
[-ARMEndpoint] <String>
[[-AzureKeyVaultDnsSuffix] <String>]
[[-AzureKeyVaultServiceEndpointResourceId] <String>]
[[-DataLakeAudience] <String>]
[[-BatchEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpointResourceId] <String>]
[[-AzureOperationalInsightsEndpoint] <String>]
[-AzureAnalysisServicesEndpointSuffix <String>]
[-AzureAnalysisServicesEndpointResourceId <String>]
[-AzureAttestationServiceEndpointSuffix <String>]
[-AzureAttestationServiceEndpointResourceId <String>]
[-AzureSynapseAnalyticsEndpointSuffix <String>]
[-ContainerRegistryEndpointSuffix <String>]
[-AzureSynapseAnalyticsEndpointResourceId <String>]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Set-AzEnvironment 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
Add-AzEnvironment -Name TestEnvironment `
-ActiveDirectoryEndpoint TestADEndpoint `
-ActiveDirectoryServiceEndpointResourceId TestADApplicationId `
-ResourceManagerEndpoint TestRMEndpoint `
-GalleryEndpoint TestGalleryEndpoint `
-GraphEndpoint TestGraphEndpoint
Name Resource Manager Url ActiveDirectory Authority
---- -------------------- -------------------------
TestEnvironment TestRMEndpoint TestADEndpoint/
Set-AzEnvironment -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 :
AzureAttestationServiceEndpointSuffix :
AzureAttestationServiceEndpointResourceId :
AzureSynapseAnalyticsEndpointSuffix :
AzureSynapseAnalyticsEndpointResourceId :
En este ejemplo, vamos a crear un nuevo entorno de Azure con puntos de conexión de ejemplo mediante Add-AzEnvironment y, a continuación, vamos a cambiar el valor de los atributos ActiveDirectoryEndpoint y GraphEndpoint del entorno creado mediante el cmdlet Set-AzEnvironment.
Parámetros
-ActiveDirectoryEndpoint
Especifica la entidad base para la autenticación de Azure Active Directory.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: AdEndpointUrl, Directorio Activo, ActiveDirectoryAuthority
Conjuntos de parámetros
Name
Posición: 5
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: 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).
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: 8
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AdTenant
Especifica el inquilino predeterminado de Active Directory.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: 17
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-ARMEndpoint
Punto de conexión de Azure Resource Manager.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: ArmUrl
Conjuntos de parámetros
ARMEndpoint
Posición: 1
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureAnalysisServicesEndpointResourceId
Identificador de recursos del recurso de Azure Analysis Services.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-AzureAnalysisServicesEndpointSuffix
Punto de conexión que se va a usar al comunicarse con la API de Azure Log Analytics.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-AzureAttestationServiceEndpointResourceId
Identificador de recurso del servicio Azure Attestation que es el destinatario del token solicitado.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureAttestationServiceEndpointSuffix
Sufijo DNS del servicio Azure Attestation.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix
Sufijo DNS de los servicios de catálogo y trabajos de Azure Data Lake Analytics
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: 15
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureDataLakeStoreFileSystemEndpointSuffix
Sufijo DNS de FileSystem de Azure Data Lake Store. Ejemplo: azuredatalake.net
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: 14
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureKeyVaultDnsSuffix
Sufijo DNS del servicio Azure Key Vault. El ejemplo es vault-int.azure-int.net
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: 10
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureKeyVaultServiceEndpointResourceId
Identificador de recurso del servicio de datos de Azure Key Vault que es el destinatario del token solicitado.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: 11
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureOperationalInsightsEndpoint
Punto de conexión que se va a usar al comunicarse con la API de Azure Log Analytics.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: 22
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureOperationalInsightsEndpointResourceId
Audiencia para la autenticación de tokens con la API de Azure Log Analytics.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: 21
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureSynapseAnalyticsEndpointResourceId
Identificador de recurso de Azure Synapse Analytics que es el destinatario del token solicitado.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-AzureSynapseAnalyticsEndpointSuffix
Sufijo DNS de Azure Synapse Analytics.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-BatchEndpointResourceId
Identificador de recurso del servicio Azure Batch que es el destinatario del token solicitado.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: BatchResourceId, BatchAudience
Conjuntos de parámetros
(All)
Posición: 20
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: False
Admite caracteres comodín: False
DontShow: False
Alias: cf
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-ContainerRegistryEndpointSuffix
Sufijo de Azure Container Registry.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-DataLakeAudience
Audiencia para la autenticación de tokens con el punto de conexión de servicios de AD Data Lake.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: DataLakeEndpointResourceId, DataLakeResourceId
Conjuntos de parámetros
(All)
Posición: 19
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Propiedades de parámetro
Tipo: IAzureContextContainer
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: AzContext, AzureRmContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-EnableAdfsAuthentication
Indica que se permite la autenticación local de Servicios de federación de Active Directory (ADFS).
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: OnPremise
Conjuntos de parámetros
Name
Posición: 16
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-GalleryEndpoint
Especifica el punto de conexión de la galería de Azure Resource Manager de plantillas de implementación.
El parámetro es establecer el valor GalleryUrl en de PSAzureEnvironment. Como GalleryUrl se quita de ArmMetadata, Azure PowerShell ya no proporcionará el valor y, por tanto, ya no se recomienda establecer GalleryEndpoint .
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: Gallery, GalleryUrl
Conjuntos de parámetros
Name
Posición: 7
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-GraphAudience
Audiencia para la autenticación de tokens con el punto de conexión de Graph de AD.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: GraphEndpointResourceId, GraphResourceId
Conjuntos de parámetros
Name
Posición: 18
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-GraphEndpoint
Especifica la dirección URL de las solicitudes de Graph (metadatos de Active Directory).
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: Graph, GraphUrl
Conjuntos de parámetros
Name
Posición: 9
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-ManagementPortalUrl
Especifica la dirección URL del Portal de administración.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: 3
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-MicrosoftGraphEndpointResourceId
Identificador de recursos de Microsoft Graph
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-MicrosoftGraphUrl
Microsoft Graph Url
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-Name
Especifica el nombre del entorno que se va a modificar.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: 0
Obligatorio: True
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-PublishSettingsFileUrl
Especifica la dirección URL desde la que se pueden descargar los archivos .publishsettings.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: 1
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-ResourceManagerEndpoint
Especifica la dirección URL de las solicitudes de Azure Resource Manager.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: ResourceManager, ResourceManagerUrl
Conjuntos de parámetros
Name
Posición: 6
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: ContextModificationScope
Valor predeterminado: None
Valores aceptados: Process, CurrentUser
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-ServiceEndpoint
Especifica el punto de conexión para las solicitudes de Administración de servicios (RDFE).
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: ServiceManagement, ServiceManagementUrl
Conjuntos de parámetros
Name
Posición: 2
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-SqlDatabaseDnsSuffix
Especifica el sufijo de nombre de dominio para los servidores de Azure SQL Database.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: 13
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-SshAuthScope
Ámbito de autenticación cuando SSH en una máquina virtual de Azure.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-StorageEndpoint
Especifica el punto de conexión para el acceso al almacenamiento (blob, tabla, cola y archivo).
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Alias: StorageEndpointSuffix
Conjuntos de parámetros
(All)
Posición: 4
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
-TrafficManagerDnsSuffix
Especifica el sufijo de nombre de dominio para los servicios de Azure Traffic Manager.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None
Admite caracteres comodín: False
DontShow: False
Conjuntos de parámetros
Name
Posición: 12
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: True
Valor de los argumentos restantes: False
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: False
Admite caracteres comodín: False
DontShow: False
Alias: Wi
Conjuntos de parámetros
(All)
Posición: Named
Obligatorio: False
Valor de la canalización: False
Valor de la canalización por nombre de propiedad: False
Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas