Delen via


New-AzApiManagementRegion

Hiermee maakt u een exemplaar van PsApiManagementRegion.

Syntaxis

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

Description

De Helper-opdracht voor het maken van een exemplaar van PsApiManagementRegion. Deze opdracht moet worden gebruikt met de opdracht New-AzApiManagement.

Voorbeelden

Voorbeeld 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"

Voorbeeld 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"

Hiermee maakt u een ApiManagement-service van extern VpnType in de regio VS - west, met een extra regio in VS - centraal.

Parameters

-Capacity

SKU-capaciteit van de extra regio van de Azure API Management-service. De standaardwaarde is 1.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisableGateway

Vlag die alleen moet worden gebruikt voor Premium SKU ApiManagement-service en niet-interne VNET-implementaties. Dit is handig als we een gatewayregio uit de rotatie willen halen. Dit kan ook worden gebruikt om een nieuwe regio op te stellen in de passieve modus, deze te testen en deze later live te maken. Standaardgedrag is om de regio onmiddellijk live te maken.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

Hiermee geeft u de locatie van de nieuwe implementatieregio onder de ondersteunde regio voor api management-service. Gebruik de cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | waarbij {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Select-Object Locations

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublicIpAddressId

Standard SKU PublicIpAddress ResoureId voor integratie in stv2 Virtual Network Deployments.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VirtualNetwork

Virtual Network Configuration of Azure API Management deployment region. De standaardwaarde is $null.

Type:PsApiManagementVirtualNetwork
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Zone

Een lijst met beschikbaarheidszones die aangeeft waar de API Management-service in wordt geïmplementeerd.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

PsApiManagementVirtualNetwork

Uitvoerwaarden

PsApiManagementRegion