Update-AzApiManagementRegion

Aggiornamenti'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

Aggiornamenti'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.

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

-Capacity

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

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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 nuovo valore del livello per l'area di distribuzione. I valori validi sono:

  • Sviluppatore
  • Standard
  • Premium
Type:PsApiManagementSku
Accepted values:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:PsApiManagementVirtualNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

Output

PsApiManagement