Condividi tramite

Add-AzApiManagementRegion

  • Riferimento
Modulo:
Az.ApiManagement

Aggiunge nuove aree di distribuzione a un'istanza di PsApiManagement.

Sintassi

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

Descrizione

Il cmdlet Add-AzApiManagementRegion aggiunge una nuova istanza di tipo PsApiManagementRegion all'insieme di AdditionalRegions dell'istanza specificata di tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Questo cmdlet non distribuisce nulla da solo, ma aggiorna l'istanza di PsApiManagement in memoria. Per aggiornare una distribuzione di Gestione API, passare l'istanza modificata PsApiManagement a Set-AzApiManagement.

Esempio

Esempio 1: Aggiungere nuove aree di distribuzione a un'istanza di PsApiManagement

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

Questo comando aggiunge due unità SKU Premium e l'area denominata Stati Uniti orientali all'istanza di PsApiManagement.

Esempio 2: Aggiungere nuove aree di distribuzione a un'istanza di PsApiManagement e quindi aggiornare la distribuzione

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

Questo comando ottiene un oggetto PsApiManagement, aggiunge due unità SKU Premium per l'area denominata Stati Uniti orientali e quindi aggiorna la distribuzione.

Parametri

-ApiManagement

Specifica l'istanza di PsApiManagement a cui questo cmdlet aggiunge aree di distribuzione aggiuntive.

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

-Capacity

Specifica la capacità sku dell'area di distribuzione.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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. Il comportamento predefinito consiste nel rendere immediatamente attiva l'area.

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

-Location

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"} | Select-Object posizioni

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

-PublicIpAddressId

Sku Standard PublicIpAddress ResoureId per l'integrazione in distribuzioni di rete virtuale stv2

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

-Sku

Specifica il livello dell'area di distribuzione. I valori validi sono:

  • Sviluppatore
  • Standard
  • Premio
Tipo:Nullable<T>[PsApiManagementSku]
Valori accettati:Developer, Standard, Premium, Basic, Consumption, Isolated
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VirtualNetwork

Specifica una configurazione di rete virtuale.

Tipo:PsApiManagementVirtualNetwork
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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

Output

Note

  • Il cmdlet scrive 'istanza di PsApiManagement aggiornata nella pipeline.