New-CMTSNetworkAdapterSetting
Creare un oggetto impostazioni per una scheda di rete nel passaggio Della Impostazioni della sequenza di attività.
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 ulteriori informazioni, vedere About task sequence steps: Apply Network Impostazioni.
Nota
Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>
. Per ulteriori informazioni, vedere Introduzione.
Esempio
Esempio 1: Aggiungere le impostazioni della scheda di rete per una connessione con più indirizzi
In questo esempio vengono innanzitutto definite tre variabili di matrice che definiscono più indirizzi. La $dns è una matrice con due indirizzi server DNS. La $gw è una matrice con due indirizzi gateway. La $ip è una matrice con due hashtable. Ogni tabella hash definisce una coppia di indirizzo IP e subnet mask.
Nella riga successiva dell'esempio viene utilizzato il cmdlet New-CMTSNetworkAdapterSetting per creare l'oggetto impostazioni della scheda di rete. Vengono utilizzate le variabili definite e vengono impostate diverse altre opzioni.
La parte finale di questo **** esempio consente di configurare un passaggio di applicazione Impostazioni di rete esistente di una sequenza di attività denominata Distribuzione predefinita del sistema operativo. 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Dns
Specificare uno o più indirizzi del server DNS in ordine di utilizzo.
Type: | String[] |
Aliases: | DNSServerAddress, DNSServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableDnsRegistration
Aggiungere questo parametro per registrare gli indirizzi di questa connessione in DNS. Questa impostazione si applica a tutte le connessioni con TCP/IP abilitato. Per specificare il suffisso DNS, utilizzare il parametro DnsSuffix nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableFullDnsRegistration
Aggiungere questo parametro per utilizzare 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, utilizzare il parametro DnsSuffix nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableIpProtocolFiltering
Aggiungere questo parametro per filtrare alcuni protocolli IP. Per abilitare il filtro TCP/IP, utilizzare il parametro EnableTcpIpFiltering nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableLmHosts
Aggiungere questo parametro per abilitare la ricerca LMHOSTS.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableTcpFiltering
Aggiungere questo parametro per filtrare alcune porte TCP. Per abilitare il filtro TCP/IP, utilizzare il parametro EnableTcpIpFiltering nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableUdpFiltering
Aggiungere questo parametro per filtrare alcune porte UDP. Per abilitare il filtro TCP/IP, utilizzare il parametro EnableTcpIpFiltering nei cmdlet New-CMTSStepApplyNetworkSetting o Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Gateway
Se questa connessione non utilizza DHCP, utilizzare questo parametro per specificare uno o più indirizzi gateway.
Se necessario, utilizzare il parametro Metric. Per impostazione predefinita, il gateway utilizza una metrica automatica.
Type: | String[] |
Aliases: | GatewayIpAddress, GatewayIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpAddress
Se questa connessione non utilizza DHCP, utilizzare questo parametro per specificare uno o più indirizzi IP e subnet mask corrispondenti. Il valore è una tabella hash. Il primo valore è il IP
e 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, utilizzare 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"; } )
Type: | Hashtable[] |
Aliases: | NetworkSettingIpAddress, NetworkSettingIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpProtocolFilterList
Quando si utilizza il parametro EnableIpProtocolFiltering, utilizzare questo parametro per specificare uno o più protocolli IP.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metric
Specificare la metrica che indica il costo dell'utilizzo del gateway. Se non si specifica questo parametro, il gateway utilizza una metrica automatica.
Type: | Int32 |
Aliases: | GatewayCostMetric |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specificare un nome univoco per la connessione.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpFilterPortList
Quando si utilizza il parametro EnableTcpFiltering, utilizzare questo parametro per specificare una o più porte TCP.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpIpNetbiosOption
Specificare se abilitare o disabilitare NetBIOS su TCP/IP.
Type: | NetbiosOption |
Accepted values: | Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UdpFilterPortList
Quando si utilizza il parametro EnableUdpFiltering, utilizzare questo parametro per specificare una o più porte UDP.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wins
Specificare uno o più indirizzi del server WINS.
Type: | String[] |
Aliases: | WinsServerAddress, WinsServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Nessuno
Output
IResultObject
Note
Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_NetworkAdapterSettings WMI server.