Delen via


Update-AzApiManagementRegion

Hiermee wordt de bestaande implementatieregio bijgewerkt in het PsApiManagement-exemplaar.

Syntaxis

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

Description

De cmdlet Update-AzApiManagementRegion werkt een bestaand exemplaar van het type Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion bij in een verzameling AdditionalRegions-objecten van een opgegeven instantie van het type Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Met deze cmdlet wordt niets geïmplementeerd, maar wordt een exemplaar van PsApiManagement in het geheugen bijgewerkt. Als u een implementatie van een API Management wilt bijwerken, gebruikt u de gewijzigde PsApiManagementInstance naar de cmdlet Set-AzApiManagement.

Voorbeelden

Voorbeeld 1: verhoogt de capaciteit van een extra regio in een PsApiManagement-exemplaar

$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

Met deze opdracht wordt de API Management Premium SKU-service opgehaald, met regio's in VS - zuid-centraal en VS - noord-centraal. Vervolgens wordt de capaciteit van de regio VS - noord-centraal verhoogd naar 2 met behulp van Set-AzApiManagement. Met de volgende cmdlet Set-AzApiManagement wordt de configuratiewijziging toegepast op de Api Management-service.

Voorbeeld 2

Hiermee wordt de bestaande implementatieregio bijgewerkt in het PsApiManagement-exemplaar. (automatisch gegenereerd)

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

Parameters

-ApiManagement

Hiermee geeft u het PsApiManagement-exemplaar op waarin een bestaande implementatieregio moet worden bijgewerkt.

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

-Capacity

Hiermee geeft u de nieuwe SKU-capaciteitswaarde voor de implementatieregio op.

Type:Int32
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
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.

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 implementatieregio die moet worden bijgewerkt. 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:True
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 nieuwe laagwaarde voor de implementatieregio. Geldige waarden zijn:

  • Ontwikkelaar
  • Standaard
  • Premium
Type:PsApiManagementSku
Geaccepteerde waarden:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VirtualNetwork

Hiermee geeft u een virtuele netwerkconfiguratie voor de implementatieregio. Als u $null doorgeeft, wordt de configuratie van het virtuele netwerk voor de regio verwijderd.

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

PsApiManagement

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

Uitvoerwaarden

PsApiManagement