다음을 통해 공유


Update-AzApiManagementRegion

PsApiManagement 인스턴스의 기존 배포 지역을 업데이트합니다.

구문

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 형식의 제공된 인스턴스에 대한 AdditionalRegions 개체 컬렉션에서 Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagement 형식의 기존 인스턴스를 업데이트합니다. 이 cmdlet은 PsApiManagement 메모리 내 인스턴스를 업데이트하는 것 외에는 아무것도 배포하지 않습니다. API Management 배포를 업데이트하려면 수정된 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 Management Premium SKU 서비스를 가져옵니다. 그런 다음 Set-AzApiManagement를 사용하여 미국 중북부 지역의 용량을 2로 늘입니다. 다음 cmdlet Set-AzApiManagement 는 구성 변경 사항을 Api Management 서비스에 적용합니다.

예제 2

PsApiManagement 인스턴스의 기존 배포 지역을 업데이트합니다. (자동 생성됨)

Update-AzApiManagementRegion -ApiManagement <PsApiManagement> -Capacity 2 -Location 'North Central US' -Sku Developer -VirtualNetwork <PsApiManagementVirtualNetwork>

매개 변수

-ApiManagement

기존 배포 지역을 업데이트할 PsApiManagement 인스턴스를 지정합니다.

형식:PsApiManagement
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Capacity

배포 지역에 대한 새 SKU 용량 값을 지정합니다.

형식:Int32
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableGateway

플래그는 프리미엄 SKU ApiManagement 서비스 및 비 내부 VNET 배포에만 사용됩니다. 이 기능은 게이트웨이 영역을 순환에서 제외하려는 경우에 유용합니다. 수동 모드에서 새 지역을 스탠드업하고 테스트한 다음 나중에 라이브로 만드는 데도 사용할 수 있습니다.

형식:Nullable<T>[Boolean]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Location

업데이트할 배포 지역의 위치를 지정합니다. Api Management 서비스에 대해 지원되는 지역 간에 새 배포 지역의 위치를 지정합니다. 유효한 위치를 가져오려면 cmdlet Get-AzResourceProvider -ProviderNamespace "Microsoft.ApiManagement" | 여기서 {$_. ResourceTypes[0]. ResourceTypeName -eq "service"} | Select-Object 위치

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PublicIpAddressId

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Sku

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

  • Developer
  • Standard
  • Premium
형식:PsApiManagementSku
허용되는 값:Developer, Standard, Premium, Basic, Consumption, Isolated
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-VirtualNetwork

배포 지역에 대한 가상 네트워크 구성을 지정합니다. $null 전달하면 지역에 대한 가상 네트워크 구성이 제거됩니다.

형식:PsApiManagementVirtualNetwork
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Zone

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

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

PsApiManagement

String

PsApiManagementSku

Int32

PsApiManagementVirtualNetwork

출력

PsApiManagement