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