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


Set-AzEnvironment

Задает свойства для среды Azure.

Синтаксис

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

Описание

Командлет Set-AzEnvironment задает конечные точки и метаданные для подключения к экземпляру Azure.

Примеры

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

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           :

В этом примере мы создадим новую среду Azure с примерами конечных точек с помощью Add-AzEnvironment, а затем мы изменим значение атрибутов ActiveDirectoryEndpoint и GraphEndpoint созданной среды с помощью командлета Set-AzEnvironment.

Параметры

-ActiveDirectoryEndpoint

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

Тип: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

-AzureAnalysisServicesEndpointResourceId

Идентификатор ресурса ресурса Azure Analysis Services.

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

-AzureAnalysisServicesEndpointSuffix

Конечная точка, используемая при взаимодействии с API Azure Log Analytics.

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

-AzureAttestationServiceEndpointResourceId

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

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

-AzureAttestationServiceEndpointSuffix

Суффикс Dns службы Аттестация Azure.

Тип:String
Position:Named
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

Суффикс Dns службы Azure Key Vault. Примером является vault-int.azure-int.net

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

-AzureKeyVaultServiceEndpointResourceId

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

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

-AzureOperationalInsightsEndpoint

Конечная точка, используемая при взаимодействии с API Azure Log Analytics.

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

-AzureOperationalInsightsEndpointResourceId

Аудитория для проверки подлинности маркеров с помощью API Azure Log Analytics.

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

-AzureSynapseAnalyticsEndpointResourceId

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

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

-AzureSynapseAnalyticsEndpointSuffix

Суффикс Dns в Azure Synapse Analytics.

Тип:String
Position:Named
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

-ContainerRegistryEndpointSuffix

Суффикс Реестр контейнеров Azure.

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

-DataLakeAudience

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

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

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzContext, 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. Параметр состоит в том, чтобы задать значение GalleryUrl PSAzureEnvironment. Как GalleryUrl и удалено из ArmMetadata, Azure PowerShell больше не будет предоставлять значение и поэтому больше не рекомендуется задавать GalleryEndpoint .

Тип: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

-MicrosoftGraphEndpointResourceId

Идентификатор ресурса Microsoft Graph

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

-MicrosoftGraphUrl

URL-адрес Microsoft Graph

Тип:String
Position:Named
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