Compartir a través de

Update-AzApiManagementRegion

  • Referencia
Módulo:
Az.ApiManagement

Actualiza la región de implementación existente en la instancia de PsApiManagement.

Sintaxis

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

Description

El cmdlet Update-AzApiManagementRegion actualiza una instancia existente de tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion en una colección de objetos AdditionalRegions de una instancia proporcionada de tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Este cmdlet no implementa nada, sino que actualiza una instancia de PsApiManagement en memoria. Para actualizar una implementación de API Management, use psApiManagementInstance modificado en el cmdlet Set-AzApiManagement.

Ejemplos

Ejemplo 1: Aumenta la capacidad de región adicional en una instancia de 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 obtiene el servicio de SKU premium de API Management, que tiene regiones en centro-sur de EE. UU. y centro-norte de EE. UU. A continuación, aumenta la capacidad de la región Centro-norte de EE. UU. a 2 mediante Set-AzApiManagement. El siguiente cmdlet Set-AzApiManagement aplica el cambio de configuración al servicio Api Management.

Ejemplo 2

Actualiza la región de implementación existente en la instancia de PsApiManagement. (generado automáticamente)

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

Parámetros

-ApiManagement

Especifica la instancia de PsApiManagement en la que actualizar una región de implementación existente.

Tipo:PsApiManagement
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Capacity

Especifica el nuevo valor de capacidad de SKU para la región de implementación.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableGateway

Marca solo diseñada para usarse para las implementaciones de VNET no internas y el servicio ApiManagement de SKU Premium. Esto es útil en caso de que deseemos dejar una región de puerta de enlace fuera de la rotación. Esto también se puede usar para mantener una nueva región en modo pasivo, probarla y, a continuación, hacer que live más adelante.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Location

Especifica la ubicación de la región de implementación que se va a actualizar. Especifica la ubicación de la nueva región de implementación entre la región admitida para el servicio Api Management. Para obtener ubicaciones válidas, use el cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | donde {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Ubicaciones de select-object

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PublicIpAddressId

SKU estándar PublicIpAddress ResoureId para la integración en implementaciones de red virtual stv2

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Sku

Especifica el nuevo valor de nivel para la región de implementación. Los valores válidos son:

  • Desarrollador
  • Estándar
  • Premium
Tipo:PsApiManagementSku
Valores aceptados:Developer, Standard, Premium, Basic, Consumption, Isolated
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VirtualNetwork

Especifica una configuración de red virtual para la región de implementación. Pasar $null quitará la configuración de red virtual de la región.

Tipo:PsApiManagementVirtualNetwork
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Zone

Lista de zonas de disponibilidad en las que se indica dónde se implementa el servicio api management.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

PsApiManagement

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

Salidas

PsApiManagement