New-CMTSNetworkAdapterSetting

  • Riferimento
Modulo:
ConfigurationManager

Creare un oggetto impostazioni per una scheda di rete nel passaggio Della sequenza di attività Applica impostazioni di rete.

Sintassi

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>]

Descrizione

Questo cmdlet crea un oggetto impostazioni scheda di rete. Utilizzare questo oggetto con il parametro AddAdapterSetting nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .

Per altre informazioni, vedere Informazioni sui passaggi della sequenza di attività: Applicare le impostazioni di rete.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiungere le impostazioni della scheda di rete per una connessione con più indirizzi

Questo esempio definisce prima di tutto tre variabili di matrice che definiscono più indirizzi. La variabile $dns è una matrice con due indirizzi server DNS. La variabile $gw è una matrice con due indirizzi gateway. La variabile $ip è una matrice con due tabelle hash. Ogni tabella hash definisce una coppia di indirizzi IP e subnet mask.

Nella riga successiva dell'esempio viene utilizzato il cmdlet New-CMTSNetworkAdapterSetting per creare l'oggetto impostazioni della scheda di rete. Usa le variabili definite e imposta diverse altre opzioni.

La parte finale di questo esempio configura un passaggio Applica impostazioni di rete esistente di una sequenza di attività denominata Distribuzione del sistema operativo predefinito. Aggiunge le impostazioni della scheda di rete al passaggio e configura il suffisso 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"

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Dns

Specificare uno o più indirizzi server DNS in ordine di utilizzo.

Tipo:String[]
Alias:DNSServerAddress, DNSServerAddresses
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableDnsRegistration

Aggiungere questo parametro per registrare gli indirizzi della connessione in DNS. Questa impostazione si applica a tutte le connessioni con TCP/IP abilitato. Per specificare il suffisso DNS, usare il parametro DnsSuffix nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableFullDnsRegistration

Aggiungere questo parametro per usare il suffisso DNS della connessione nella registrazione DNS. Questa impostazione si applica a tutte le connessioni con TCP/IP abilitato. Per specificare il suffisso DNS, usare il parametro DnsSuffix nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableIpProtocolFiltering

Aggiungere questo parametro per filtrare alcuni protocolli IP. Per abilitare il filtro TCP/IP, usare il parametro EnableTcpIpFiltering nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableLmHosts

Aggiungere questo parametro per abilitare la ricerca LMHOSTS.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableTcpFiltering

Aggiungere questo parametro per filtrare alcune porte TCP. Per abilitare il filtro TCP/IP, usare il parametro EnableTcpIpFiltering nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableUdpFiltering

Aggiungere questo parametro per filtrare alcune porte UDP. Per abilitare il filtro TCP/IP, usare il parametro EnableTcpIpFiltering nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Gateway

Se questa connessione non usa DHCP, usare questo parametro per specificare uno o più indirizzi gateway.

Se necessario, usare il parametro Metric . Per impostazione predefinita, il gateway usa una metrica automatica.

Tipo:String[]
Alias:GatewayIpAddress, GatewayIpAddresses
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IpAddress

Se questa connessione non usa DHCP, usare questo parametro per specificare uno o più indirizzi IP e le subnet mask corrispondenti. Il valore è una tabella hash. Il primo valore è e IP il secondo è .Mask

Ad esempio: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }

Se è necessario specificare più di una combinazione di indirizzo IP e subnet mask, usare una matrice di tabelle hash.

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

Tipo:Hashtable[]
Alias:NetworkSettingIpAddress, NetworkSettingIpAddresses
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IpProtocolFilterList

Quando si usa il parametro EnableIpProtocolFiltering , usare questo parametro per specificare uno o più protocolli IP.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Metric

Specificare la metrica che indica il costo dell'uso del gateway. Se non si specifica questo parametro, il gateway usa una metrica automatica.

Tipo:Int32
Alias:GatewayCostMetric
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare un nome univoco per questa connessione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TcpFilterPortList

Quando si usa il parametro EnableTcpFiltering , usare questo parametro per specificare una o più porte TCP.

Tipo:Int32[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TcpIpNetbiosOption

Specificare se abilitare o disabilitare NetBIOS su TCP/IP.

Tipo:NetbiosOption
Valori accettati:Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UdpFilterPortList

Quando si usa il parametro EnableUdpFiltering , usare questo parametro per specificare una o più porte UDP.

Tipo:Int32[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Wins

Specificare uno o più indirizzi server WINS.

Tipo:String[]
Alias:WinsServerAddress, WinsServerAddresses
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_NetworkAdapterSettings classe WMI del server.