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
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Dns

依使用順序指定一或多個 DNS 伺服器位址。

類型:	String[]
別名:	DNSServerAddress, DNSServerAddresses
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableDnsRegistration

新增此參數以在 DNS 中註冊此連線的位址。 此設定適用於已啟用 TCP/IP 的所有連線。 若要指定 DNS 後綴，請在 New-CMTSStepApplyNetworkSetting 或 Set-CMTSStepApplyNetworkSetting Cmdlet 上使用 DnsSuffix 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableFullDnsRegistration

新增此參數以在 DNS 註冊中使用連接的 DNS 後綴。 此設定適用於已啟用 TCP/IP 的所有連線。 若要指定 DNS 後綴，請在 New-CMTSStepApplyNetworkSetting 或 Set-CMTSStepApplyNetworkSetting Cmdlet 上使用 DnsSuffix 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableIpProtocolFiltering

新增此參數以篩選某些IP通訊協定。 若要啟用 TCP/IP 篩選，請在 New-CMTSStepApplyNetworkSetting 或 Set-CMTSStepApplyNetworkSetting Cmdlet 上使用 EnableTcpIpFiltering 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableLmHosts

新增此參數以啟用 LMHOSTS 查閱。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableTcpFiltering

新增此參數以篩選某些 TCP 埠。 若要啟用 TCP/IP 篩選，請在 New-CMTSStepApplyNetworkSetting 或 Set-CMTSStepApplyNetworkSetting Cmdlet 上使用 EnableTcpIpFiltering 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableUdpFiltering

新增此參數以篩選某些 UDP 埠。 若要啟用 TCP/IP 篩選，請在 New-CMTSStepApplyNetworkSetting 或 Set-CMTSStepApplyNetworkSetting Cmdlet 上使用 EnableTcpIpFiltering 參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Gateway

如果此連線未使用 DHCP，請使用此參數來指定一或多個閘道位址。

如有需要，請使用 Metric 參數。 根據預設，閘道會使用自動計量。

類型:	String[]
別名:	GatewayIpAddress, GatewayIpAddresses
Position:	Named
預設值:	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
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IpProtocolFilterList

當您使用 EnableIpProtocolFiltering 參數時，請使用此參數來指定一或多個 IP 通訊協定。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Metric

指定計量，指出使用 閘道的成本。 如果您未指定此參數，閘道會使用自動計量。

類型:	Int32
別名:	GatewayCostMetric
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定此連接的唯一名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-TcpFilterPortList

當您使用 EnableTcpFiltering 參數時，請使用此參數來指定一或多個 TCP 連接埠。

類型:	Int32[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TcpIpNetbiosOption

指定是否要啟用或停用透過 TCP/IP 的 NetBIOS。

類型:	NetbiosOption
接受的值:	Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UdpFilterPortList

當您使用 EnableUdpFiltering 參數時，請使用此參數來指定一或多個 UDP 連接埠。

類型:	Int32[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Wins

指定一或多個 WINS 伺服器位址。

類型:	String[]
別名:	WinsServerAddress, WinsServerAddresses
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

IResultObject

備註

如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_TaskSequence_NetworkAdapterSettings伺服器 WMI 類別。

相關連結

• New-CMTSStepApplyNetworkSetting
• Set-CMTSStepApplyNetworkSetting
• 關於工作順序步驟：套用網路設定