Freigeben über

Add-AzApiManagementRegion

  • Referenz
Modul:
Az.ApiManagement

Fügt einer PsApiManagement-Instanz neue Bereitstellungsregionen hinzu.

Syntax

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

Beschreibung

Mit dem Cmdlet Add-AzApiManagementRegion cmdlet wird der Auflistung AdditionalRegion Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementneue Instanz vom Typ "Add-AzApiManagementRegion" hinzugefügt. Dieses Cmdlet stellt nichts selbst bereit, sondern aktualisiert die Instanz von PsApiManagement im Arbeitsspeicher. Um eine Bereitstellung einer API-Verwaltung zu aktualisieren, übergeben Sie die geänderte PsApiManagement Instanz an Set-AzApiManagement.

Beispiele

Beispiel 1: Hinzufügen neuer Bereitstellungsregionen zu einer PsApiManagement-Instanz

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

Mit diesem Befehl werden der PsApiManagement Instanz zwei Premium-SKU-Einheiten und die Region "East US" hinzugefügt.

Beispiel 2: Hinzufügen neuer Bereitstellungsregionen zu einer PsApiManagement-Instanz und anschließendes Aktualisieren der Bereitstellung

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

Dieser Befehl ruft ein PsApiManagement--Objekt ab, fügt zwei Premium-SKU-Einheiten für die Region namens East US hinzu und aktualisiert dann die Bereitstellung.

Parameter

-ApiManagement

Gibt die PsApiManagement Instanz an, der dieses Cmdlet zusätzliche Bereitstellungsregionen hinzufügt.

Typ:PsApiManagement
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Capacity

Gibt die SKU-Kapazität der Bereitstellungsregion an.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableGateway

Das Flag sollte nur für Premium-SKU-ApiManagement-Dienst und nicht interne VNET-Bereitstellungen verwendet werden. Dies ist nützlich, wenn wir einen Gatewaybereich aus der Drehung herausnehmen möchten. Dies kann auch verwendet werden, um eine neue Region im passiven Modus zu standupieren, zu testen und es später live zu machen. Das Standardverhalten besteht darin, die Region sofort zu liveieren.

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Gibt den Standort der neuen Bereitstellungsregion unter der unterstützten Region für den API-Verwaltungsdienst an. Verwenden Sie zum Abrufen gültiger Speicherorte das Cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | dabei {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Select-Object Speicherorte

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIpAddressId

Standard-SKU PublicIpAddress ResoureId für die Integration in stv2 Virtual Network Deployments

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Sku

Gibt die Ebene der Bereitstellungsregion an. Gültige Werte sind:

  • Entwickler
  • Norm
  • Prämie
Typ:Nullable<T>[PsApiManagementSku]
Zulässige Werte:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetwork

Gibt eine Virtuelle Netzwerkkonfiguration an.

Typ:PsApiManagementVirtualNetwork
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Zone

Eine Liste der Verfügbarkeitszonen, in denen der API-Verwaltungsdienst bereitgestellt wird.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

PsApiManagement

Ausgaben

PsApiManagement

Hinweise

  • Das Cmdlet schreibt aktualisiert PsApiManagement Instanz in die Pipeline.