Compartilhar via

Add-AzApiManagementRegion

  • Referência
Módulo:
Az.ApiManagement

Adiciona novas regiões de implantação a uma instância PsApiManagement.

Sintaxe

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

Description

O cmdlet Add-AzApiManagementRegion adiciona uma nova instância do tipo PsApiManagementRegion à coleção de AdditionalRegions da instância fornecida do tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Esse cmdlet não implanta nada por si só, mas atualiza a instância de PsApiManagement na memória. Para atualizar uma implantação de um Gerenciamento de API, passe a instância de PsApiManagement modificada para Set-AzApiManagement.

Exemplos

Exemplo 1: Adicionar novas regiões de implantação a uma instância PsApiManagement

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

Esse comando adiciona duas unidades de SKU premium e a região denominada Leste dos EUA à instância de PsApiManagement .

Exemplo 2: Adicionar novas regiões de implantação a uma instância do PsApiManagement e, em seguida, atualizar a implantação

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

Esse comando obtém um objeto PsApiManagement, adiciona duas unidades de SKU premium para a região chamada Leste dos EUA e atualiza a implantação.

Parâmetros

-ApiManagement

Especifica a instância de PsApiManagement à qual esse cmdlet adiciona regiões de implantação adicionais.

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

-Capacity

Especifica a capacidade de SKU da região de implantação.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
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. O comportamento padrão é tornar a região dinâmica imediatamente.

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 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:False
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 a camada da região de implantação. Os valores válidos são:

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

-VirtualNetwork

Especifica uma configuração de rede virtual.

Tipo:PsApiManagementVirtualNetwork
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
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

Saídas

PsApiManagement

Observações

  • O cmdlet grava a instância de PsApiManagement atualizada no pipeline.