New-CMTSNetworkAdapterSetting

  • Referência
Módulo:
ConfigurationManager

Crie um objeto de definições para uma placa de rede no passo de sequência de tarefas Aplicar Definições de Rede .

Sintaxe

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 cria um objeto de definições de placa de rede. Utilize este objeto com o parâmetro AddAdapterSetting nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Para obter mais informações, veja Sobre os passos da sequência de tarefas: Aplicar Definições de Rede.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: adicionar definições de placa de rede para uma ligação com vários endereços

Este exemplo define primeiro três variáveis de matriz que definem os múltiplos endereços. A variável $dns é uma matriz com dois endereços de servidor DNS. A variável $gw é uma matriz com dois endereços de gateway. A variável $ip é uma matriz com duas tabelas hash. Cada tabela hash define um endereço IP e um par de máscaras de sub-rede.

A linha seguinte do exemplo utiliza o cmdlet New-CMTSNetworkAdapterSetting para criar o objeto de definições da placa de rede. Utiliza as variáveis definidas e define várias outras opções.

A parte final deste exemplo configura um passo Aplicar Definições de Rede existente de uma sequência de tarefas denominada Implementação do SO predefinido. Adiciona as definições da placa de rede ao passo e configura o sufixo 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

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Dns

Especifique um ou mais endereços de servidor DNS por ordem de utilização.

Tipo:String[]
Aliases:DNSServerAddress, DNSServerAddresses
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableDnsRegistration

Adicione este parâmetro para registar os endereços desta ligação no DNS. Esta definição aplica-se a todas as ligações com TCP/IP ativado. Para especificar o sufixo DNS, utilize o parâmetro DnsSuffix nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableFullDnsRegistration

Adicione este parâmetro para utilizar o sufixo DNS da ligação no registo DNS. Esta definição aplica-se a todas as ligações com TCP/IP ativado. Para especificar o sufixo DNS, utilize o parâmetro DnsSuffix nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableIpProtocolFiltering

Adicione este parâmetro para filtrar alguns protocolos IP. Para ativar a filtragem TCP/IP, utilize o parâmetro EnableTcpIpFiltering nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableLmHosts

Adicione este parâmetro para ativar a pesquisa LMHOSTS.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableTcpFiltering

Adicione este parâmetro para filtrar algumas portas TCP. Para ativar a filtragem TCP/IP, utilize o parâmetro EnableTcpIpFiltering nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableUdpFiltering

Adicione este parâmetro para filtrar algumas portas UDP. Para ativar a filtragem TCP/IP, utilize o parâmetro EnableTcpIpFiltering nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Gateway

Se esta ligação não utilizar DHCP, utilize este parâmetro para especificar um ou mais endereços de gateway.

Se necessário, utilize o parâmetro Métrica . Por predefinição, o gateway utiliza uma métrica automática.

Tipo:String[]
Aliases:GatewayIpAddress, GatewayIpAddresses
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IpAddress

Se esta ligação não utilizar DHCP, utilize este parâmetro para especificar um ou mais endereços IP e máscaras de sub-rede correspondentes. O valor é uma tabela hash. O primeiro valor é o IP e o segundo valor é .Mask

Por exemplo: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }

Se precisar de especificar mais do que uma combinação de endereço IP e máscara de sub-rede, utilize uma matriz de tabelas hash.

Por exemplo: @( @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }, @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; } )

Tipo:Hashtable[]
Aliases:NetworkSettingIpAddress, NetworkSettingIpAddresses
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IpProtocolFilterList

Quando utilizar o parâmetro EnableIpProtocolFiltering , utilize este parâmetro para especificar um ou mais protocolos IP.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Metric

Especifique a métrica que indica o custo da utilização do Gateway. Se não especificar este parâmetro, o gateway utiliza uma métrica automática.

Tipo:Int32
Aliases:GatewayCostMetric
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique um nome exclusivo para esta ligação.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TcpFilterPortList

Quando utilizar o parâmetro EnableTcpFiltering , utilize este parâmetro para especificar uma ou mais portas TCP.

Tipo:Int32[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TcpIpNetbiosOption

Especifique se pretende ativar ou desativar o NetBIOS através de TCP/IP.

Tipo:NetbiosOption
Valores aceitos:Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UdpFilterPortList

Quando utilizar o parâmetro EnableUdpFiltering , utilize este parâmetro para especificar uma ou mais portas UDP.

Tipo:Int32[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Wins

Especifique um ou mais endereços do servidor WINS.

Tipo:String[]
Aliases:WinsServerAddress, WinsServerAddresses
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_NetworkAdapterSettings classe WMI de servidor.