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

Add-AzApiManagementRegion

  • Ссылка
Модуль:
Az.ApiManagement

Добавляет новые регионы развертывания в экземпляр PsApiManagement.

Синтаксис

Add-AzApiManagementRegion
   -ApiManagement <PsApiManagement>
   -Location <String>
   [-Sku <PsApiManagementSku>]
   [-Capacity <Int32>]
   [-VirtualNetwork <PsApiManagementVirtualNetwork>]
   [-Zone <String[]>]
   [-DisableGateway <Boolean>]
   [-PublicIpAddressId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет add-AzApiManagementRegion добавляет новый экземпляр типа PsApiManagementRegion в коллекцию AdditionalRegagement предоставленного экземпляра типа Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Этот командлет не развертывает ничего самостоятельно, но обновляет экземпляр PsApiManagement в памяти. Чтобы обновить развертывание службы управления API, передайте измененную экземпляр psApiManagement в Set-AzApiManagement.

Примеры

Пример 1. Добавление новых регионов развертывания в экземпляр PsApiManagement

Add-AzApiManagementRegion -ApiManagement $ApiManagement -Location "East US" -Sku "Premium" -Capacity 2

Эта команда добавляет два единица SKU уровня "Премиум" и регион с именем "Восточная часть США" в экземпляр psApiManagement.

Пример 2. Добавление новых регионов развертывания в экземпляр PsApiManagement и обновление развертывания

$service = Get-AzApiManagement -ResourceGroupName "Contoso" -Name "ContosoApi"
$service = Add-AzApiManagementRegion -ApiManagement $service -Location $secondarylocation -VirtualNetwork $additionalRegionVirtualNetwork
$service = Set-AzApiManagement -InputObject $service -PassThru

Эта команда получает объект PsApiManagement, добавляет два единица SKU класса Premium для региона с именем "Восточная часть США", а затем обновляет развертывание.

Параметры

-ApiManagement

Указывает экземпляр psApiManagement , в который этот командлет добавляет дополнительные регионы развертывания.

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

-Capacity

Указывает емкость SKU региона развертывания.

Тип:Nullable<T>[Int32]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

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

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

-DisableGateway

Флаг предназначен только для развертываний Служб ApiManagement класса Premium и внутренних виртуальных сетей. Это полезно в случае, если мы хотим взять регион шлюза из смены. Это также можно использовать для вставки нового региона в пассивном режиме, протестировать его, а затем сделать его live позже. Поведение по умолчанию — сделать регион активным немедленно.

Тип:Nullable<T>[Boolean]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Location

Указывает расположение нового региона развертывания среди поддерживаемого региона для службы управления API. Чтобы получить допустимые расположения, используйте командлет Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | где {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | расположения Select-Object

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

-PublicIpAddressId

Standard SKU PublicIpAddress ResoureId для интеграции с развертываниями виртуальных сетей stv2

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

-Sku

Задает уровень региона развертывания. Допустимые значения:

  • Разработчик
  • Стандарт
  • Премия
Тип:Nullable<T>[PsApiManagementSku]
Допустимые значения:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VirtualNetwork

Указывает конфигурацию виртуальной сети.

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

-Zone

Список зон доступности, обозначающих, где развернута служба управления API.

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

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

PsApiManagement

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

PsApiManagement

Примечания

  • Командлет записывает обновленные psApiManagement экземпляр в конвейер.