Partager via


New-AzApiManagementRegion

Crée une instance de PsApiManagementRegion.

Syntaxe

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

Description

Commande d’assistance pour créer une instance de PsApiManagementRegion. Cette commande doit être utilisée avec New-AzApiManagement commande.

Exemples

Exemple 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"

Exemple 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"

Crée un service ApiManagement de VpnType externe dans la région USA Ouest, avec une région supplémentaire dans la région USA Centre.

Paramètres

-Capacity

Capacité de référence SKU du service Gestion des API Azure dans une région supplémentaire. La valeur par défaut est 1.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableGateway

Indicateur destiné uniquement à être utilisé pour les déploiements de service ApiManagement de référence SKU Premium et de réseaux virtuels non internes. Cela est utile dans le cas où nous voulons retirer une région de passerelle de la rotation. Cela peut également être utilisé pour standupiser une nouvelle région en mode passif, la tester, puis la rendre live ultérieurement. Le comportement par défaut consiste à rendre la région active immédiatement.

Type:Nullable<T>[Boolean]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Location

Spécifie l’emplacement de la nouvelle région de déploiement parmi la région prise en charge pour le service Gestion des API. Pour obtenir des emplacements valides, utilisez l’applet de commande Get-AzResourceProvider -ProviderNamespace « Microsoft.ApiManagement » | où {$_. ResourceTypes[0]. ResourceTypeName -eq « service"} | emplacements Select-Object

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublicIpAddressId

Référence SKU Standard PublicIpAddress ResoureId pour l’intégration aux déploiements de réseau virtuel stv2.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VirtualNetwork

Configuration de réseau virtuel de la région de déploiement gestion des API Azure. La valeur par défaut est $null.

Type:PsApiManagementVirtualNetwork
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Zone

Liste des zones de disponibilité indiquant où le service de gestion des API est déployé.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

PsApiManagementVirtualNetwork

Sorties

PsApiManagementRegion