New-CMTSNetworkAdapterSetting
在 [套用網路設定任務順序] 步驟中，為網路介面卡建立 settings 物件。
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 會建立網路介面卡設定物件。 使用此物件搭配CMTSStepApplyNetworkSetting或Set-CMTSStepApplyNetworkSetting Cmdlet 上的AddAdapterSetting參數。
如需詳細資訊，請參閱關於任務順序的步驟：套用網路設定。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。
範例
範例1：新增多個位址的網路介面卡設定
這個範例會先定義三個數組變數，以定義多個位址。 $Dns變數是具有兩個 dns 伺服器位址的陣列。 $Gw變數是具有兩個閘道位址的陣列。 $Ip變數是具有兩個 hashtables 的陣列。 每個雜湊表都定義 IP 位址及子網路遮罩對。
範例的下一行使用 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 之前提示您確認。
| 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 尾碼，請在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 尾碼，請在CMTSStepApplyNetworkSetting或Set-CMTSStepApplyNetworkSetting Cmdlet 上使用DnsSuffix參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableIpProtocolFiltering
新增此參數以篩選某些 IP 通訊協定。 若要啟用 TCP/IP 篩選，請使用CMTSStepApplyNetworkSetting或Set-CMTSStepApplyNetworkSetting Cmdlet 上的EnableTcpIpFiltering參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableLmHosts
新增此參數以啟用 LMHOSTS 查閱。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableTcpFiltering
新增此參數以篩選部分 TCP 埠。 若要啟用 TCP/IP 篩選，請使用CMTSStepApplyNetworkSetting或Set-CMTSStepApplyNetworkSetting Cmdlet 上的EnableTcpIpFiltering參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableUdpFiltering
新增此參數以篩選某些 UDP 埠。 若要啟用 TCP/IP 篩選，請使用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 |
-IpAddress
如果此連線不使用 DHCP，請使用此參數來指定一或多個 IP 位址和對應的子網路遮罩。 其值為 hashtable。 第一個值是 IP ，第二個值為 Mask 。
例如：@{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }
如果您需要指定一個以上的 IP 位址與子網路遮罩組合，請使用 hashtables 的陣列。
例如：@( @{ 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 |
-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 |
-公制
指定表示使用 閘道成本的度量。 如果您未指定此參數，閘道會使用自動躍點數。
| Type: | Int32 |
| Aliases: | GatewayCostMetric |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-名稱
為此連接指定唯一的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-閘道
如果此連線不使用 DHCP，請使用此參數指定一或多個閘道位址。
如有需要，請使用 公制 參數。 閘道預設會使用自動躍點數。
| Type: | String[] |
| Aliases: | GatewayIpAddress, GatewayIpAddresses |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
無
輸出
IResultObject
備註
如需此 return 物件及其屬性的詳細資訊，請參閱 SMS_TaskSequence_NetworkAdapterSettings SERVER WMI 類別。