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 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 chamada Leste dos EUA à instância PsApiManagement .

Exemplo 2: Adicionar novas regiões de implantação a uma instância 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, em seguida, atualiza a implantação.

Parâmetros

-ApiManagement

Especifica a instância 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 SKU Premium, Serviço ApiManagement e implantações de VNET não interna. Isso é útil caso queiramos tirar uma região de gateway da rotação. Isso também pode ser usado para criar uma nova região no modo passivo, testá-la e torná-la ativa mais tarde. O comportamento padrão é fazer com que a região viva 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]. Nome_do_Recurso -eq "serviço"} | Selecionar locais de objeto

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

-PublicIpAddressId

SKU Standard PublicIpAddress ResoureId para integração em 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:

  • Desenvolvedor
  • Standard
  • Premium
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 que indica onde o serviço de gerenciamento de API está 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 PsApiManagement atualizada no pipeline.