다음을 통해 공유

Set-AzNetworkInterfaceIpConfig

  • 참조
모듈:
Az.Network

네트워크 인터페이스에 대한 IP 구성을 업데이트합니다.

구문

Set-AzNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
   [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
   [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
   [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <String[]>]
   [-LoadBalancerInboundNatRuleId <String[]>]
   [-ApplicationGatewayBackendAddressPoolId <String[]>]
   [-ApplicationSecurityGroupId <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzNetworkInterfaceIpConfig cmdlet은 네트워크 인터페이스에 대한 IP 구성을 업데이트합니다.

예제

예제 1: IP 구성의 IP 주소 변경

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -Primary

$nic | Set-AzNetworkInterface

처음 두 명령은 myvnet이라는 가상 네트워크와 mysubnet이라는 서브넷을 가져와 각각 변수 $vnet 및 $subnet 저장합니다. 세 번째 명령은 업데이트해야 하는 IP 구성과 연결된 네트워크 인터페이스 nic1을 가져옵니다. 세 번째 명령은 기본 IP 구성 ipconfig1의 개인 IP 주소를 10.0.0.11로 설정합니다. 마지막으로 마지막 명령은 네트워크 인터페이스를 업데이트하여 변경이 성공적으로 이루어졌는지 확인합니다.

예제 2: IP 구성을 애플리케이션 보안 그룹과 연결

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-AzApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg -Primary

$nic | Set-AzNetworkInterface

이 예제에서 변수 $asg 애플리케이션 보안 그룹에 대한 참조를 포함합니다. 네 번째 명령은 업데이트해야 하는 IP 구성과 연결된 네트워크 인터페이스 nic1을 가져옵니다. Set-AzNetworkInterfaceIpConfig는 기본 IP 구성 ipconfig1의 개인 IP 주소를 10.0.0.11로 설정하고 검색된 애플리케이션 보안 그룹과 연결을 만듭니다. 마지막으로 마지막 명령은 네트워크 인터페이스를 업데이트하여 변경이 성공적으로 이루어졌는지 확인합니다.

예제 3: 애플리케이션 게이트웨이 백 엔드 주소 풀을 사용하여 IP 구성 연결 해제

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -ApplicationGatewayBackendAddressPool $null

$nic | Set-AzNetworkInterface

Set-AzNetworkInterfaceIpConfig는 IP 구성 ipconfig1의 애플리케이션 게이트웨이 백 엔드 주소 풀을 null로 설정하고 네트워크 인터페이스와 연결 해제합니다. 마지막으로 마지막 명령은 네트워크 인터페이스를 업데이트하여 변경이 성공적으로 이루어졌는지 확인합니다.

매개 변수

-ApplicationGatewayBackendAddressPool

이 네트워크 인터페이스 IP 구성이 속한 애플리케이션 게이트웨이 백 엔드 주소 풀 참조의 컬렉션을 지정합니다.

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

-ApplicationGatewayBackendAddressPoolId

이 네트워크 인터페이스 IP 구성이 속한 애플리케이션 게이트웨이 백 엔드 주소 풀 참조의 컬렉션을 지정합니다.

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

-ApplicationSecurityGroup

이 네트워크 인터페이스 IP 구성이 속한 애플리케이션 보안 그룹 참조의 컬렉션을 지정합니다.

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

-ApplicationSecurityGroupId

이 네트워크 인터페이스 IP 구성이 속한 애플리케이션 보안 그룹 참조의 컬렉션을 지정합니다.

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

-DefaultProfile

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

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

-GatewayLoadBalancerId

게이트웨이 부하 분산 장치 공급자 프런트 엔드 IP 구성의 ID를 지정합니다.

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

-LoadBalancerBackendAddressPool

이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 백 엔드 주소 풀 참조의 컬렉션을 지정합니다.

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

-LoadBalancerBackendAddressPoolId

이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 백 엔드 주소 풀 참조의 컬렉션을 지정합니다.

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

-LoadBalancerInboundNatRule

이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 NAT(네트워크 주소 변환) 규칙 참조의 컬렉션을 지정합니다.

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

-LoadBalancerInboundNatRuleId

이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 인바운드 NAT 규칙 참조의 컬렉션을 지정합니다.

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

-Name

이 cmdlet이 설정하는 네트워크 IP 구성의 이름을 지정합니다.

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

-NetworkInterface

NetworkInterface 개체를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 개체에 네트워크 인터페이스 IP 구성을 추가합니다.

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

-Primary

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

-PrivateIpAddress

네트워크 인터페이스 IP 구성의 고정 IP 주소를 지정합니다.

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

-PrivateIpAddressVersion

네트워크 인터페이스 IP 구성의 IP 주소 버전을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • IPv4
  • IPv6
형식:String
허용되는 값:IPv4, IPv6
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PublicIpAddress

PublicIPAddress 개체를 지정합니다. 이 cmdlet은 이 네트워크 인터페이스 IP 구성과 연결할 공용 IP 주소에 대한 참조를 만듭니다.

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

-PublicIpAddressId

이 cmdlet은 이 네트워크 인터페이스 IP 구성과 연결할 공용 IP 주소에 대한 참조를 만듭니다.

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

-Subnet

서브넷 개체를 지정합니다. 이 cmdlet은 이 네트워크 인터페이스 IP 구성이 만들어진 서브넷에 대한 참조를 만듭니다.

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

-SubnetId

이 cmdlet은 이 네트워크 인터페이스 IP 구성이 만들어진 서브넷에 대한 참조를 만듭니다.

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

입력

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

출력

PSNetworkInterface

참고

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