Dela via


New-AzApiManagementRegion

Skapar en instans av PsApiManagementRegion.

Syntax

New-AzApiManagementRegion
   -Location <String>
   [-Capacity <Int32>]
   [-VirtualNetwork <PsApiManagementVirtualNetwork>]
   [-Zone <String[]>]
   [-DisableGateway <Boolean>]
   [-PublicIpAddressId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Hjälpkommando för att skapa en instans av PsApiManagementRegion. Det här kommandot ska användas med kommandot New-AzApiManagement.

Exempel

Exempel 1

$apimRegion = New-AzApiManagementRegion -Location "Central US" 

$additionalRegions = @($apimRegion)

New-AzApiManagement -ResourceGroupName ContosoGroup -Location "West US" -Name ContosoApi -Organization Contoso -AdminEmail admin@contoso.com -AdditionalRegions $additionalRegions -Sku "Premium"

Exempel 2

$apimRegionVirtualNetwork = New-AzApiManagementVirtualNetwork -SubnetResourceId "/subscriptions/a8ff56dc-3bc7-4174-a1e8-3726ab15d0e2/resourceGroups/ContosoGroup/providers/Microsoft.Network/virtualNetworks/centralusvirtualNetwork/subnets/backendSubnet"

$apimRegion = New-AzApiManagementRegion -Location "Central US" -VirtualNetwork $apimRegionVirtualNetwork 

$additionalRegions = @($apimRegion)

$virtualNetwork = New-AzApiManagementVirtualNetwork -SubnetResourceId "/subscriptions/a8ff56dc-3bc2-4174-a1e8-3726ab15d0e2/resourceGroups/ContosoGroup/providers/Microsoft.Network/virtualNetworks/westUsVirtualNetwork/subnets/backendSubnet"

New-AzApiManagement -ResourceGroupName ContosoGroup -Location "West US" -Name ContosoApi -Organization Contoso -AdminEmail admin@contoso.com -AdditionalRegions $additionalRegions -VirtualNetwork $virtualNetwork -VpnType "External" -Sku "Premium"

Skapar en ApiManagement-tjänst för extern VPNType i regionen USA, västra, med en ytterligare region i USA, centrala.

Parametrar

-Capacity

SKU-kapacitet för Azure API Management-tjänsten ytterligare region. Standardvärdet är 1.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisableGateway

Flaggan är endast avsedd att användas för Premium SKU ApiManagement Service och icke-interna VNET-distributioner. Detta är användbart om vi vill ta bort en gateway-region från rotationen. Detta kan också användas för att ställa upp en ny region i passivt läge, testa den och sedan göra den live senare. Standardbeteendet är att göra regionen live omedelbart.

Typ:Nullable<T>[Boolean]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Location

Anger platsen för den nya distributionsregionen mellan den region som stöds för Api Management-tjänsten. Om du vill hämta giltiga platser använder du cmdleten Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | där {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Select-Object platser

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublicIpAddressId

Standard SKU PublicIpAddress ResoureId för integrering i Stv2 Virtual Network Deployments.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VirtualNetwork

Konfiguration av virtuellt nätverk i distributionsregionen för Azure API Management. Standardvärdet är $null.

Typ:PsApiManagementVirtualNetwork
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Zone

En lista över tillgänglighetszoner som anger var API-hanteringstjänsten distribueras till.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

PsApiManagementVirtualNetwork

Utdata

PsApiManagementRegion