Add-AzApiManagementRegion

  • Referenz
Modul:
Az.ApiManagement

Fügt einer PsApiManagement-Instanz neue Bereitstellungsregionen hinzu.

Syntax

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

Beschreibung

Mit dem Cmdlet "Add-AzApiManagementRegion" wird der Auflistung der bereitgestellten Instanz vom Typ "Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement" eine neue Instanz vom Typ "PsApiManagementRegion" hinzugefügt. Dieses Cmdlet stellt nichts selbst bereit, sondern aktualisiert die Instanz von PsApiManagement im Arbeitsspeicher. Um eine Bereitstellung einer API-Verwaltung zu aktualisieren, übergeben Sie die geänderte PsApiManagement-Instanz an Set-AzApiManagement.

Beispiele

Beispiel 1: Hinzufügen neuer Bereitstellungsregionen zu einer PsApiManagement-Instanz

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

Mit diesem Befehl werden der PsApiManagement-Instanz zwei Premium-SKU-Einheiten und die Region "East US" hinzugefügt.

Beispiel 2: Hinzufügen neuer Bereitstellungsregionen zu einer PsApiManagement-Instanz und anschließendes Aktualisieren der Bereitstellung

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

Dieser Befehl ruft ein PsApiManagement -Objekt ab, fügt zwei Premium-SKU-Einheiten für die Region namens East US hinzu und aktualisiert dann die Bereitstellung.

Parameter

-ApiManagement

Gibt die PsApiManagement-Instanz an, der dieses Cmdlet zusätzliche Bereitstellungsregionen hinzufügt.

Type:PsApiManagement
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Capacity

Gibt die SKU-Kapazität der Bereitstellungsregion an.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableGateway

Das Flag sollte nur für Premium-SKU-ApiManagement-Dienst und nicht interne VNET-Bereitstellungen verwendet werden. Dies ist nützlich, wenn wir einen Gatewaybereich aus der Drehung herausnehmen möchten. Dies kann auch verwendet werden, um eine neue Region im passiven Modus zu standupieren, zu testen und es später live zu machen. Das Standardverhalten besteht darin, die Region sofort zu liveieren.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Gibt den Standort der neuen Bereitstellungsregion unter der unterstützten Region für den API-Verwaltungsdienst an. Verwenden Sie zum Abrufen gültiger Speicherorte das Cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | dabei {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Speicherorte für Select-Object

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddressId

Standard-SKU PublicIpAddress ResoureId für die Integration in stv2 Virtual Network Deployments

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

Gibt die Ebene der Bereitstellungsregion an. Gültige Werte sind:

  • Entwickler
  • Standard
  • Premium
Type:Nullable<T>[PsApiManagementSku]
Accepted values:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

Gibt eine Virtuelle Netzwerkkonfiguration an.

Type:PsApiManagementVirtualNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Eine Liste der Verfügbarkeitszonen, in denen der API-Verwaltungsdienst bereitgestellt wird.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

PsApiManagement

Ausgaben

PsApiManagement

Hinweise

  • Das Cmdlet schreibt aktualisierte PsApiManagement-Instanz in die Pipeline.