Set-AzRouteConfig

모듈:
Az.Network Module

경로 테이블에 대한 경로 구성을 업데이트합니다.

구문

Default (기본값) 

Set-AzRouteConfig
    -RouteTable <PSRouteTable>
    [-Name <String>]
    [-AddressPrefix <String>]
    [-NextHopType <String>]
    [-NextHopIpAddress <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Description

Set-AzRouteConfig cmdlet은 경로 테이블에 대한 경로 구성을 업데이트합니다.

예제

예제 1: 경로 수정

Get-AzRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Set-AzRouteConfig -Name "Route02" -AddressPrefix 10.4.0.0/16 -NextHopType VnetLocal | Set-AzRouteTable

Name              : Routetable01
ResourceGroupName : ResourceGroup11
Location          : eastus
Id                : /subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Microsoft.Networ
                    k/routeTables/RouteTable01
Etag              : W/"58c2922e-9efe-4554-a457-956ef44bc718"
ProvisioningState : Succeeded
Tags              :
Routes            : [
                      {
                        "Name": "Route07",
                        "Etag": "W/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/Routetable01/routes/Route07",
                        "AddressPrefix": "10.1.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": "Succeeded"
                      },
                      {
                        "Name": "route02",
                        "Etag": "W/\"58c2922e-9efe-4554-a457-956ef44bc718\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/routetable01/routes/route02",
                        "AddressPrefix": "10.4.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null,
                        "ProvisioningState": "Succeeded"
                      }
                    ]
Subnets           : []

이 명령은 Get-AzRouteTable cmdlet을 사용하여 RouteTable01이라는 경로 테이블을 가져옵니다. 이 명령은 파이프라인 연산자를 사용하여 해당 테이블을 현재 cmdlet에 전달합니다. 현재 cmdlet은 Route02라는 경로를 수정한 다음, Set-AzRouteTable cmdlet에 결과를 전달하여 변경 내용을 반영하도록 테이블을 업데이트합니다.

예제 2: 서비스 태그를 사용하여 경로 수정(공개 미리 보기)

Set-AzRouteConfig -Name "Route02" -AddressPrefix "AppService" -NextHopType "VirtualAppliance" -NextHopIpAddress "10.0.2.4"

이 명령은 Route02라는 경로를 수정하여 서비스 태그를 AddressPrefix 매개 변수로 제공합니다.

매개 변수

-AcquirePolicyToken

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-AddressPrefix

경로가 적용되는 대상을 CIDR(Classless Interdomain Routing) 형식으로 지정합니다. 여기에서 서비스 태그를 지정할 수도 있습니다(이 기능은 공개 미리 보기에 있음).

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-ChangeReference

이 리소스 작업에 대한 변경 참조 리소스 ID입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:Cf

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DefaultProfile

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

매개 변수 속성

형식:IAzureContextContainer
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

이 cmdlet이 수정하는 경로의 이름을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-NextHopIpAddress

이 경로가 패킷을 전달하는 다음 홉 IP 주소를 지정합니다. VirtualAppliance의 NextHopType의 경우 Azure 가상 네트워크에 추가하는 가상 어플라이언스의 단일 IP 주소를 제공합니다. VirtualApplianceEcmp의 NextHopType 의 경우 2~64개의 IP 주소를 제공하여 ECMP(동일 비용 다중 경로) 라우팅을 사용하여 트래픽 부하를 분산합니다.

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-NextHopType

이 경로가 패킷을 전달하는 방법을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 인터넷. Azure 제공하는 기본 인터넷 게이트웨이입니다.
  • None. 이 값을 지정하면 경로가 패킷을 전달하지 않습니다.
  • VirtualAppliance. Azure 가상 네트워크에 추가하는 가상 어플라이언스입니다.
  • VirtualApplianceEcmp. ECMP(동일 비용 다중 경로) 라우팅을 사용하여 트래픽이 부하 분산되는 여러 가상 어플라이언스입니다. NextHopIpAddress 매개 변수를 통해 어플라이언스 IP 주소를 제공합니다.
  • VirtualNetworkGateway. Azureserver-to-Server 가상 프라이빗 네트워크 게이트웨이.
  • VnetLocal. 로컬 가상 네트워크입니다. 동일한 가상 네트워크에 10.1.0.0/16 및 10.2.0.0/16 서브넷이 두 개 있는 경우 각 서브넷에 대해 다른 서브넷으로 전달할 VnetLocal 값을 선택합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-RouteTable

이 경로가 연결된 경로 테이블을 지정합니다.

매개 변수 속성

형식:PSRouteTable
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSRouteTable

String

출력

PSRouteTable