Update-AzApiManagementRegion
更新 PsApiManagement 實例中現有的部署區域。
Syntax
Update-AzApiManagementRegion
-ApiManagement <PsApiManagement>
-Location <String>
-Sku <string>
-Capacity <Int32>
[-VirtualNetwork <PsApiManagementVirtualNetwork>]
[-Zone <String[]>]
[-DisableGateway <Boolean>]
[-PublicIpAddressId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Update-AzApiManagementRegion Cmdlet 會在 Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion 集合中更新 Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement 類型的 AdditionalRegions 物件集合中現有的實例。 此 Cmdlet 不會部署任何專案，但會更新記憶體中的 PsApiManagement 實例。 若要更新部署 API 管理 使用修改過的 PsApiManagementInstance 至 Set-AzApiManagement Cmdlet。
範例
範例 1：增加 PsApiManagement 實例中其他區域的容量
$apimService = Get-AzApiManagement -ResourceGroupName $resourceGroupName -Name $apiManagementName
$apimService = Update-AzApiManagementRegion -ApiManagement $apimService -Location "North Central US" -Capacity 2 -Sku Premium
$apimService = Set-AzApiManagement -InputObject $apimService -PassThru此命令會取得 API 管理 進階版 SKU 服務，其區域位於美國中南部和美國中北部。 然後，它會使用 Set-AzApiManagement 將美國中北部區域的容量增加到 2。 下一個 Cmdlet Set-AzApiManagement 會將設定變更套用至 Api 管理服務。
範例 2
更新 PsApiManagement 實例中現有的部署區域。 （ 自動產生 ）
Update-AzApiManagementRegion -ApiManagement <PsApiManagement> -Capacity 2 -Location 'North Central US' -Sku Developer -VirtualNetwork <PsApiManagementVirtualNetwork>參數
-ApiManagement
指定要 更新中現有部署區域的 PsApiManagement 實例。
| Type: | PsApiManagement |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Capacity
指定部署區域的新 SKU 容量值。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableGateway
旗標僅供 進階版 SKU ApiManagement 服務和非內部 VNET 部署使用。 如果我們想要將閘道區域從輪替中取出，這非常有用。 這也可以用來在被動模式中支援新區域、測試它，然後稍後讓它上線。
| Type: | Nullable<T>[Boolean] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
指定要更新之部署區域的位置。 指定 Api 管理服務所支援區域之間的新部署區域位置。 若要取得有效的位置，請使用 Cmdlet Get-AzResourceProvider -ProviderNamespace “Microsoft.ApiManagement” |其中 {$_.ResourceTypes[0]。ResourceTypeName -eq “service”} |Select-Object Locations
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublicIpAddressId
標準 SKU PublicIpAddress ResoureId 以整合至 stv2 虛擬網絡 部署
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Sku
指定部署區域的新層值。 有效值為：
- 開發人員
- Standard
- Premium
| Type: | PsApiManagementSku |
| Accepted values: | Developer, Standard, Premium, Basic, Consumption, Isolated |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VirtualNetwork
指定部署區域的虛擬網路組態。 傳遞$null將會移除區域的虛擬網路組態。
| Type: | PsApiManagementVirtualNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Zone
可用性區域清單，表示 API 管理服務部署至何處。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |