New-CMTSNetworkAdapterSetting
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.