Set-AzureRmNetworkInterfaceIpConfig
Azure 네트워크 인터페이스 IP 구성의 목표 상태를 설정합니다.
Warning
AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.
AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 기본 또는 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.
구문
Set-AzureRmNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-Subnet <PSSubnet>]
[-PublicIpAddress <PSPublicIpAddress>]
[-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
[-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
[-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
[-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzureRmNetworkInterfaceIpConfig
-Name <String>
-NetworkInterface <PSNetworkInterface>
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-SubnetId <String>]
[-PublicIpAddressId <String>]
[-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
[-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
[-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
[-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Set-AzureRmNetworkInterfaceIpConfig cmdlet은 Azure 네트워크 인터페이스 IP 구성에 대한 목표 상태를 설정합니다.
예제
1: IP 구성의 IP 주소 변경
$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet
-Primary
$nic | Set-AzureRmNetworkInterface처음 두 명령은 myvnet이라는 가상 네트워크와 mysubnet이라는 서브넷을 가져와 각각 변수 $vnet 및 $subnet 저장합니다. 세 번째 명령은 업데이트해야 하는 IP 구성과 연결된 네트워크 인터페이스 nic1을 가져옵니다. 세 번째 명령은 기본 IP 구성 ipconfig1의 개인 IP 주소를 10.0.0.11로 설정합니다. 마지막으로 마지막 명령은 네트워크 인터페이스를 업데이트하여 변경이 성공적으로 이루어졌는지 확인합니다.
2: IP 구성을 애플리케이션 보안 그룹과 연결
$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-ApplicationSecurityGroup -Name myasg -ResourceGroupName myrg
$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg
$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg
-Primary
$nic | Set-AzureRmNetworkInterface이 예제에서 변수 $asg 애플리케이션 보안 그룹에 대한 참조를 포함합니다. 네 번째 명령은 업데이트해야 하는 IP 구성과 연결된 네트워크 인터페이스 nic1을 가져옵니다. Set-AzureRmNetworkInterfaceIpConfig는 기본 IP 구성 ipconfig1의 개인 IP 주소를 10.0.0.11로 설정하고 검색된 애플리케이션 보안 그룹과 연결을 만듭니다. 마지막으로 마지막 명령은 네트워크 인터페이스를 업데이트하여 변경이 성공적으로 이루어졌는지 확인합니다.
매개 변수
-ApplicationGatewayBackendAddressPool
이 네트워크 인터페이스 IP 구성이 속한 애플리케이션 게이트웨이 백 엔드 주소 풀 참조의 컬렉션을 지정합니다.
| 형식: | List<T>[PSApplicationGatewayBackendAddressPool] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ApplicationGatewayBackendAddressPoolId
이 네트워크 인터페이스 IP 구성이 속한 애플리케이션 게이트웨이 백 엔드 주소 풀 참조의 컬렉션을 지정합니다.
| 형식: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ApplicationSecurityGroup
이 네트워크 인터페이스 IP 구성이 속한 애플리케이션 보안 그룹 참조의 컬렉션을 지정합니다.
| 형식: | List<T>[PSApplicationSecurityGroup] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ApplicationSecurityGroupId
이 네트워크 인터페이스 IP 구성이 속한 애플리케이션 보안 그룹 참조의 컬렉션을 지정합니다.
| 형식: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
| 형식: | IAzureContextContainer |
| 별칭: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-LoadBalancerBackendAddressPool
이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 백 엔드 주소 풀 참조의 컬렉션을 지정합니다.
| 형식: | List<T>[PSBackendAddressPool] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-LoadBalancerBackendAddressPoolId
이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 백 엔드 주소 풀 참조의 컬렉션을 지정합니다.
| 형식: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-LoadBalancerInboundNatRule
이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 NAT(네트워크 주소 변환) 규칙 참조의 컬렉션을 지정합니다.
| 형식: | List<T>[PSInboundNatRule] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-LoadBalancerInboundNatRuleId
이 네트워크 인터페이스 IP 구성이 속한 부하 분산 장치 인바운드 NAT 규칙 참조의 컬렉션을 지정합니다.
| 형식: | List<T>[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 |
입력
매개 변수: NetworkInterface(ByValue)
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]
출력
참고
- 키워드: azure, azurerm, arm, 리소스, 관리, 관리자, 네트워크, 네트워킹