Compartir a través de

Add-AzApiManagementRegion

  • Referencia
Módulo:
Az.ApiManagement

Agrega nuevas regiones de implementación a una instancia de PsApiManagement.

Sintaxis

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

Description

El cmdlet Add-AzApiManagementRegion agrega una nueva instancia de tipo PsApiManagementRegion a la colección de AdditionalRegions de instancia proporcionada de tipo Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement. Este cmdlet no implementa nada por sí mismo, sino que actualiza la instancia de PsApiManagement en memoria. Para actualizar una implementación de una INSTANCIA de API Management, pase el Instancia de PsApi Management modificada a Set-AzApiManagement.

Ejemplos

Ejemplo 1: Agregar nuevas regiones de implementación a una instancia de PsApiManagement

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

Este comando agrega dos unidades de SKU premium y la región denominada Este de EE. UU. a la instancia de PsApiManagement.

Ejemplo 2: Agregar nuevas regiones de implementación a una instancia de PsApiManagement y, a continuación, actualizar la implementación

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

Este comando obtiene un objeto PsApiManagement, agrega dos unidades de SKU premium para la región denominada Este de EE. UU. y, a continuación, actualiza la implementación.

Parámetros

-ApiManagement

Especifica el instancia de PsApiManagement a la que este cmdlet agrega regiones de implementación adicionales.

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

-Capacity

Especifica la capacidad de SKU de la región de implementación.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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. El comportamiento predeterminado es hacer que la región esté activa inmediatamente.

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 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:False
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 nivel de la región de implementación. Los valores válidos son:

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

-VirtualNetwork

Especifica una configuración de red virtual.

Tipo:PsApiManagementVirtualNetwork
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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

Salidas

Notas

  • El cmdlet escribe instancia de PsApiManagement actualizada en la canalización.