New-CMTSNetworkAdapterSetting
Cree un objeto de configuración para un adaptador de red en el paso de secuencia de tareas Aplicar configuración de red.
Sintaxis
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>] Description
Este cmdlet crea un objeto de configuración de adaptador de red. Use este objeto con el parámetro AddAdapterSetting en los cmdlets New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .
Para obtener más información, vea Acerca de los pasos de secuencia de tareas: Aplicar la configuración de red.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Adición de la configuración del adaptador de red para una conexión con varias direcciones
En este ejemplo se definen primero tres variables de matriz que definen las varias direcciones. La variable $dns es una matriz con dos direcciones de servidor DNS. La variable $gw es una matriz con dos direcciones de puerta de enlace. La variable $ip es una matriz con dos tablas hash. Cada tabla hash define una dirección IP y un par de máscaras de subred.
En la siguiente línea del ejemplo se usa el cmdlet New-CMTSNetworkAdapterSetting para crear el objeto de configuración del adaptador de red. Usa las variables definidas y establece otras opciones.
La parte final de este ejemplo configura un paso Aplicar configuración de red existente de una secuencia de tareas denominada Implementación predeterminada del sistema operativo. Agrega la configuración del adaptador de red al paso y configura el sufijo 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"Parámetros
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Dns
Especifique una o varias direcciones de servidor DNS en orden de uso.
| Tipo: | String[] |
| Alias: | DNSServerAddress, DNSServerAddresses |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EnableDnsRegistration
Agregue este parámetro para registrar las direcciones de esta conexión en DNS. Esta configuración se aplica a todas las conexiones con TCP/IP habilitado. Para especificar el sufijo DNS, use el parámetro DnsSuffix en los cmdlets New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EnableFullDnsRegistration
Agregue este parámetro para usar el sufijo DNS de la conexión en el registro DNS. Esta configuración se aplica a todas las conexiones con TCP/IP habilitado. Para especificar el sufijo DNS, use el parámetro DnsSuffix en los cmdlets New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EnableIpProtocolFiltering
Agregue este parámetro para filtrar algunos protocolos IP. Para habilitar el filtrado TCP/IP, use el parámetro EnableTcpIpFiltering en los cmdlets New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EnableLmHosts
Agregue este parámetro para habilitar la búsqueda LMHOSTS.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EnableTcpFiltering
Agregue este parámetro para filtrar algunos puertos TCP. Para habilitar el filtrado TCP/IP, use el parámetro EnableTcpIpFiltering en los cmdlets New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EnableUdpFiltering
Agregue este parámetro para filtrar algunos puertos UDP. Para habilitar el filtrado TCP/IP, use el parámetro EnableTcpIpFiltering en los cmdlets New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Gateway
Si esta conexión no usa DHCP, use este parámetro para especificar una o varias direcciones de puerta de enlace.
Si es necesario, use el parámetro Metric . De forma predeterminada, la puerta de enlace usa una métrica automática.
| Tipo: | String[] |
| Alias: | GatewayIpAddress, GatewayIpAddresses |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-IpAddress
Si esta conexión no usa DHCP, use este parámetro para especificar una o varias direcciones IP y las máscaras de subred correspondientes. El valor es una tabla hash. El primer valor es y IP el segundo es Mask.
Por ejemplo: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }
Si necesita especificar más de una combinación de dirección IP y máscara de subred, use una matriz de tablas hash.
Por ejemplo: @( @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }, @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; } )
| Tipo: | Hashtable[] |
| Alias: | NetworkSettingIpAddress, NetworkSettingIpAddresses |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-IpProtocolFilterList
Cuando use el parámetro EnableIpProtocolFiltering , use este parámetro para especificar uno o varios protocolos IP.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Metric
Especifique la métrica que indica el costo de usar la puerta de enlace. Si no especifica este parámetro, la puerta de enlace usa una métrica automática.
| Tipo: | Int32 |
| Alias: | GatewayCostMetric |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Especifique un nombre único para esta conexión.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-TcpFilterPortList
Cuando use el parámetro EnableTcpFiltering , use este parámetro para especificar uno o varios puertos TCP.
| Tipo: | Int32[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-TcpIpNetbiosOption
Especifique si desea habilitar o deshabilitar NetBIOS a través de TCP/IP.
| Tipo: | NetbiosOption |
| Valores aceptados: | Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UdpFilterPortList
Cuando use el parámetro EnableUdpFiltering , use este parámetro para especificar uno o varios puertos UDP.
| Tipo: | Int32[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Wins
Especifique una o varias direcciones de servidor WINS.
| Tipo: | String[] |
| Alias: | WinsServerAddress, WinsServerAddresses |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_NetworkAdapterSettings clase WMI de servidor.