Share via

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 alla raccolta di AdditionalRegions 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 un Gestione API passare l'istanza di PsApiManagement modificata 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.

Type:PsApiManagement
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Capacity

Specifica la capacità sku dell'area di distribuzione.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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"} | Posizioni dell'oggetto Select

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddressId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

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

  • Sviluppatore
  • Standard
  • Premium
Type:Nullable<T>[PsApiManagementSku]
Accepted values:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

Specifica una configurazione di rete virtuale.

Type:PsApiManagementVirtualNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

PsApiManagement

Output

PsApiManagement

Note

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