New-CMTSNetworkAdapterSetting
Crie um objeto de configurações para um adaptador de rede na etapa Aplicar rede Configurações sequência de tarefas.
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 cria um objeto de configurações de adaptador de rede. Use este objeto com o parâmetro AddAdapterSetting nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Para obter mais informações, consulte Sobre etapas da sequência de tarefas: Aplicar rede Configurações.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1: Adicionar configurações de adaptador de rede para uma conexão com vários endereços
Este exemplo primeiro define três variáveis de matriz que definem os vários endereços. A $dns é uma matriz com dois endereços de servidor DNS. A $gw variável é uma matriz com dois endereços de gateway. A $ip é uma matriz com duas hashtables. Cada hashtable define um endereço IP e um par de máscaras de sub-rede.
A próxima linha do exemplo usa o cmdlet New-CMTSNetworkAdapterSetting para criar o objeto de configurações do adaptador de rede. Ele usa as variáveis definidas e define várias outras opções.
A parte final deste exemplo configura uma etapa aplicar rede Configurações de uma sequência de tarefas chamada implantação padrão do sistema operacional. Ele adiciona as configurações do adaptador de rede à etapa 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Dns
Especifique um ou mais endereços de servidor DNS em ordem de uso.
Type: | String[] |
Aliases: | DNSServerAddress, DNSServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableDnsRegistration
Adicione esse parâmetro para registrar os endereços dessa conexão no DNS. Essa configuração se aplica a todas as conexões com TCP/IP habilitado. Para especificar o sufixo DNS, use o parâmetro DnsSuffix nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableFullDnsRegistration
Adicione esse parâmetro para usar o sufixo DNS da conexão no registro DNS. Essa configuração se aplica a todas as conexões com TCP/IP habilitado. Para especificar o sufixo DNS, use o parâmetro DnsSuffix nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableIpProtocolFiltering
Adicione esse parâmetro para filtrar alguns protocolos IP. Para habilitar a filtragem TCP/IP, use o parâmetro EnableTcpIpFiltering nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableLmHosts
Adicione esse parâmetro para habilitar a busca do LMHOSTS.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableTcpFiltering
Adicione esse parâmetro para filtrar algumas portas TCP. Para habilitar a filtragem TCP/IP, use o parâmetro EnableTcpIpFiltering nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableUdpFiltering
Adicione esse parâmetro para filtrar algumas portas UDP. Para habilitar a filtragem TCP/IP, use o parâmetro EnableTcpIpFiltering nos cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Gateway
Se essa conexão não usar DHCP, use esse parâmetro para especificar um ou mais endereços de gateway.
Se necessário, use o parâmetro Metric. Por padrão, o gateway usa uma métrica automática.
Type: | String[] |
Aliases: | GatewayIpAddress, GatewayIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpAddress
Se essa conexão não usar DHCP, use esse parâmetro para especificar um ou mais endereços IP e máscaras de sub-rede correspondentes. O valor é uma hashtable. O primeiro valor é o IP
e o segundo valor é o Mask
.
Por exemplo: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }
Se você precisar especificar mais de um endereço IP e uma combinação de máscara de sub-rede, use uma matriz de hashtables.
Por exemplo: @( @{ 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
Ao usar o parâmetro EnableIpProtocolFiltering, use esse parâmetro para especificar um ou mais protocolos IP.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metric
Especifique a métrica que indica o custo de uso do Gateway. Se você não especificar esse parâmetro, o gateway usará uma métrica automática.
Type: | Int32 |
Aliases: | GatewayCostMetric |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique um nome exclusivo para essa conexão.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpFilterPortList
Ao usar o parâmetro EnableTcpFiltering, use este parâmetro para especificar uma ou mais portas TCP.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpIpNetbiosOption
Especifique se deve habilitar ou desabilitar o NetBIOS por TCP/IP.
Type: | NetbiosOption |
Accepted values: | Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UdpFilterPortList
Ao usar o parâmetro EnableUdpFiltering, use esse parâmetro para especificar uma ou mais portas UDP.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wins
Especifique um ou mais endereços de servidor WINS.
Type: | String[] |
Aliases: | WinsServerAddress, WinsServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Nenhum
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_TaskSequence_NetworkAdapterSettings classe WMI do servidor.