New-CMTSNetworkAdapterSetting
Создание объекта параметров для сетевого адаптера на шаге Параметры последовательности задач.
Синтаксис
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, например PS XYZ:\> . Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример 1. Добавление параметров сетевого адаптера для подключения с несколькими адресами
В этом примере сначала определяются три переменные массива, которые определяют несколько адресов. Переменная $dns — массив с двумя адресами DNS-сервера. Переменная $gw — массив с двумя шлюзами. Переменная $ip — массив с двумя ххтеблями. Каждый hashtable определяет 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
Перед запуском командлет запросит подтверждение.
| 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, используйте параметр DnsSuffix в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableFullDnsRegistration
Добавьте этот параметр, чтобы использовать Суффикс DNS подключения в регистрации DNS. Этот параметр применяется ко всем подключениям с включенной поддержкой TCP/IP. Чтобы указать суффикс DNS, используйте параметр DnsSuffix в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableIpProtocolFiltering
Добавьте этот параметр для фильтрации некоторых ip-протоколов. Чтобы включить фильтрацию TCP/IP, используйте параметр EnableTcpIpFiltering в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting.
| 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, используйте параметр EnableTcpIpFiltering в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableUdpFiltering
Добавьте этот параметр для фильтрации некоторых портов UDP. Чтобы включить фильтрацию TCP/IP, используйте параметр EnableTcpIpFiltering в командлетах New-CMTSStepApplyNetworkSetting или Set-CMTSStepApplyNetworkSetting.
| 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-адресов и соответствующие маски подсети. Это значение — hashtable. Первое значение — IP это второе значение Mask .
Пример: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }
Если необходимо указать несколько IP-адресов и комбинацию маски подсети, используйте массив hashtables.
Пример: @( @{ 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 |
-Name
Укажите уникальное имя для этого подключения.
| Type: | String |
| 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
Укажите, включить или отключить NetBIOS через TCP/IP.
| 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
Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.
| 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 |
Входные данные
Нет
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом объекте возврата и его свойствах см. в SMS_TaskSequence_NetworkAdapterSettings класса WMI сервера.