{"content":"<div></div>","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/zh-cn/powershell/","_op_gitContributorInformation":{"author":{"display_name":"Banreet Kaur","id":"92906285","name":"Banreet","profile_url":"https://github.com/Banreet"},"contributors":[{"display_name":"Aaron Czechowski","id":"26784733","name":"aczechowski","profile_url":"https://github.com/aczechowski"}],"update_at":"2026/10/7","updated_at_date_time":"2026-10-07T23:30:17.0744737Z"},"_path":"module/configurationmanager/new-cmtsnetworkadaptersetting.json","_rel":"../../","_tocRel":"../sccm-ps/toc.json","apiPlatform":"powershell","author":"Banreet","breadcrumb_path":"/powershell/sccm/bread/toc.json","canonical_url":"https://learn.microsoft.com/zh-cn/powershell/module/configurationmanager/new-cmtsnetworkadaptersetting?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/New-CMTSNetworkAdapterSetting.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","document_id":"58ca72f9-f5a0-ce6f-81f8-a34eea9419b2","document_version_independent_id":"be1d15e0-ebbc-7bd9-bc61-50048df9675f","external help file":"AdminUI.PS.dll-Help.xml","feedback_product_url":"https://feedbackportal.microsoft.com/feedback/forum/4669adfc-ee1b-ec11-b6e7-0022481f8472","feedback_system":"Standard","git_commit_id":"48cf632fb4b9ad92060012681a500478254de750","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/48cf632fb4b9ad92060012681a500478254de750/sccm-ps/ConfigurationManager/New-CMTSNetworkAdapterSetting.md","github_contributors":["aczechowski"],"locale":"zh-cn","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"08/04/2021","ms.service":"configuration-manager","ms.subservice":"other","ms.topic":"reference","online version":"","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/New-CMTSNetworkAdapterSetting.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/New-CMTSNetworkAdapterSetting.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-10-07 11:30 PM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtsnetworkadaptersetting","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSNetworkAdapterSetting","schemaType":"PowershellCmdlet","summary":"<p>在 <strong>“应用</strong> 网络设置”任务序列步骤上为网络适配器创建设置对象。</p>\n","uid":"ConfigurationManager.New-CMTSNetworkAdapterSetting"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMTSNetworkAdapterSetting":{"href":"new-cmtsnetworkadaptersetting","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSNetworkAdapterSetting","schemaType":"PowershellCmdlet","summary":"<p>在 <strong>“应用</strong> 网络设置”任务序列步骤上为网络适配器创建设置对象。</p>\n","uid":"ConfigurationManager.New-CMTSNetworkAdapterSetting"}},"description":"<p>此 cmdlet 创建网络适配器设置对象。 将此对象与 <a href=\"new-cmtsstepapplynetworksetting\">New-CMTSStepApplyNetworkSetting</a> 或 <a href=\"set-cmtsstepapplynetworksetting\">Set-CMTSStepApplyNetworkSetting</a> cmdlet 上的 <strong>AddAdapterSetting</strong> 参数一起使用。</p>\n<p>有关详细信息，请参阅 <a href=\"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_ApplyNetworkSettings\">关于任务序列步骤：应用网络设置</a>。</p>\n<div class=\"NOTE\">\n<p>注意</p>\n<p>从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 <code>PS XYZ:\\&gt;</code>。 有关详细信息，请参阅 <a href=\"/powershell/sccm/overview\">入门</a>。</p>\n</div>\n","examples":[{"code":"$dns = @(\"192.168.1.100\",\"10.0.1.100\")\n$gw = @(\"192.168.1.1\",\"10.0.1.1\")\n\n$ip = @(\n    @{ IP = \"192.168.1.42\"; Mask = \"255.255.255.0\"; },\n    @{ IP = \"10.0.1.42\"; Mask = \"255.255.242.0\"; }\n)\n\n$conn1 = New-CMTSNetworkAdapterSetting -Name \"local connection\" -Dns $dns -EnableDnsRegistration -EnableFullDnsRegistration -Gateway $gw -IpAddress $ip -TcpIpNetbiosOption DisableNetbiosOverTcpip\n\n$tsNameOsd = \"Default OS deployment\"\n$tsStepNameApplyNetSet = \"Apply Network Settings\"\n\nSet-CMTSStepApplyNetworkSetting -TaskSequenceName $tsNameOsd -StepName $tsStepNameApplyNetSet -AddAdapterSetting $conn1 -DnsSuffix \"corp.contoso.com\"","description":"","summary":"<p>此示例首先定义定义多个地址的三个数组变量。 \n              <strong>$dns</strong> 变量是具有两个 DNS 服务器地址的数组。 \n              <strong>$gw</strong>变量是具有两个网关地址的数组。 \n              <strong>$ip</strong> 变量是包含两个哈希表的数组。 每个哈希表定义 IP 地址和子网掩码对。</p>\n<p>示例的下一行使用 <strong>New-CMTSNetworkAdapterSetting</strong> cmdlet 创建网络适配器设置对象。 它使用定义的变量，并设置其他几个选项。</p>\n<p>此示例的最后一部分配置名为<strong>“默认 OS 部署</strong>”的任务序列的现有<strong>“应用网络设置”</strong>步骤。 它将网络适配器设置添加到步骤，并配置 DNS 后缀。</p>\n","title":"示例 1：为具有多个地址的连接添加网络适配器设置"}],"inputs":[{"description":"","name":"<span class=\"no-loc xref\">None</span>\n"}],"links":[{"href":"new-cmtsstepapplynetworksetting","text":"New-CMTSStepApplyNetworkSetting"},{"href":"set-cmtsstepapplynetworksetting","text":"Set-CMTSStepApplyNetworkSetting"},{"href":"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_ApplyNetworkSettings","text":"关于任务序列步骤：应用网络设置"}],"module":"ConfigurationManager","name":"New-CMTSNetworkAdapterSetting","notes":"<p>有关此返回对象及其属性的详细信息，请参阅 <a href=\"/mem/configmgr/develop/reference/osd/sms_tasksequence_networkadaptersettings-server-wmi-class\">SMS_TaskSequence_NetworkAdapterSettings服务器 WMI 类</a>。</p>\n","outputs":[{"description":"","name":"<span class=\"no-loc xref\">IResultObject</span>\n"}],"parameters":[{"aliases":"cf","defaultValue":"None","description":"<p>提示你在运行 cmdlet 之前进行确认。</p>\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>此参数将通配符视为文本字符值。 不能将其与 <strong>ForceWildcardHandling</strong> 组合使用。</p>\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"DNSServerAddress, DNSServerAddresses","defaultValue":"None","description":"<p>按使用顺序指定一个或多个 DNS 服务器地址。</p>\n","name":"Dns","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>添加此参数以在 DNS 中注册此连接的地址。 此设置适用于所有启用了 TCP/IP 的连接。 若要指定 DNS 后缀，请在 <a href=\"new-cmtsstepapplynetworksetting\">New-CMTSStepApplyNetworkSetting</a> 或 <a href=\"set-cmtsstepapplynetworksetting\">Set-CMTSStepApplyNetworkSetting</a> cmdlet 上使用 <strong>DnsSuffix</strong> 参数。</p>\n","name":"EnableDnsRegistration","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>添加此参数以在 DNS 注册中使用连接的 DNS 后缀。 此设置适用于所有启用了 TCP/IP 的连接。 若要指定 DNS 后缀，请在 <a href=\"new-cmtsstepapplynetworksetting\">New-CMTSStepApplyNetworkSetting</a> 或 <a href=\"set-cmtsstepapplynetworksetting\">Set-CMTSStepApplyNetworkSetting</a> cmdlet 上使用 <strong>DnsSuffix</strong> 参数。</p>\n","name":"EnableFullDnsRegistration","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>添加此参数以筛选某些 IP 协议。 若要启用 TCP/IP 筛选，请在 <a href=\"new-cmtsstepapplynetworksetting\">New-CMTSStepApplyNetworkSetting 或 Set-CMTSStepApplyNetworkSetting</a> cmdlet 上使用 <strong>EnableTcpIpFiltering</strong> 参数。<a href=\"set-cmtsstepapplynetworksetting\"></a></p>\n","name":"EnableIpProtocolFiltering","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>添加此参数以启用 LMHOSTS 查找。</p>\n","name":"EnableLmHosts","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>添加此参数以筛选某些 TCP 端口。 若要启用 TCP/IP 筛选，请在 <a href=\"new-cmtsstepapplynetworksetting\">New-CMTSStepApplyNetworkSetting 或 Set-CMTSStepApplyNetworkSetting</a> cmdlet 上使用 <strong>EnableTcpIpFiltering</strong> 参数。<a href=\"set-cmtsstepapplynetworksetting\"></a></p>\n","name":"EnableTcpFiltering","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>添加此参数以筛选某些 UDP 端口。 若要启用 TCP/IP 筛选，请在 <a href=\"new-cmtsstepapplynetworksetting\">New-CMTSStepApplyNetworkSetting 或 Set-CMTSStepApplyNetworkSetting</a> cmdlet 上使用 <strong>EnableTcpIpFiltering</strong> 参数。<a href=\"set-cmtsstepapplynetworksetting\"></a></p>\n","name":"EnableUdpFiltering","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 <strong>DisableWildcardHandling</strong> 组合使用。</p>\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"GatewayIpAddress, GatewayIpAddresses","defaultValue":"None","description":"<p>如果此连接不使用 DHCP，请使用此参数指定一个或多个网关地址。</p>\n<p>如果需要，请使用 <strong>Metric</strong> 参数。 默认情况下，网关使用自动指标。</p>\n","name":"Gateway","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"NetworkSettingIpAddress, NetworkSettingIpAddresses","defaultValue":"None","description":"<p>如果此连接不使用 DHCP，请使用此参数指定一个或多个 IP 地址和相应的子网掩码。 值为哈希表。 第一个值为 ， <code>IP</code> 第二个 <code>Mask</code>值为 。</p>\n<p>例如：<code>@{ IP = &quot;192.168.1.42&quot;; Mask = &quot;255.255.255.0&quot;; }</code></p>\n<p>如果需要指定多个 IP 地址和子网掩码组合，请使用哈希表数组。</p>\n<p>例如：<code>@( @{ IP = &quot;192.168.1.42&quot;; Mask = &quot;255.255.255.0&quot;; }, @{ IP = &quot;10.0.1.42&quot;; Mask = &quot;255.255.242.0&quot;; } )</code></p>\n","name":"IpAddress","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">Hashtable</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>使用 <strong>EnableIpProtocolFiltering</strong> 参数时，请使用此参数指定一个或多个 IP 协议。</p>\n","name":"IpProtocolFilterList","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"GatewayCostMetric","defaultValue":"None","description":"<p>指定指示使用 <strong>网关</strong>的成本的指标。 如果未指定此参数，网关将使用自动指标。</p>\n","name":"Metric","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Int32</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>为此连接指定唯一名称。</p>\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>使用 <strong>EnableTcpFiltering</strong> 参数时，请使用此参数指定一个或多个 TCP 端口。</p>\n","name":"TcpFilterPortList","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">Int32</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>指定是通过 TCP/IP 启用或禁用 NetBIOS。</p>\n","name":"TcpIpNetbiosOption","parameterValueGroup":"Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip","position":"Named","type":"<span class=\"no-loc xref\">NetbiosOption</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>使用 <strong>EnableUdpFiltering</strong> 参数时，请使用此参数指定一个或多个 UDP 端口。</p>\n","name":"UdpFilterPortList","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">Int32</span><span>[</span><span>]</span></p>\n"},{"aliases":"wi","defaultValue":"None","description":"<p>显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。</p>\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"WinsServerAddress, WinsServerAddresses","defaultValue":"None","description":"<p>指定一个或多个 WINS 服务器地址。</p>\n","name":"Wins","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"}],"schema":"PowershellCmdlet","summary":"<p>在 <strong>“应用</strong> 网络设置”任务序列步骤上为网络适配器创建设置对象。</p>\n","syntaxes":["New-CMTSNetworkAdapterSetting [-Dns <String[]>] [-EnableDnsRegistration] [-EnableFullDnsRegistration]\n [-EnableIpProtocolFiltering] [-EnableLmHosts] [-EnableTcpFiltering] [-EnableUdpFiltering]\n [-Gateway <String[]>] [-IpAddress <Hashtable[]>] [-IpProtocolFilterList <String[]>] [-Metric <Int32>]\n -Name <String> [-TcpFilterPortList <Int32[]>] [-TcpIpNetbiosOption <NetbiosOption>]\n [-UdpFilterPortList <Int32[]>] [-Wins <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] [<CommonParameters>]"],"uid":"ConfigurationManager.New-CMTSNetworkAdapterSetting","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"zh-cn","loc_version":"2024-08-21T21:18:36.7205003Z","loc_source_id":"Github-72476255#live","loc_file_id":"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/New-CMTSNetworkAdapterSetting.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtsnetworkadaptersetting","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSNetworkAdapterSetting","schemaType":"PowershellCmdlet","summary":"<p>在 <strong>“应用</strong> 网络设置”任务序列步骤上为网络适配器创建设置对象。</p>\n","uid":"ConfigurationManager.New-CMTSNetworkAdapterSetting"}],"canonical_url":"https://learn.microsoft.com/zh-cn/powershell/module/configurationmanager/new-cmtsnetworkadaptersetting?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/zh-cn/powershell/module/configurationmanager/new-cmtsnetworkadaptersetting?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>此 cmdlet 创建网络适配器设置对象。 将此对象与 <a href=&quot;new-cmtsstepapplynetworksetting&quot;>New-CMTSStepApplyNetworkSetting</a> 或 <a href=&quot;set-cmtsstepapplynetworksetting&quot;>Set-CMTSStepApplyNetworkSetting</a> cmdlet 上的 <strong>AddAdapterSetting</strong> 参数一起使用。</p>\n<p>有关详细信息，请参阅 <a href=&quot;/mem/configmgr/osd/understand/task-sequence-steps#BKMK_ApplyNetworkSettings&quot;>关于任务序列步骤：应用网络设置</a>。</p>\n<div class=&quot;NOTE&quot;>\n<p>注意</p>\n<p>从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 <code>PS XYZ:\\&amp;gt;</code>。 有关详细信息，请参阅 <a href=&quot;/powershell/sccm/overview&quot;>入门</a>。</p>\n</div>\n\" />\r\n<meta name=\"hideEdit\" content=\"true\" />\r\n<meta name=\"loc_file_id\" content=\"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/New-CMTSNetworkAdapterSetting.md\" />\r\n<meta name=\"loc_source_id\" content=\"Github-72476255#live\" />\r\n<meta name=\"loc_version\" content=\"2024-08-21T21:18:36.7205003Z\" />\r\n<meta name=\"module\" content=\"ConfigurationManager\" />\r\n<meta name=\"ms.contentlocale\" content=\"zh-cn\" />\r\n<meta name=\"ms.translationtype\" content=\"MT\" />\r\n<meta name=\"name\" content=\"New-CMTSNetworkAdapterSetting\" />\r\n<meta name=\"notes\" content=\"<p>有关此返回对象及其属性的详细信息，请参阅 <a href=&quot;/mem/configmgr/develop/reference/osd/sms_tasksequence_networkadaptersettings-server-wmi-class&quot;>SMS_TaskSequence_NetworkAdapterSettings服务器 WMI 类</a>。</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>在 <strong>“应用</strong> 网络设置”任务序列步骤上为网络适配器创建设置对象。</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"New-CMTSNetworkAdapterSetting [-Dns <String[]>] [-EnableDnsRegistration] [-EnableFullDnsRegistration]\n [-EnableIpProtocolFiltering] [-EnableLmHosts] [-EnableTcpFiltering] [-EnableUdpFiltering]\n [-Gateway <String[]>] [-IpAddress <Hashtable[]>] [-IpProtocolFilterList <String[]>] [-Metric <Int32>]\n -Name <String> [-TcpFilterPortList <Int32[]>] [-TcpIpNetbiosOption <NetbiosOption>]\n [-UdpFilterPortList <Int32[]>] [-Wins <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.New-CMTSNetworkAdapterSetting\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}