New-CMTSNetworkAdapterSetting

참조

모듈:: ConfigurationManager

네트워크 설정 적용 작업 순서 단계에서 네트워크 어댑터에 대한 설정 개체를 만듭니다.

구문

New-CMTSNetworkAdapterSetting
   [-Dns <String[]>]
   [-EnableDnsRegistration]
   [-EnableFullDnsRegistration]
   [-EnableIpProtocolFiltering]
   [-EnableLmHosts]
   [-EnableTcpFiltering]
   [-EnableUdpFiltering]
   [-Gateway <String[]>]
   [-IpAddress <Hashtable[]>]
   [-IpProtocolFilterList <String[]>]
   [-Metric <Int32>]
   -Name <String>
   [-TcpFilterPortList <Int32[]>]
   [-TcpIpNetbiosOption <NetbiosOption>]
   [-UdpFilterPortList <Int32[]>]
   [-Wins <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet은 네트워크 어댑터 설정 개체를 만듭니다. New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet의 AddAdapterSetting 매개 변수와 함께 이 개체를 사용합니다.

자세한 내용은 작업 순서 단계 정보: 네트워크 설정 적용을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 여러 주소가 있는 연결에 대한 네트워크 어댑터 설정 추가

이 예제에서는 먼저 여러 주소를 정의하는 세 개의 배열 변수를 정의합니다. $dns 변수는 두 개의 DNS 서버 주소가 있는 배열입니다. $gw 변수는 두 개의 게이트웨이 주소가 있는 배열입니다. $ip 변수는 두 개의 해시 테이블이 있는 배열입니다. 각 해시 테이블은 IP 주소 및 서브넷 마스크 쌍을 정의합니다.

예제의 다음 줄에서는 New-CMTSNetworkAdapterSetting cmdlet을 사용하여 네트워크 어댑터 설정 개체를 만듭니다. 정의된 변수를 사용하고 다른 여러 옵션을 설정합니다.

이 예제의 마지막 부분에서는 기본 OS 배포라는 작업 순서의 기존 네트워크 설정 적용 단계를 구성합니다. 네트워크 어댑터 설정을 단계에 추가하고 DNS 접미사를 구성합니다.

$dns = @("192.168.1.100","10.0.1.100")
$gw = @("192.168.1.1","10.0.1.1")

$ip = @(
    @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; },
    @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; }
)

$conn1 = New-CMTSNetworkAdapterSetting -Name "local connection" -Dns $dns -EnableDnsRegistration -EnableFullDnsRegistration -Gateway $gw -IpAddress $ip -TcpIpNetbiosOption DisableNetbiosOverTcpip

$tsNameOsd = "Default OS deployment"
$tsStepNameApplyNetSet = "Apply Network Settings"

Set-CMTSStepApplyNetworkSetting -TaskSequenceName $tsNameOsd -StepName $tsStepNameApplyNetSet -AddAdapterSetting $conn1 -DnsSuffix "corp.contoso.com"

매개 변수

-Confirm

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

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

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

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

-Dns

사용 순서대로 하나 이상의 DNS 서버 주소를 지정합니다.

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

-EnableDnsRegistration

이 매개 변수를 추가하여 DNS에 이 연결의 주소를 등록합니다. 이 설정은 TCP/IP를 사용하도록 설정된 모든 연결에 적용됩니다. DNS 접미사를 지정하려면 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 DnsSuffix 매개 변수를 사용합니다.

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

-EnableFullDnsRegistration

DNS 등록에서 연결의 DNS 접미사를 사용하려면 이 매개 변수를 추가합니다. 이 설정은 TCP/IP를 사용하도록 설정된 모든 연결에 적용됩니다. DNS 접미사를 지정하려면 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 DnsSuffix 매개 변수를 사용합니다.

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

-EnableIpProtocolFiltering

이 매개 변수를 추가하여 일부 IP 프로토콜을 필터링합니다. TCP/IP 필터링을 사용하도록 설정하려면 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 EnableTcpIpFiltering 매개 변수를 사용합니다.

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

-EnableLmHosts

이 매개 변수를 추가하여 LMHOSTS 조회를 사용하도록 설정합니다.

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

-EnableTcpFiltering

이 매개 변수를 추가하여 일부 TCP 포트를 필터링합니다. TCP/IP 필터링을 사용하도록 설정하려면 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 EnableTcpIpFiltering 매개 변수를 사용합니다.

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

-EnableUdpFiltering

이 매개 변수를 추가하여 일부 UDP 포트를 필터링합니다. TCP/IP 필터링을 사용하도록 설정하려면 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 EnableTcpIpFiltering 매개 변수를 사용합니다.

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

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

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

-Gateway

이 연결에서 DHCP를 사용하지 않는 경우 이 매개 변수를 사용하여 하나 이상의 게이트웨이 주소를 지정합니다.

필요한 경우 메트릭 매개 변수를 사용합니다. 기본적으로 게이트웨이는 자동 메트릭을 사용합니다.

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

-IpAddress

이 연결에서 DHCP를 사용하지 않는 경우 이 매개 변수를 사용하여 하나 이상의 IP 주소와 해당 서브넷 마스크를 지정합니다. 값은 해시 테이블입니다. 첫 번째 값은 이 IP 고 두 번째 값은 입니다 Mask.

예: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }

둘 이상의 IP 주소와 서브넷 마스크 조합을 지정해야 하는 경우 해시 테이블 배열을 사용합니다.

예: @( @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }, @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; } )

형식:	Hashtable[]
별칭:	NetworkSettingIpAddress, NetworkSettingIpAddresses
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IpProtocolFilterList

EnableIpProtocolFiltering 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 하나 이상의 IP 프로토콜을 지정합니다.

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

-Metric

게이트웨이 사용 비용을 나타내는 메트릭을 지정 합니다. 이 매개 변수를 지정하지 않으면 게이트웨이는 자동 메트릭을 사용합니다.

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

-Name

이 연결의 고유한 이름을 지정합니다.

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

-TcpFilterPortList

EnableTcpFiltering 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 하나 이상의 TCP 포트를 지정합니다.

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

-TcpIpNetbiosOption

TCP/IP를 통해 NetBIOS를 사용하거나 사용하지 않도록 설정할지 여부를 지정합니다.

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

-UdpFilterPortList

EnableUdpFiltering 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 하나 이상의 UDP 포트를 지정합니다.

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

-WhatIf

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

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

-Wins

하나 이상의 WINS 서버 주소를 지정합니다.

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

입력

None

출력

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_TaskSequence_NetworkAdapterSettings 서버 WMI 클래스를 참조하세요.

다음을 통해 공유

New-CMTSNetworkAdapterSetting

구문

Description

예제

예제 1: 여러 주소가 있는 연결에 대한 네트워크 어댑터 설정 추가

매개 변수

-Confirm

-DisableWildcardHandling

-Dns

-EnableDnsRegistration

-EnableFullDnsRegistration

-EnableIpProtocolFiltering

-EnableLmHosts

-EnableTcpFiltering

-EnableUdpFiltering

-ForceWildcardHandling

-Gateway

-IpAddress

-IpProtocolFilterList

-Metric

-Name

-TcpFilterPortList

-TcpIpNetbiosOption

-UdpFilterPortList

-WhatIf

-Wins

입력

출력

참고

피드백

추가 리소스

다음을 통해 공유

New-CMTSNetworkAdapterSetting

구문

Description

예제

예제 1: 여러 주소가 있는 연결에 대한 네트워크 어댑터 설정 추가

매개 변수

-Confirm

-DisableWildcardHandling

-Dns

-EnableDnsRegistration

-EnableFullDnsRegistration

-EnableIpProtocolFiltering

-EnableLmHosts

-EnableTcpFiltering

-EnableUdpFiltering

-ForceWildcardHandling

-Gateway

-IpAddress

-IpProtocolFilterList

-Metric

-Name

-TcpFilterPortList

-TcpIpNetbiosOption

-UdpFilterPortList

-WhatIf

-Wins

입력

출력

참고

관련 링크

피드백

추가 리소스