New-CMTSNetworkAdapterSetting

Artigo
08/17/2021

SYNOPSIS

Crie um objeto de definições para um adaptador de rede na rede de aplicação Definições passo de sequência de tarefa.

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 definição de adaptação de rede. Utilize este objeto com o parâmetro AddAdapterSetting na Nova CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting cmdlets.

Para obter mais informações, consulte sobre os passos da sequência de tarefas: Aplicar Definições de rede.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Adicionar definições de adaptador 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 dois haxixe. Cada hashtable define um endereço IP e um par de máscaras de sub-rede.

A próxima linha do exemplo utiliza o cmdlet de definição de adaptador de rede New-CMTSNetworkAdapterSetting para criar o objeto de definições de adaptação de rede. Usa as variáveis definidas, e define várias outras opções.

A parte final deste exemplo configura uma rede de aplicação existente Definições passo de uma sequência de tarefa chamada implementação padrão de SO. Adiciona as definições do adaptador de rede ao degrau 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"

PARAMETERS

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Dns

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

Type: String[]
Parameter Sets: (All)
Aliases: DNSServerAddress, DNSServerAddresses

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Ativação DoRegistramento deNs

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 ativadas. Para especificar o sufixo DNS, utilize o parâmetro DnsS suix na nova CMTSApplyNetworkSetting ou set-CMTSStepApplyNetworkSetting cmdlets.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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 ativadas. Para especificar o sufixo DNS, utilize o parâmetro DnsS suix na nova CMTSApplyNetworkSetting ou set-CMTSStepApplyNetworkSetting cmdlets.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableIpProtocolFiltering

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableLmHosts

Adicione este parâmetro para ativar a procura de LMHOSTS.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Ativar oFilteramento do TCP

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableUdpFiltering

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- Gateway

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

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

Type: String[]
Parameter Sets: (All)
Aliases: GatewayIpAddress, GatewayIpAddresses

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IpAddress

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

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

Se precisar de especificar mais de um endereço IP e uma combinação de máscaras de sub-rede, utilize uma matriz de haxixe.

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

Type: Hashtable[]
Parameter Sets: (All)
Aliases: NetworkSettingIpAddress, NetworkSettingIpAddresses

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IpProtocolFilterList

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

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Métrica

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

Type: Int32
Parameter Sets: (All)
Aliases: GatewayCostMetric

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Especifique um nome único para esta ligação.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TcpFilterPortList

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

Type: Int32[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TcpIpNetbiosOption

Especificar se deve ativar ou desativar o NetBIOS em TCP/IP.

Type: NetbiosOption
Parameter Sets: (All)
Aliases:
Accepted values: Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UdpFilterPortList

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

Type: Int32[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- Ganha

Especifique um ou mais endereços de servidor WINS.

Type: String[]
Parameter Sets: (All)
Aliases: WinsServerAddress, WinsServerAddresses

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Nenhuma

OUTPUTS

IResultObject#SMS_TaskSequence_NetworkAdapterSettings

NOTAS

Para obter mais informações sobre este objeto de retorno e suas propriedades, consulte SMS_TaskSequence_NetworkAdapterSettings classe WMI do servidor.

Nova CMTSStepApplyNetworksetting Set-CMTSStepApplyNetworksetting

Sobre etapas de sequência de tarefas: Aplicar Definições de rede