你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Update-AzApiManagementRegion

更新 PsApiManagement 实例中的现有部署区域。

语法

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

说明

Update-AzApiManagementRegion cmdlet 更新类型为 Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementRegion 的现有实例,该实例是Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement 的附加Regions 对象的集合 此 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 实例。

类型:PsApiManagement
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Capacity

指定部署区域的新 SKU 容量值。

类型:Int32
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DisableGateway

标志仅用于高级 SKU ApiManagement 服务和非内部 VNET 部署。 如果我们想要将网关区域从轮换中,这非常有用。 这还可用于在被动模式下建立新区域,对其进行测试,然后使其在以后上线。

类型:Nullable<T>[Boolean]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

指定要更新的部署区域的位置。 指定 Api 管理服务支持的区域中新部署区域的位置。 若要获取有效位置,请使用 cmdlet Get-AzResourceProvider -ProviderNamespace “Microsoft.ApiManagement” |where {$_.ResourceTypes[0]。ResourceTypeName -eq “service”} |Select-Object 位置

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PublicIpAddressId

标准 SKU PublicIpAddress ResoureId,用于集成到 stv2 虚拟网络 部署

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Sku

指定部署区域的新层值。 有效值为:

  • 开发人员
  • Standard
  • 高级
类型:PsApiManagementSku
接受的值:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-VirtualNetwork

指定部署区域的虚拟网络配置。 传递$null将删除区域的虚拟网络配置。

类型:PsApiManagementVirtualNetwork
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Zone

表示将 API 管理服务部署到的位置的可用性区域列表。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输入

PsApiManagement

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

输出

PsApiManagement