New-CMTSNetworkAdapterSetting
Cree un objeto de configuración para un adaptador de red en el paso De Configuración secuencia de tareas.
Syntax
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 About task sequence steps: Apply Network Configuración.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1: Agregar 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 $dns variable es una matriz con dos direcciones de servidor DNS. La $gw variable es una matriz con dos direcciones de puerta de enlace. La $ip variable es una matriz con dos tablas hash. Cada tabla hash define una dirección IP y un par de máscaras de subred.
La siguiente línea del ejemplo usa el cmdlet New-CMTSNetworkAdapterSetting para crear el objeto de configuración del adaptador de red. Usa las variables definidas y establece varias otras opciones.
La parte final de este ejemplo configura un paso aplicar red Configuración 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Dns
Especifique una o más direcciones de servidor DNS en orden de uso.
Type: | String[] |
Aliases: | DNSServerAddress, DNSServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 habilitadas. Para especificar el sufijo DNS, use el parámetro DnsSuffix en los cmdlets New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 habilitadas. Para especificar el sufijo DNS, use el parámetro DnsSuffix en los cmdlets New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableLmHosts
Agregue este parámetro para habilitar la búsqueda de LMHOSTS.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Gateway
Si esta conexión no usa DHCP, use este parámetro para especificar una o más 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.
Type: | String[] |
Aliases: | GatewayIpAddress, GatewayIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpAddress
Si esta conexión no usa DHCP, use este parámetro para especificar una o más direcciones IP y las máscaras de subred correspondientes. El valor es una tabla hash. El primer valor es el IP
y el segundo es el Mask
.
Por ejemplo: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }
Si necesita especificar más de una combinación de direcciones IP y máscaras 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"; } )
Type: | Hashtable[] |
Aliases: | NetworkSettingIpAddress, NetworkSettingIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpProtocolFilterList
Cuando use el parámetro EnableIpProtocolFiltering, use este parámetro para especificar uno o varios protocolos IP.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metric
Especifique la métrica que indica el costo del uso de la puerta de enlace. Si no especifica este parámetro, la puerta de enlace usa una métrica automática.
Type: | Int32 |
Aliases: | GatewayCostMetric |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique un nombre único para esta conexión.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpFilterPortList
Cuando use el parámetro EnableTcpFiltering, use este parámetro para especificar uno o varios puertos TCP.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpIpNetbiosOption
Especifique si se habilita o deshabilita NetBIOS a través de TCP/IP.
Type: | NetbiosOption |
Accepted values: | Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UdpFilterPortList
Cuando use el parámetro EnableUdpFiltering, use este parámetro para especificar uno o varios puertos UDP.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wins
Especifique una o varias direcciones de servidor WINS.
Type: | String[] |
Aliases: | WinsServerAddress, WinsServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Ninguno
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_NetworkAdapterSettings server WMI class.