Freigeben über

Update-AzApiManagementRegion

  • Referenz
Modul:
Az.ApiManagement

Aktualisiert die vorhandene Bereitstellungsregion in der PsApiManagement-Instanz.

Syntax

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

Beschreibung

Das cmdlet Update-AzApiManagementRegion cmdlet aktualisiert eine vorhandene Instanz vom Typ Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion in einer Auflistung von AdditionalRegions-Objekten eines bereitgestellten Typs Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Dieses Cmdlet stellt nichts bereit, sondern aktualisiert eine Instanz von PsApiManagement im Arbeitsspeicher. Um eine Bereitstellung einer API-Verwaltung zu aktualisieren, verwenden Sie die geänderte PsApiManagementInstance- auf das Cmdlet Set-AzApiManagement.

Beispiele

Beispiel 1: Erhöht die Kapazität zusätzlicher Region in einer PsApiManagement-Instanz

$apimService = Get-AzApiManagement -ResourceGroupName $resourceGroupName -Name $apiManagementName
$apimService = Update-AzApiManagementRegion -ApiManagement $apimService -Location "North Central US" -Capacity 2 -Sku Premium
$apimService = Set-AzApiManagement -InputObject $apimService -PassThru

Mit diesem Befehl wird der API Management Premium-SKU-Dienst mit Regionen in Den USA süd- und Nord-Zentral-USA angezeigt. Anschließend erhöht sie die Kapazität der Region Nord-Zentral-USA auf 2 mit dem Set-AzApiManagement. Das nächste Cmdlet Set-AzApiManagement wendet die Konfigurationsänderung auf den API-Verwaltungsdienst an.

Beispiel 2

Aktualisiert die vorhandene Bereitstellungsregion in der PsApiManagement-Instanz. (automatisch generiert)

Update-AzApiManagementRegion -ApiManagement <PsApiManagement> -Capacity 2 -Location 'North Central US' -Sku Developer -VirtualNetwork <PsApiManagementVirtualNetwork>

Parameter

-ApiManagement

Gibt die PsApiManagement Instanz an, in der eine vorhandene Bereitstellungsregion aktualisiert werden soll.

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

-Capacity

Gibt den neuen SKU-Kapazitätswert für die Bereitstellungsregion an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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.

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

-Location

Gibt den Speicherort der zu aktualisierenden Bereitstellungsregion an. 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:True
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 den neuen Ebenenwert für die Bereitstellungsregion an. Gültige Werte sind:

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

-VirtualNetwork

Gibt eine Virtuelle Netzwerkkonfiguration für die Bereitstellungsregion an. Durch das Übergeben von $null wird die Konfiguration des virtuellen Netzwerks für die Region entfernt.

Typ:PsApiManagementVirtualNetwork
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
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

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

Ausgaben

PsApiManagement