Partilhar 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 nova instância do tipo PsApiManagementRegion à coleção de AdditionalRegions da instância fornecida do tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Este 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

Este comando adiciona duas unidades SKU premium e a região chamada East US à 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

Este comando obtém um objeto PsApiManagement , adiciona duas unidades SKU premium para a região chamada Leste dos EUA e, em seguida, 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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Capacity

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

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisableGateway

Sinalizador destinado apenas a ser usado para implantações de SKU Premium, Serviço de Gerenciamento de Api e VNET Não Interna. Isso é útil caso queiramos tirar uma região de gateway da rotação. Isso também pode ser usado para colocar em pé uma nova região no modo passivo, testá-la e, em seguida, torná-la ao vivo mais tarde. O comportamento padrão é fazer a região viver imediatamente.

Tipo:Nullable<T>[Boolean]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Location

Especifica o local da nova região de implantação entre a região suportada 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 "serviço"} | Select-Object Localizações

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublicIpAddressId

SKU padrão PublicIpAddress ResoureId para integração em implantações de rede virtual stv2

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Sku

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

  • Desenvolvedor
  • Padrão
  • Prémio
Tipo:Nullable<T>[PsApiManagementSku]
Valores aceites:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VirtualNetwork

Especifica uma configuração de rede virtual.

Tipo:PsApiManagementVirtualNetwork
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Zone

Uma lista de zonas de disponibilidade indicando onde o serviço de gerenciamento de api é implantado.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

PsApiManagement

Saídas

PsApiManagement

Notas

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