Delen via


Add-AzApiManagementRegion

Voegt nieuwe implementatieregio's toe aan een PsApiManagement-exemplaar.

Syntaxis

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

Description

De cmdlet Add-AzApiManagementRegion voegt een nieuw exemplaar van het type PsApiManagementRegion toe aan de verzameling AdditionalRegions van het opgegeven exemplaar van het type Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Met deze cmdlet wordt niets zelf geïmplementeerd, maar wordt het exemplaar van PsApiManagement in het geheugen bijgewerkt. Als u een implementatie van een API Management wilt bijwerken, geeft u het gewijzigde PsApiManagement-exemplaar door aan Set-AzApiManagement.

Voorbeelden

Voorbeeld 1: Nieuwe implementatieregio's toevoegen aan een PsApiManagement-exemplaar

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

Met deze opdracht worden twee Premium SKU-eenheden en de regio VS - oost toegevoegd aan het PsApiManagement-exemplaar .

Voorbeeld 2: Nieuwe implementatieregio's toevoegen aan een PsApiManagement-exemplaar en vervolgens de implementatie bijwerken

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

Met deze opdracht wordt een PsApiManagement-object opgehaald, worden twee premium SKU-eenheden toegevoegd voor de regio met de naam VS - oost en wordt vervolgens de implementatie bijgewerkt.

Parameters

-ApiManagement

Hiermee geeft u het PsApiManagement-exemplaar op waaraan deze cmdlet extra implementatieregio's toevoegt.

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

-Capacity

Hiermee geeft u de SKU-capaciteit van de implementatieregio.

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

-Sku

Hiermee geeft u de laag van de implementatieregio. Geldige waarden zijn:

  • Ontwikkelaar
  • Standaard
  • Premium
Type:Nullable<T>[PsApiManagementSku]
Geaccepteerde waarden:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VirtualNetwork

Hiermee geeft u een configuratie van een virtueel netwerk op.

Type:PsApiManagementVirtualNetwork
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
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

PsApiManagement

Uitvoerwaarden

PsApiManagement

Notities

  • De cmdlet schrijft een bijgewerkt PsApiManagement-exemplaar naar de pijplijn.