Partilhar via


New-AzApiManagementRegion

Cria uma instância de PsApiManagementRegion.

Sintaxe

New-AzApiManagementRegion
   -Location <String>
   [-Capacity <Int32>]
   [-VirtualNetwork <PsApiManagementVirtualNetwork>]
   [-Zone <String[]>]
   [-DisableGateway <Boolean>]
   [-PublicIpAddressId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Comando auxiliar para criar uma instância de PsApiManagementRegion. Este comando deve ser usado com o comando New-AzApiManagement.

Exemplos

Exemplo 1

$apimRegion = New-AzApiManagementRegion -Location "Central US" 

$additionalRegions = @($apimRegion)

New-AzApiManagement -ResourceGroupName ContosoGroup -Location "West US" -Name ContosoApi -Organization Contoso -AdminEmail admin@contoso.com -AdditionalRegions $additionalRegions -Sku "Premium"

Exemplo 2

$apimRegionVirtualNetwork = New-AzApiManagementVirtualNetwork -SubnetResourceId "/subscriptions/a8ff56dc-3bc7-4174-a1e8-3726ab15d0e2/resourceGroups/ContosoGroup/providers/Microsoft.Network/virtualNetworks/centralusvirtualNetwork/subnets/backendSubnet"

$apimRegion = New-AzApiManagementRegion -Location "Central US" -VirtualNetwork $apimRegionVirtualNetwork 

$additionalRegions = @($apimRegion)

$virtualNetwork = New-AzApiManagementVirtualNetwork -SubnetResourceId "/subscriptions/a8ff56dc-3bc2-4174-a1e8-3726ab15d0e2/resourceGroups/ContosoGroup/providers/Microsoft.Network/virtualNetworks/westUsVirtualNetwork/subnets/backendSubnet"

New-AzApiManagement -ResourceGroupName ContosoGroup -Location "West US" -Name ContosoApi -Organization Contoso -AdminEmail admin@contoso.com -AdditionalRegions $additionalRegions -VirtualNetwork $virtualNetwork -VpnType "External" -Sku "Premium"

Cria um serviço ApiManagement de VpnType externo na região oeste dos EUA, com uma região adicional na região central dos EUA.

Parâmetros

-Capacity

Capacidade de sku da região adicional do serviço de Gerenciamento de API do Azure. O valor padrão é 1.

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"} | Locais de seleção de objetos

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

-VirtualNetwork

Configuração de Rede Virtual da região de implantação do Gerenciamento de API do Azure. O valor padrão é $null.

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

PsApiManagementVirtualNetwork

Saídas

PsApiManagementRegion