你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Add-AzApiManagementRegion
将新的部署区域添加到 PsApiManagement 实例。
语法
Add-AzApiManagementRegion
-ApiManagement <PsApiManagement>
-Location <String>
[-Sku <PsApiManagementSku>]
[-Capacity <Int32>]
[-VirtualNetwork <PsApiManagementVirtualNetwork>]
[-Zone <String[]>]
[-DisableGateway <Boolean>]
[-PublicIpAddressId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 说明
示例
示例 1：向 PsApiManagement 实例添加新部署区域
Add-AzApiManagementRegion -ApiManagement $ApiManagement -Location "East US" -Sku "Premium" -Capacity 2此命令将两个高级 SKU 单元和名为“美国东部”的区域添加到 PsApiManagement 实例。
示例 2：将新的部署区域添加到 PsApiManagement 实例，然后更新部署
$service = Get-AzApiManagement -ResourceGroupName "Contoso" -Name "ContosoApi"
$service = Add-AzApiManagementRegion -ApiManagement $service -Location $secondarylocation -VirtualNetwork $additionalRegionVirtualNetwork
$service = Set-AzApiManagement -InputObject $service -PassThru此命令获取 PsApiManagement 对象，为名为“美国东部”的区域添加两个高级 SKU 单元，然后更新部署。
参数
-ApiManagement
指定此 cmdlet 将其他部署区域添加到的 PsApiManagement 实例。
| 类型: | PsApiManagement |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Capacity
指定部署区域的 SKU 容量。
| 类型: | Nullable<T>[Int32] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | 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 |
| 接受管道输入: | False |
| 接受通配符: | False |
-PublicIpAddressId
用于集成到 stv2 虚拟网络部署的标准 SKU PublicIpAddress ResoureId
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Sku
指定部署区域的层。 有效值为：
- 开发 人员
- 标准
- 奖赏
| 类型: | Nullable<T>[PsApiManagementSku] |
| 接受的值: | Developer, Standard, Premium, Basic, Consumption, Isolated |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VirtualNetwork
指定虚拟网络配置。
| 类型: | PsApiManagementVirtualNetwork |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Zone
表示将 API 管理服务部署到的位置的可用性区域列表。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
输入
输出
备注
- 该 cmdlet 将更新 PsApiManagement 实例写入管道。
