Partilhar 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 em uma coleção de objetos AdditionalRegions de uma instância fornecida do tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Este cmdlet não implanta nada, mas atualiza uma instância do 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

Este comando obtém o serviço API Management Premium SKU, com regiões no Centro-Sul dos EUA e no 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 PsApiManagement na qual atualizar uma região de implantação existente.

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

-Capacity

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

Tipo:Int32
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
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.

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 região de implantação a ser atualizada. 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:True
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 o novo valor de camada para a região de implantação. Os valores válidos são:

  • Desenvolvedor
  • Padrão
  • Prémio
Tipo:PsApiManagementSku
Valores aceites:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
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

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

Saídas

PsApiManagement