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：为具有多个地址的连接添加网络适配器设置

此示例首先定义定义多个地址的三个数组变量。 $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 类。