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

Описание

Этот командлет создает объект параметров сетевого адаптера. Используйте этот объект с параметром AddAdapterSetting в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting .

Дополнительные сведения см. в разделе Сведения о шагах последовательности задач: Применение параметров сети.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Добавление параметров сетевого адаптера для подключения с несколькими адресами

В этом примере сначала определяются три переменные массива, определяющие несколько адресов. Переменная $dns представляет собой массив с двумя адресами DNS-сервера. Переменная $gw представляет собой массив с двумя адресами шлюза. Переменная $ip представляет собой массив с двумя хэш-столбцами. Каждая хэш-сводка определяет пару ip-адресов и маски подсети.

В следующей строке примера используется командлет New-CMTSNetworkAdapterSetting для создания объекта параметров сетевого адаптера. Он использует определенные переменные и задает несколько других параметров.

В заключительной части этого примера настраивается существующий шаг Применить параметры сети последовательности задач с именем Развертывание ОС по умолчанию. Он добавляет параметры сетевого адаптера в шаг и настраивает 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

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Dns

Укажите один или несколько адресов DNS-сервера в порядке использования.

Тип:String[]
Aliases:DNSServerAddress, DNSServerAddresses
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableDnsRegistration

Добавьте этот параметр, чтобы зарегистрировать адреса этого подключения в DNS. Этот параметр применяется ко всем подключениям с включенным ПРОТОКОЛом TCP/IP. Чтобы указать DNS-суффикс, используйте параметр DnsSuffix в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableFullDnsRegistration

Добавьте этот параметр, чтобы использовать DNS-суффикс подключения в регистрации DNS. Этот параметр применяется ко всем подключениям с включенным ПРОТОКОЛом TCP/IP. Чтобы указать DNS-суффикс, используйте параметр DnsSuffix в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableIpProtocolFiltering

Добавьте этот параметр для фильтрации некоторых IP-протоколов. Чтобы включить фильтрацию TCP/IP, используйте параметр EnableTcpIpFiltering в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableLmHosts

Добавьте этот параметр, чтобы включить поиск LMHOSTS.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableTcpFiltering

Добавьте этот параметр для фильтрации некоторых TCP-портов. Чтобы включить фильтрацию TCP/IP, используйте параметр EnableTcpIpFiltering в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableUdpFiltering

Добавьте этот параметр для фильтрации некоторых портов UDP. Чтобы включить фильтрацию TCP/IP, используйте параметр EnableTcpIpFiltering в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting .

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Gateway

Если это подключение не использует DHCP, используйте этот параметр, чтобы указать один или несколько адресов шлюза.

При необходимости используйте параметр Metric . По умолчанию шлюз использует автоматическую метрику.

Тип:String[]
Aliases:GatewayIpAddress, GatewayIpAddresses
Position:Named
Default value: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[]
Aliases:NetworkSettingIpAddress, NetworkSettingIpAddresses
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IpProtocolFilterList

При использовании параметра EnableIpProtocolFiltering используйте этот параметр для указания одного или нескольких IP-протоколов.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Metric

Укажите метрику, указывающую стоимость использования шлюза. Если этот параметр не указан, шлюз использует автоматическую метрику.

Тип:Int32
Aliases:GatewayCostMetric
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Укажите уникальное имя для этого подключения.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TcpFilterPortList

При использовании параметра EnableTcpFiltering используйте этот параметр, чтобы указать один или несколько TCP-портов.

Тип:Int32[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TcpIpNetbiosOption

Укажите, следует ли включать или отключать NetBIOS через TCP/IP.

Тип:NetbiosOption
Допустимые значения:Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UdpFilterPortList

При использовании параметра EnableUdpFiltering используйте этот параметр, чтобы указать один или несколько портов UDP.

Тип:Int32[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Wins

Укажите один или несколько адресов серверов WINS.

Тип:String[]
Aliases:WinsServerAddress, WinsServerAddresses
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_TaskSequence_NetworkAdapterSettings класс WMI сервера.