다음을 통해 공유

Set-AzureRmVirtualNetworkGateway

  • 참조
모듈:
AzureRM.Network

가상 네트워크 게이트웨이를 업데이트.

Warning

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

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

구문

Set-AzureRmVirtualNetworkGateway
   -VirtualNetworkGateway <PSVirtualNetworkGateway>
   [-GatewaySku <String>]
   [-GatewayDefaultSite <PSLocalNetworkGateway>]
   [-VpnClientAddressPool <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientProtocol <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientRootCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRootCertificate]>]
   [-VpnClientRevokedCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate]>]
   [-VpnClientIpsecPolicy <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSIpsecPolicy]>]
   [-Asn <UInt32>]
   [-PeerWeight <Int32>]
   [-EnableActiveActiveFeature]
   [-DisableActiveActiveFeature]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmVirtualNetworkGateway
   -VirtualNetworkGateway <PSVirtualNetworkGateway>
   [-GatewaySku <String>]
   [-GatewayDefaultSite <PSLocalNetworkGateway>]
   [-VpnClientAddressPool <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientProtocol <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientRootCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRootCertificate]>]
   [-VpnClientRevokedCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate]>]
   [-VpnClientIpsecPolicy <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSIpsecPolicy]>]
   [-Asn <UInt32>]
   [-PeerWeight <Int32>]
   [-EnableActiveActiveFeature]
   [-DisableActiveActiveFeature]
   -RadiusServerAddress <String>
   -RadiusServerSecret <SecureString>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzureRmVirtualNetworkGateway cmdlet은 가상 네트워크 게이트웨이를 업데이트합니다.

예제

예제 1: 목표 상태를 가상 네트워크 게이트웨이로 설정

PS C:\>$Gateway = Get-AzureRmVirtualNetworkGateway -ResourceGroupName "ResourceGroup001" -Name "Gateway001"
PS C:\> Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $Gateway -Asn 1337

첫 번째 명령은 리소스 그룹 ResourceGroup001에 속하는 Gateway01이라는 가상 네트워크 게이트웨이를 가져오고 $Gateway이라는 변수에 저장합니다. 두 번째 명령은 변수 $Gateway 저장된 가상 네트워크 게이트웨이의 목표 상태를 설정합니다. 또한 이 명령은 ASN을 1337로 설정합니다.

예제 2: 목표 상태를 가상 네트워크 게이트웨이로 설정

PS C:\>$Gateway = Get-AzureRmVirtualNetworkGateway -ResourceGroupName "ResourceGroup001" -Name "Gateway001"
PS C:\> $vpnclientipsecpolicy = New-AzureRmVpnClientIpsecPolicy -IpsecEncryption AES256 -IpsecIntegrity SHA256 -SALifeTimeSeconds 86472 -SADataSizeKilobytes 429497 -IkeEncryption AES256 -IkeIntegrity SHA256 -DhGroup DHGroup2 -PfsGroup None
PS C:\> $gateway = Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $Gateway -VpnClientIpsecPolicy $vpnclientipsecpolicy

첫 번째 명령은 리소스 그룹 ResourceGroup001에 속하는 Gateway01이라는 가상 네트워크 게이트웨이를 가져오고 $Gateway이라는 변수에 저장합니다. 두 번째 명령은 지정된 ipsec 매개 변수에 따라 Vpn ipsec 정책 개체를 만듭니다. 세 번째 명령은 변수 $Gateway 저장된 가상 네트워크 게이트웨이의 목표 상태를 설정합니다. 또한 이 명령은 가상 네트워크 게이트웨이의 $vpnclientipsecpolicy 개체에 지정된 사용자 지정 vpn ipsec 정책을 설정합니다.

매개 변수

-AsJob

백그라운드에서 cmdlet 실행

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

-Asn

IPsec 터널 내에서 BGP(Border Gateway Protocol) 세션을 설정하는 데 사용되는 가상 네트워크 게이트웨이 ASN(자치 시스템 번호)을 지정합니다.

형식:UInt32
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

-DisableActiveActiveFeature

활성-활성 기능을 사용하지 않도록 설정합니다.

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

-EnableActiveActiveFeature

활성-활성 기능을 사용하도록 설정합니다.

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

-GatewayDefaultSite

강제 터널링에 사용할 기본 사이트를 지정합니다. 기본 사이트를 지정하면 게이트웨이의 VPN(가상 사설망)에서 모든 인터넷 트래픽이 해당 사이트로 라우팅됩니다.

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

-GatewaySku

가상 네트워크 게이트웨이의 SKU(재고 유지 단위)를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • Basic
  • Standard
  • 고성능
  • VpnGw1
  • VpnGw2
  • VpnGw3
  • VpnGw1AZ
  • VpnGw2AZ
  • VpnGw3AZ
  • ErGw1AZ
  • ErGw2AZ
  • ErGw3AZ
형식:String
허용되는 값:Basic, Standard, HighPerformance, UltraPerformance, VpnGw1, VpnGw2, VpnGw3, VpnGw1AZ, VpnGw2AZ, VpnGw3AZ, ErGw1AZ, ErGw2AZ, ErGw3AZ
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PeerWeight

이 가상 네트워크 게이트웨이에서 BGP를 통해 학습된 경로에 추가된 가중치를 지정합니다.

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

-RadiusServerAddress

P2S 외부 반지름 서버 주소입니다.

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

-RadiusServerSecret

P2S 외부 반지름 서버 암호입니다.

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

-VirtualNetworkGateway

기본 수정을 해제할 가상 네트워크 게이트웨이 개체를 지정합니다. Get-AzureRmVirtualNetworkGateway cmdlet을 사용하여 가상 네트워크 게이트웨이 개체를 가져올 수 있습니다.

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

-VpnClientAddressPool

이 cmdlet이 VPN 클라이언트 IP 주소를 할당하는 데 사용하는 주소 공간을 지정합니다. 가상 네트워크 또는 온-프레미스 범위와 겹치지 않아야 합니다.

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

-VpnClientIpsecPolicy

P2S VPN 클라이언트 터널링 프로토콜에 대한 IPSec 정책 목록입니다.

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

-VpnClientProtocol

P2S VPN 클라이언트 터널링 프로토콜 목록

형식:List<T>[String]
허용되는 값:SSTP, IkeV2, OpenVPN
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-VpnClientRevokedCertificates

해지된 VPN 클라이언트 인증서 목록을 지정합니다. 이 중 하나와 일치하는 인증서를 표시하는 VPN 클라이언트가 제거됩니다.

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

-VpnClientRootCertificates

VPN 클라이언트 인증에 사용할 VPN 클라이언트 루트 인증서 목록을 지정합니다. 커넥트 VPN 클라이언트는 이러한 루트 인증서 중 하나에서 생성된 인증서를 제공해야 합니다.

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

-WhatIf

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

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

입력

PSVirtualNetworkGateway

매개 변수: VirtualNetworkGateway(ByValue)

String

PSLocalNetworkGateway

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSVpnClientRootCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSIpsecPolicy, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

UInt32

Int32

SecureString

출력

PSVirtualNetworkGateway

참고

  • 키워드: azure, azurerm, arm, 리소스, 관리, 관리자, 네트워크, 네트워킹