Condividi tramite

Update-AzApiManagementRegion

  • Riferimento
Modulo:
Az.ApiManagement

Aggiorna l'area di distribuzione esistente nell'istanza di PsApiManagement.

Sintassi

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

Descrizione

Il cmdlet Update-AzApiManagementRegion aggiorna un'istanza esistente di tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion in un insieme di oggetti AdditionalRegions di un'istanza fornita di tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Questo cmdlet non distribuisce nulla, ma aggiorna un'istanza di PsApiManagement in memoria. Per aggiornare una distribuzione di un Gestione API usare psApiManagementInstance modificato nel cmdlet Set-AzApiManagement.

Esempio

Esempio 1: aumenta la capacità di un'area aggiuntiva in un'istanza di PsApiManagement

$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

Questo comando ottiene il servizio SKU Premium Gestione API, con aree negli Stati Uniti centro-meridionali e negli Stati Uniti centro-settentrionali. Aumenta quindi la capacità dell'area Stati Uniti centro-settentrionali a 2 usando Set-AzApiManagement. Il cmdlet successivo Set-AzApiManagement applica la modifica di configurazione al servizio Gestione API.

Esempio 2

Aggiorna l'area di distribuzione esistente nell'istanza di PsApiManagement. (generato automaticamente)

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

Parametri

-ApiManagement

Specifica l'istanza di PsApiManagement in cui aggiornare un'area di distribuzione esistente.

Tipo:PsApiManagement
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Capacity

Specifica il nuovo valore di capacità SKU per l'area di distribuzione.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableGateway

Flag destinato solo a essere usato per le distribuzioni apiManagement per SKU Premium e reti virtuali non interne. Ciò è utile nel caso in cui si voglia evitare la rotazione di un'area del gateway. Può anche essere usato per mantenere una nuova area in modalità passiva, testarla e quindi renderla attiva in un secondo momento.

Tipo:Nullable<T>[Boolean]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Location

Specifica il percorso dell'area di distribuzione da aggiornare. Specifica la posizione della nuova area di distribuzione tra l'area supportata per il servizio Gestione API. Per ottenere percorsi validi, usare il cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | dove {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Posizioni dell'oggetto Select

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PublicIpAddressId

Sku Standard PublicIpAddress ResoureId per l'integrazione in stv2 Rete virtuale Distribuzioni

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Sku

Specifica il nuovo valore del livello per l'area di distribuzione. I valori validi sono:

  • Sviluppatore
  • Standard
  • Premium
Tipo:PsApiManagementSku
Valori accettati:Developer, Standard, Premium, Basic, Consumption, Isolated
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VirtualNetwork

Specifica una configurazione di rete virtuale per l'area di distribuzione. Il passaggio di $null rimuoverà la configurazione della rete virtuale per l'area.

Tipo:PsApiManagementVirtualNetwork
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Zone

Elenco delle zone di disponibilità che indicano dove viene distribuito il servizio Gestione API.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

PsApiManagement

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

Output

PsApiManagement