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>]

说明

此 cmdlet 创建网络适配器设置对象。 将此对象与New-CMTSStepApplyNetworkSetting或Set-CMTSStepApplyNetworkSetting cmdlet 上的AddAdapterSetting参数一同使用。

有关详细信息，请参阅关于任务序列步骤：应用网络设置。

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。 有关详细信息，请参阅 入门。

示例

示例 1：为具有多个地址的连接添加网络适配器设置

此示例首先定义三个定义多个地址的数组变量。 the $dns variable is an array with two DNS server addresses. the $gw variable is an array with two gateway addresses. the $ip variable is an array with two hashtables. 每个哈希表定义一个 IP 地址和子网掩码对。

此示例的下一行使用 New-CMTSNetworkAdapterSetting cmdlet 创建网络适配器设置对象。 它使用定义的变量，并设置其他几个选项。

此示例的最后一部分将配置名为"默认操作系统部署"的任务序列设置应用网络部署步骤。 它将网络适配器设置添加到步骤中，并配置 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 查找。

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

-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:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

输入

无

输出

IResultObject

备注

有关此返回对象及其属性的信息，请参阅SMS_TaskSequence_NetworkAdapterSettings WMI 类。