Sdílet prostřednictvím

Add-AzApiManagementRegion

  • Reference
Modul:
Az.ApiManagement

Přidá nové oblasti nasazení do instance PsApiManagement.

Syntaxe

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

Description

Rutina Add-AzApiManagementRegion přidá novou instanci typu PsApiManagementRegion do kolekce AdditionalRegions poskytnuté instance typu Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Tato rutina nenasazuje nic samotného, ale aktualizuje instanci PsApiManagement v paměti. Aktualizace nasazení služby API Management předá upravené PsApiManagement instanci do Set-AzApiManagement.

Příklady

Příklad 1: Přidání nových oblastí nasazení do instance PsApiManagement

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

Tento příkaz přidá dvě jednotky skladové položky Premium a oblast s názvem USA – východ do instance PsApiManagement instance.

Příklad 2: Přidání nových oblastí nasazení do instance PsApiManagement a následné aktualizace nasazení

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

Tento příkaz získá objekt PsApiManagement, přidá dvě jednotky SKU Úrovně Premium pro oblast s názvem USA – východ a pak aktualizuje nasazení.

Parametry

-ApiManagement

Určuje instanci PsApiManagement, do které tato rutina přidá další oblasti nasazení.

Typ:PsApiManagement
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Capacity

Určuje kapacitu skladové položky oblasti nasazení.

Typ:Nullable<T>[Int32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisableGateway

Příznak určený pouze pro nasazení apimanagement služby ApiManagement úrovně Premium a neinterních virtuálních sítí. To je užitečné v případě, že chceme oblast brány převést mimo obměnu. Můžete ho také použít k vytvoření nové oblasti v pasivním režimu, otestování a pozdějšímu nastavení. Výchozí chování spočívá v tom, aby oblast byla okamžitě aktivní.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Location

Určuje umístění nové oblasti nasazení mezi podporovanou oblastí služby Api Management. K získání platných umístění použijte rutinu Get-AzResourceProvider -ProviderNamespace Microsoft.ApiManagement | where {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | umístění Select-Object

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PublicIpAddressId

Standard SKU PublicIpAddress ResoureId pro integraci do nasazení virtuální sítě stv2

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Sku

Určuje úroveň oblasti nasazení. Platné hodnoty jsou:

  • Vývojář
  • Standard
  • Prémie
Typ:Nullable<T>[PsApiManagementSku]
Přípustné hodnoty:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VirtualNetwork

Určuje konfiguraci virtuální sítě.

Typ:PsApiManagementVirtualNetwork
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Zone

Seznam zón dostupnosti označující, kam je služba API Management nasazená.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

Výstupy

Poznámky

  • Rutina zapisuje aktualizovanou PsApiManagement instanci do kanálu.