Compartilhar via

Update-AzApiManagementRegion

  • Referência
Módulo:
Az.ApiManagement

Atualiza a região de implantação existente na instância PsApiManagement.

Sintaxe

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

Description

O cmdlet Update-AzApiManagementRegion atualiza uma instância existente do tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion em uma coleção de objetos AdditionalRegions de uma instância fornecida do tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Esse cmdlet não implanta nada além de atualizar uma instância de PsApiManagement na memória. Para atualizar uma implantação de um Gerenciamento de API, use o PsApiManagementInstance modificado para o cmdlet Set-AzApiManagement.

Exemplos

Exemplo 1: aumenta a capacidade de Região Adicional em uma instância 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

Esse comando obtém o serviço de SKU Premium do Gerenciamento de API, tendo regiões no Centro-Sul dos EUA e Centro-Norte dos EUA. Em seguida, aumenta a capacidade da região Centro-Norte dos EUA para 2 usando o Set-AzApiManagement. O próximo cmdlet Set-AzApiManagement aplica a alteração de configuração ao serviço de Gerenciamento de API.

Exemplo 2

Atualiza a região de implantação existente na instância PsApiManagement. (gerado automaticamente)

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

Parâmetros

-ApiManagement

Especifica a instância de PsApiManagement para atualizar uma região de implantação existente.

Tipo:PsApiManagement
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Capacity

Especifica o novo valor de capacidade de SKU para a região de implantação.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableGateway

Sinalizador destinado apenas a ser usado para o Serviço ApiManagement de SKU Premium e implantações de VNET não internas. Isso é útil caso queiramos tirar uma região de gateway da rotação. Isso também pode ser usado para fazer standup de uma nova região no modo passivo, testá-la e, em seguida, torná-la ativa mais tarde.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

Especifica o local da região de implantação a ser atualizada. Especifica o local da nova região de implantação entre a região com suporte para o serviço de Gerenciamento de API. Para obter locais válidos, use o cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | onde {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Select-Object Locais

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PublicIpAddressId

PublicIpAddress ResoureId do SKU Standard para integração com implantações de rede virtual stv2

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Sku

Especifica o novo valor de camada para a região de implantação. Os valores válidos são:

  • Revelador
  • Padrão
  • Prêmio
Tipo:PsApiManagementSku
Valores aceitos:Developer, Standard, Premium, Basic, Consumption, Isolated
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VirtualNetwork

Especifica uma configuração de rede virtual para a região de implantação. Passar $null removerá a configuração de rede virtual para a região.

Tipo:PsApiManagementVirtualNetwork
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Zone

Uma lista de zonas de disponibilidade indicando em que local o serviço de gerenciamento de API é implantado.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

PsApiManagement

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

Saídas

PsApiManagement