Compartir a través de


Add-AzEnvironment

Agrega puntos de conexión y metadatos para una instancia de Azure Resource Manager.

Sintaxis

Add-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>]
   [-EnableAdfsAuthentication]
   [[-AdTenant] <String>]
   [[-GraphAudience] <String>]
   [[-DataLakeAudience] <String>]
   [[-BatchEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpointResourceId] <String>]
   [[-AzureOperationalInsightsEndpoint] <String>]
   [-AzureAnalysisServicesEndpointSuffix <String>]
   [-AzureAnalysisServicesEndpointResourceId <String>]
   [-AzureAttestationServiceEndpointSuffix <String>]
   [-AzureAttestationServiceEndpointResourceId <String>]
   [-AzureSynapseAnalyticsEndpointSuffix <String>]
   [-ContainerRegistryEndpointSuffix <String>]
   [-AzureSynapseAnalyticsEndpointResourceId <String>]
   [-MicrosoftGraphEndpointResourceId <String>]
   [-MicrosoftGraphUrl <String>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-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>]
Add-AzEnvironment
   [-AutoDiscover]
   [-Uri <Uri>]
   [-Scope <ContextModificationScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Add-AzEnvironment agrega puntos de conexión y metadatos para permitir que los cmdlets de Azure Resource Manager se conecten con una nueva instancia de Azure Resource Manager. Los entornos integrados AzureCloud y AzureChinaCloud tienen como destino instancias públicas existentes de Azure Resource Manager.

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
OnPremise                                         : False
ActiveDirectoryServiceEndpointResourceId          : TestADApplicationId
AdTenant                                          :
GalleryUrl                                        : TestGalleryEndpoint
ManagementPortalUrl                               :
ServiceManagementUrl                              :
PublishSettingsFileUrl                            :
ResourceManagerUrl                                : TestRMEndpoint
SqlDatabaseDnsSuffix                              :
StorageEndpointSuffix                             :
ActiveDirectoryAuthority                          : NewTestADEndpoint
GraphUrl                                          : NewTestGraphEndpoint
GraphEndpointResourceId                           :
TrafficManagerDnsSuffix                           :
AzureKeyVaultDnsSuffix                            :
DataLakeEndpointResourceId                        :
AzureDataLakeStoreFileSystemEndpointSuffix        :
AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix :
AzureKeyVaultServiceEndpointResourceId            :
AzureOperationalInsightsEndpointResourceId        :
AzureOperationalInsightsEndpoint                  :
AzureAnalysisServicesEndpointSuffix               :
AzureAttestationServiceEndpointSuffix             :
AzureAttestationServiceEndpointResourceId         :
AzureSynapseAnalyticsEndpointSuffix               :
AzureSynapseAnalyticsEndpointResourceId           :
VersionProfiles                                   : {}
ExtendedProperties                                : {}
BatchEndpointResourceId                           :

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.

Ejemplo 2: Detección de un nuevo entorno mediante URI

<#
Uri https://configuredmetadata.net returns an array of environment metadata. The following example contains a payload for the AzureCloud default environment.

[
  {
    "portal": "https://portal.azure.com",
    "authentication": {
      "loginEndpoint": "https://login.microsoftonline.com/",
      "audiences": [
        "https://management.core.windows.net/"
      ],
      "tenant": "common",
      "identityProvider": "AAD"
    },
    "media": "https://rest.media.azure.net",
    "graphAudience": "https://graph.windows.net/",
    "graph": "https://graph.windows.net/",
    "name": "AzureCloud",
    "suffixes": {
      "azureDataLakeStoreFileSystem": "azuredatalakestore.net",
      "acrLoginServer": "azurecr.io",
      "sqlServerHostname": ".database.windows.net",
      "azureDataLakeAnalyticsCatalogAndJob": "azuredatalakeanalytics.net",
      "keyVaultDns": "vault.azure.net",
      "storage": "core.windows.net",
      "azureFrontDoorEndpointSuffix": "azurefd.net"
    },
    "batch": "https://batch.core.windows.net/",
    "resourceManager": "https://management.azure.com/",
    "vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json",
    "activeDirectoryDataLake": "https://datalake.azure.net/",
    "sqlManagement": "https://management.core.windows.net:8443/",
    "gallery": "https://gallery.azure.com/"
  },
……
]
#>

Add-AzEnvironment -AutoDiscover -Uri https://configuredmetadata.net

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

En este ejemplo, estamos detectando un nuevo entorno de Azure desde el https://configuredmetadata.net URI.

Parámetros

-ActiveDirectoryEndpoint

Especifica la entidad base para la autenticación de Azure Active Directory.

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

-AutoDiscover

Detecta entornos a través del punto de conexión predeterminado o configurado.

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

-AzureAnalysisServicesEndpointResourceId

Identificador de recursos del recurso de Azure Analysis Services.

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

-AzureAnalysisServicesEndpointSuffix

Punto de conexión que se va a usar al comunicarse con la API de Azure Log Analytics.

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

-AzureAttestationServiceEndpointResourceId

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

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

-AzureAttestationServiceEndpointSuffix

Sufijo DNS del servicio Azure Attestation.

Tipo:String
Posición:Named
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

Sufijo DNS del servicio Azure Key Vault. El ejemplo es vault-int.azure-int.net

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

-AzureKeyVaultServiceEndpointResourceId

Identificador de recurso del servicio de datos de Azure Key Vault que es el destinatario del token solicitado.

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

-AzureOperationalInsightsEndpoint

Punto de conexión que se va a usar al comunicarse con la API de Azure Log Analytics.

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

-AzureOperationalInsightsEndpointResourceId

Audiencia para la autenticación de tokens con la API de Azure Log Analytics.

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

-AzureSynapseAnalyticsEndpointResourceId

Identificador de recurso de Azure Synapse Analytics que es el destinatario del token solicitado.

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

-AzureSynapseAnalyticsEndpointSuffix

Sufijo DNS de Azure Synapse Analytics.

Tipo:String
Posición:Named
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

-ContainerRegistryEndpointSuffix

Sufijo de Azure Container Registry.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
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, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzContext, 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. 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 .

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

-MicrosoftGraphEndpointResourceId

Identificador de recursos de Microsoft Graph

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

-MicrosoftGraphUrl

Microsoft Graph Url

Tipo:String
Posición:Named
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 agregar.

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

-Uri

Especifica el URI del recurso de Internet para capturar entornos.

Tipo:Uri
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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