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


Add-AzureEnvironment

Создает среду Azure.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

Add-AzureEnvironment
   -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>]
   [-EnableAdfsAuthentication]
   [-AdTenant <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Описание

Командлет Add-AzureEnvironment создает новую настраиваемую среду учетной записи Azure и сохраняет ее в перемещаемом профиле пользователя. Командлет возвращает объект, представляющий новую среду. По завершении команды можно использовать среду в Windows PowerShell.

Среда Azure независимое развертывание Microsoft Azure, например AzureCloud для глобальной среды Azure и AzureChinaCloud для Azure под управлением 21Vianet в Китае. Вы также можете создавать локальные среды Azure с помощью Azure Pack и командлетов WAPack. Дополнительные сведения см. в пакете Azure.

Обязательны только параметр Name этого командлета. Если параметр не указан, его значение равно NULL ($Null), а служба, использующая эту конечную точку, может не работать должным образом. Чтобы добавить или изменить значение свойства среды, используйте командлет Set-AzureEnvironment .

ПРИМЕЧАНИЕ. Изменение среды может привести к сбою учетной записи. Как правило, среды добавляются только для тестирования или устранения неполадок.

В этом разделе описывается командлет в версии 0.8.10 модуля Microsoft Azure PowerShell. Чтобы получить версию используемого модуля, в консоли Azure PowerShell введите (Get-Module -Name Azure).Version.

Примеры

Пример 1. Добавление среды Azure

PS C:\> Add-AzureEnvironment -Name ContosoEnv -PublishSettingsFileUrl https://contoso.com/fwlink/?LinkID=101 -ServiceEndpoint https://contoso.com/fwlink/?LinkID=102

Name                          : ContosoEnv

PublishSettingsFileUrl        : https://contoso.com/fwlink/?LinkID=101

ServiceEndpoint               : https://contoso.com/fwlink/?LinkID=102

ResourceManagerEndpoint       :

ManagementPortalUrl           :

ActiveDirectoryEndpoint       :

ActiveDirectoryCommonTenantId :

StorageEndpointSuffix         :

StorageBlobEndpointFormat     :

StorageQueueEndpointFormat    :

StorageTableEndpointFormat    :

GalleryEndpoint               :

Эта команда создает среду Azure ContosoEnv.

Параметры

-ActiveDirectoryEndpoint

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

Тип:String
Aliases:AdEndpointUrl, ActiveDirectory, ActiveDirectoryAuthority
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-ActiveDirectoryServiceEndpointResourceId

Указывает идентификатор ресурса API управления, доступ к которому управляется идентификатором Microsoft Entra.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-AdTenant

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureKeyVaultDnsSuffix

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureKeyVaultServiceEndpointResourceId

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-EnableAdfsAuthentication

Тип:SwitchParameter
Aliases:OnPremise
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-GalleryEndpoint

Указывает конечную точку для коллекции Azure Resource Manager, в которой хранятся шаблоны коллекций групп ресурсов. Дополнительные сведения о группах ресурсов Azure и шаблонах коллекции см. в разделе справки для Get-AzureResourceGroupGalleryTemplatehttps://go.microsoft.com/fwlink/?LinkID=393052.

Тип:String
Aliases:Gallery, GalleryUrl
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-GraphEndpoint

Тип:String
Aliases:Graph, GraphUrl
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-ManagementPortalUrl

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

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Указывает имя среды. Этот параметр является обязательным. Не используйте имена сред по умолчанию, AzureCloud и AzureChinaCloud.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Тип:AzureSMProfile
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishSettingsFileUrl

Указывает URL-адрес файлов параметров публикации для учетной записи. Файл параметров публикации Azure — это XML-файл, содержащий сведения о вашей учетной записи и сертификате управления, который позволяет Windows PowerShell войти в учетную запись Azure от вашего имени.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceManagerEndpoint

Указывает конечную точку для данных Azure Resource Manager, включая данные о группах ресурсов, связанных с учетной записью. Дополнительные сведения о Azure Resource Manager см. в разделе "Командлеты Azure Resource Manager" (https://go.microsoft.com/fwlink/?LinkID=394765) и использование Windows PowerShell с Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).

Тип:String
Aliases:ResourceManager, ResourceManagerUrl
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceEndpoint

Указывает URL-адрес конечной точки службы Azure. Конечная точка службы Azure определяет, управляется ли ваше приложение глобальной платформой Azure, Azure, управляемой 21Vianet в Китае или частной установкой Azure.

Тип:String
Aliases:ServiceManagement, ServiceManagementUrl
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-SqlDatabaseDnsSuffix

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpoint

Указывает конечную точку по умолчанию служб хранилища в новой среде.

Тип:String
Aliases:StorageEndpointSuffix
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-TrafficManagerDnsSuffix

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

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

None

Входные данные можно передать в этот командлет по имени свойства, но не по значению.

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

Microsoft.WindowsAzure.Commands.Utilities.Common.WindowsAzureEnvironment