다음을 통해 공유


Add-AzureRmRouteConfig

경로 테이블에 경로를 추가합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

Add-AzureRmRouteConfig
   -RouteTable <PSRouteTable>
   [-Name <String>]
   [-AddressPrefix <String>]
   [-NextHopType <String>]
   [-NextHopIpAddress <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Add-AzureRmRouteConfig cmdlet은 Azure 경로 테이블에 경로를 추가합니다.

예제

예제 1: 경로 테이블에 경로 추가

PS C:\>$RouteTable = Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01"
PS C:\> Add-AzureRmRouteConfig -Name "Route13" -AddressPrefix 10.3.0.0/16 -NextHopType "VnetLocal" -RouteTable $RouteTable

첫 번째 명령은 Get-AzureRmRouteTable cmdlet을 사용하여 RouteTable01이라는 경로 테이블을 가져옵니다. 이 명령은 테이블을 $RouteTable 변수에 저장합니다. 두 번째 명령은 Route13이라는 경로를 $RouteTable 저장된 경로 테이블에 추가합니다. 이 경로는 패킷을 로컬 가상 네트워크로 전달합니다.

예제 2: 파이프라인을 사용하여 경로 테이블에 경로 추가

PS C:\>Get-AzureRmRouteTable -ResourceGroupName "ResourceGroup11" -Name "RouteTable01" | Add-AzureRmRouteConfig -Name "Route02" -AddressPrefix 10.2.0.0/16 -NextHopType VnetLocal | Set-AzureRmRouteTable
Name              : routetable01
ResourceGroupName : ResourceGroup11
Location          : eastus
Id                : /subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Microsoft.Networ
                    k/routeTables/routetable01
Etag              : W/"f13e1bc8-d41f-44d0-882d-b8b5a1134f59"
ProvisioningState : Succeeded
Tags              : 
Routes            : [
                      {
                        "Name": "route07",
                        "Etag": "W/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
                        "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/\"f13e1bc8-d41f-44d0-882d-b8b5a1134f59\"",
                        "Id": "/subscriptions/xxxx-xxxx-xxxx-xxxx/resourceGroups/ResourceGroup11/providers/Micro
                    soft.Network/routeTables/routetable01/routes/route02",
                        "AddressPrefix": "10.2.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null, 
                        "ProvisioningState": "Succeeded"
                      },
                      {
                        "Name": "route13",
                        "Etag": null, 
                        "Id": null, 
                        "AddressPrefix": "10.3.0.0/16",
                        "NextHopType": "VnetLocal",
                        "NextHopIpAddress": null, 
                        "ProvisioningState": null
                      }
                    ] 
Subnets           : []

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

매개 변수

-AddressPrefix

경로가 적용되는 대상을 CIDR(CIDR(Classless Interdomain Routing)) 형식으로 지정합니다.

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

-Confirm

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

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

-DefaultProfile

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

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

-Name

경로 테이블에 추가할 경로의 이름을 지정합니다.

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

-NextHopIpAddress

Azure 가상 네트워크에 추가하는 가상 어플라이언스 IP 주소를 지정합니다. 이 경로는 패킷을 해당 주소로 전달합니다. NextHopType 매개 변수에 대한 VirtualAppliance 값을 지정하는 경우에만 이 매개 변수를 지정합니다.

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

-NextHopType

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

  • Internet. Azure에서 제공하는 기본 인터넷 게이트웨이입니다.
  • 없음 이 값을 지정하면 경로가 패킷을 전달하지 않습니다.
  • VirtualAppliance. Azure 가상 네트워크에 추가하는 가상 어플라이언스.
  • VirtualNetworkGateway. Azure 서버-서버 가상 사설망 게이트웨이.
  • VnetLocal. 로컬 가상 네트워크입니다. 동일한 가상 네트워크에 10.1.0.0/16 및 10.2.0.0/16 서브넷이 두 개 있는 경우 각 서브넷에 대해 다른 서브넷으로 전달할 VnetLocal 값을 선택합니다.
형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-RouteTable

이 cmdlet이 경로를 추가하는 경로 테이블을 지정합니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

PSRouteTable

String

출력

PSRouteTable