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 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. Verwenden Sie zum Aktualisieren einer Bereitstellung einer API-Verwaltung das geänderte PsApiManagementInstance-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 mit dem Set-AzApiManagement auf 2. 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
Accept pipeline input:True
Accept wildcard characters:False

-Capacity

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

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters: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"} | Speicherorte für Select-Object

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-PublicIpAddressId

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

Gibt den neuen Ebenenwert für die Bereitstellungsregion an. Gültige Werte sind:

  • Entwickler
  • Standard
  • Premium
Typ:PsApiManagementSku
Zulässige Werte:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-Zone

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

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

PsApiManagement

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

Ausgaben

PsApiManagement