New-CMTSNetworkAdapterSetting
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.
RELATED LINKS
Nova CMTSStepApplyNetworksetting Set-CMTSStepApplyNetworksetting
Sobre etapas de sequência de tarefas: Aplicar Definições de rede