New-CMTSNetworkAdapterSetting
네트워크 어댑터 적용 작업 순서 단계에서 네트워크 어댑터에 설정 개체를 만듭니다.
Syntax
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을 사용하여 네트워크 어댑터 설정 개체를 만듭니다. 정의된 변수를 사용하며 다른 여러 옵션을 설정합니다.
이 예제의 마지막 부분에서는 Default OS 배포라는 작업 설정 기존 Apply Network 설정 단계를 구성합니다. 이 단계에서는 네트워크 어댑터 설정을 추가하고 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을 실행하기 전에 확인 메시지를 표시합니다.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과결합할 수 있습니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Dns
하나 이상의 DNS 서버 주소를 사용 순서대로 지정합니다.
Type: | String[] |
Aliases: | DNSServerAddress, DNSServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableDnsRegistration
이 매개 변수를 추가하여 DNS에 이 연결의 주소를 등록합니다. 이 설정은 TCP/IP를 사용하는 모든 연결에 적용됩니다. DNS 접미어를 지정하기 위해 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 DnsSuffix 매개 변수를 사용합니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableFullDnsRegistration
DNS 등록에서 연결의 DNS 접미어를 사용 하 고이 매개 변수를 추가 합니다. 이 설정은 TCP/IP를 사용하는 모든 연결에 적용됩니다. DNS 접미어를 지정하기 위해 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 DnsSuffix 매개 변수를 사용합니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableIpProtocolFiltering
이 매개 변수를 추가하여 일부 IP 프로토콜을 필터링합니다. TCP/IP 필터링을 사용하도록 설정하려면 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 EnableTcpIpFiltering 매개 변수를 사용합니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableLmHosts
LMHOSTS Lookup을 사용하도록 설정하려면 이 매개 변수를 추가합니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableTcpFiltering
일부 TCP 포트를 필터링하기 위해 이 매개 변수를 추가합니다. TCP/IP 필터링을 사용하도록 설정하려면 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 EnableTcpIpFiltering 매개 변수를 사용합니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableUdpFiltering
이 매개 변수를 추가하여 일부 UDP 포트를 필터링합니다. TCP/IP 필터링을 사용하도록 설정하려면 New-CMTSStepApplyNetworkSetting 또는 Set-CMTSStepApplyNetworkSetting cmdlet에서 EnableTcpIpFiltering 매개 변수를 사용합니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하며 예기치 않은 동작이 발생할 수 있습니다(권장하지 않음). DisableWildcardHandling과결합할 수 없습니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Gateway
이 연결에서 DHCP를 사용하지 않는 경우 이 매개 변수를 사용하여 하나 이상의 게이트웨이 주소를 지정합니다.
필요한 경우 Metric 매개 변수를 사용합니다. 기본적으로 게이트웨이는 자동 메트릭을 사용 합니다.
Type: | String[] |
Aliases: | GatewayIpAddress, GatewayIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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"; } )
Type: | Hashtable[] |
Aliases: | NetworkSettingIpAddress, NetworkSettingIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpProtocolFilterList
EnableIpProtocolFiltering 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 하나 이상의 IP 프로토콜을 지정합니다.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metric
게이트웨이를 사용하는 비용을 나타내는 메트릭을 지정합니다. 이 매개 변수를 지정하지 않으면 게이트웨이에서 자동 메트릭을 사용합니다.
Type: | Int32 |
Aliases: | GatewayCostMetric |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
이 연결의 고유한 이름을 지정합니다.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpFilterPortList
EnableTcpFiltering 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 하나 이상의 TCP 포트를 지정합니다.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpIpNetbiosOption
TCP/IP를 통해 NetBIOS를 사용할지 여부를 지정합니다.
Type: | NetbiosOption |
Accepted values: | Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UdpFilterPortList
EnableUdpFiltering 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 하나 이상의 UDP 포트를 지정합니다.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. 이 cmdlet은 실행되지 않습니다.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wins
하나 이상의 WINS 서버 주소를 지정합니다.
Type: | String[] |
Aliases: | WinsServerAddress, WinsServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
입력
없음
출력
IResultObject
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_TaskSequence_NetworkAdapterSettings 서버 WMI 클래스를 참조하세요.