다음을 통해 공유

Add-AzApiManagementRegion

  • 참조
모듈:
Az.ApiManagement

PsApiManagement 인스턴스에 새 배포 지역을 추가합니다.

Syntax

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

Description

Add-AzApiManagementRegion cmdlet은 PsApiManagementRegion 형식의 새 인스턴스를 Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement 형식의 제공된 인스턴스의 AdditionalRegions 컬렉션에 추가합니다. 이 cmdlet은 단독으로 아무것도 배포하지 않고 메모리 내 PsApiManagement 인스턴스를 업데이트합니다. API Management 배포를 업데이트하려면 수정된 PsApiManagement 인스턴스를 Set-AzApiManagement로 전달합니다.

예제

예제 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 인스턴스를 지정합니다.

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

-Capacity

배포 지역의 SKU 용량을 지정합니다.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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 Management 서비스에 대해 지원되는 지역 간에 새 배포 지역의 위치를 지정합니다. 유효한 위치를 가져오려면 cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | 여기서 {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Select-Object 위치

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

-PublicIpAddressId

stv2 Virtual Network 배포에 통합하기 위한 표준 SKU PublicIpAddress ResoureId

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

-Sku

배포 지역의 계층을 지정합니다. 유효한 값은 다음과 같습니다.

  • Developer
  • 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

가상 네트워크 구성을 지정합니다.

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

-Zone

API Management 서비스가 배포되는 위치를 나타내는 가용성 영역 목록입니다.

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

입력

PsApiManagement

출력

PsApiManagement

참고

  • cmdlet은 업데이트 된 PsApiManagement 인스턴스를 파이프라인에 씁니다.