Add-AzApiManagementRegion
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.
Typ: | PsApiManagement |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Capacity
Gibt die SKU-Kapazität der Bereitstellungsregion an.
Typ: | Nullable<T>[Int32] |
Position: | Named |
Standardwert: | None |
Erforderlich: | 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.
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | 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.
Typ: | Nullable<T>[Boolean] |
Position: | Named |
Standardwert: | None |
Erforderlich: | 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
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicIpAddressId
Standard-SKU PublicIpAddress ResoureId für die Integration in stv2 Virtual Network Deployments
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Sku
Gibt die Ebene der Bereitstellungsregion an. Gültige Werte sind:
- Entwickler
- Standard
- Premium
Typ: | Nullable<T>[PsApiManagementSku] |
Zulässige Werte: | Developer, Standard, Premium, Basic, Consumption, Isolated |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualNetwork
Gibt eine Virtuelle Netzwerkkonfiguration an.
Typ: | PsApiManagementVirtualNetwork |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Zone
Eine Liste der Verfügbarkeitszonen, in denen der API-Verwaltungsdienst bereitgestellt wird.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
Ausgaben
Hinweise
- Das Cmdlet schreibt aktualisierte PsApiManagement-Instanz in die Pipeline.
Ähnliche Themen
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für