Compartir a través de

Add-AzApiManagementRegion

  • Referencia
Módulo:
Az.ApiManagement

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

Syntax

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 la instancia proporcionada del 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 la instancia de PsApiManagement 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 la instancia de PsApiManagement a la que este cmdlet agrega regiones de implementación adicionales.

Tipo:PsApiManagement
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-Capacity

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

Tipo:Nullable<T>[Int32]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters: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]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters: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
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddressId

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

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

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

  • Desarrollador
  • Estándar
  • Premium
Tipo:Nullable<T>[PsApiManagementSku]
valores aceptados:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

Especifica una configuración de red virtual.

Tipo:PsApiManagementVirtualNetwork
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

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

Tipo:String[]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

PsApiManagement

Salidas

PsApiManagement

Notas

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