Поделиться через


Add-AzureRmEnvironment

Добавляет конечные точки и метаданные для экземпляра Azure Resource Manager.

Предупреждение

Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

Add-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>]
Add-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>]

Описание

Командлет Add-AzureRmEnvironment добавляет конечные точки и метаданные, чтобы разрешить командлетам Azure Resource Manager подключаться к новому экземпляру Azure Resource Manager. Встроенные среды AzureCloud и AzureChinaCloud предназначены для существующих общедоступных экземпляров Azure Resource Manager.

Примеры

Пример 1. Создание и изменение новой среды

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
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               :
VersionProfiles                                   : {}
ExtendedProperties                                : {}
BatchEndpointResourceId                           :

In this example we are creating a new Azure environment with sample endpoints using Add-AzureRmEnvironment, and then we are changing the value of the ActiveDirectoryEndpoint and GraphEndpoint attributes of the created environment using the cmdlet Set-AzureRmEnvironment.

Параметры

-ActiveDirectoryEndpoint

Указывает базовый центр проверки подлинности Microsoft Entra.

Тип:String
Aliases:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Position:5
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ActiveDirectoryServiceEndpointResourceId

Указывает аудиторию маркеров, прошедших проверку подлинности запросов к конечным точкам Azure Resource Manager или Service Management (RDFE).

Тип:String
Position:8
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AdTenant

Указывает клиент Active Directory по умолчанию.

Тип:String
Position:17
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ARMEndpoint

Конечная точка Azure Resource Manager

Тип:String
Aliases:ArmUrl
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AzureAnalysisServicesEndpointSuffix

Dns Суффикс конечных точек службы Azure Analysis Services

Тип:String
Position:15
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AzureDataLakeAnalyticsCatalogAndJobEndpointSuffix

Dns-суффикс заданий и служб каталога Azure Data Lake Analytics

Тип:String
Position:15
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AzureDataLakeStoreFileSystemEndpointSuffix

Dns-суффикс файловой системы Azure Data Lake Store. Пример: azuredatalake.net

Тип:String
Position:14
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AzureKeyVaultDnsSuffix

Указывает суффикс доменного имени для служб Key Vault.

Тип:String
Position:10
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AzureKeyVaultServiceEndpointResourceId

Указывает аудиторию для маркеров доступа, которые разрешают запросы к службам Key Vault.

Тип:String
Position:11
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AzureOperationalInsightsEndpoint

Указывает конечную точку для доступа к запросу операционной Аналитика.

Тип:String
Position:22
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-AzureOperationalInsightsEndpointResourceId

Указывает аудиторию для маркеров доступа, авторизации запросов для операционных служб Аналитика.

Тип:String
Position:21
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-BatchEndpointResourceId

Идентификатор ресурса службы пакетная служба Azure, которая является получателем запрошенного маркера.

Тип:String
Aliases:BatchResourceId, BatchAudience
Position:20
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DataLakeAudience

Аудитория маркеров проверки подлинности с помощью конечной точки служб AD Data Lake.

Тип:String
Aliases:DataLakeEndpointResourceId, DataLakeResourceId
Position:19
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DefaultProfile

Credeetnails, клиент и подписка, используемая для взаимодействия с Azure

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableAdfsAuthentication

Указывает, что локальная проверка подлинности разрешена службы федерации Active Directory (AD FS) (ADFS).

Тип:SwitchParameter
Aliases:OnPremise
Position:16
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-GalleryEndpoint

Указывает конечную точку для коллекции шаблонов развертывания Azure Resource Manager.

Тип:String
Aliases:Gallery, GalleryUrl
Position:7
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-GraphAudience

Аудитория для маркеров проверки подлинности с помощью конечной точки Graph AD.

Тип:String
Aliases:GraphEndpointResourceId, GraphResourceId
Position:18
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-GraphEndpoint

Задает URL-адрес для запросов метаданных Graph (Active Directory).

Тип:String
Aliases:Graph, GraphUrl
Position:9
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ManagementPortalUrl

Указывает URL-адрес портала управления.

Тип:String
Position:3
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Указывает имя добавляемой среды.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PublishSettingsFileUrl

Указывает URL-адрес, из которого можно скачать файлы publishsettings.

Тип:String
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceManagerEndpoint

Указывает URL-адрес запросов Azure Resource Manager.

Тип:String
Aliases:ResourceManager, ResourceManagerUrl
Position:6
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Scope

Определяет область изменений контекста, например, применяются ли изменения только к текущему процессу или ко всем сеансам, запущенным этим пользователем.

Тип:ContextModificationScope
Допустимые значения:Process, CurrentUser
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ServiceEndpoint

Указывает конечную точку для запросов управления службами (RDFE).

Тип:String
Aliases:ServiceManagement, ServiceManagementUrl
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SqlDatabaseDnsSuffix

Указывает суффикс доменного имени для серверов База данных SQL Azure.

Тип:String
Position:13
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-StorageEndpoint

Указывает конечную точку для доступа к хранилищу (BLOB-объектам, таблицам, очередям и файлам).

Тип:String
Aliases:StorageEndpointSuffix
Position:4
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TrafficManagerDnsSuffix

Указывает суффикс доменного имени для служб Диспетчер трафика Azure.

Тип:String
Position:12
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

SwitchParameter

Выходные данные

PSAzureEnvironment