New-CMTSNetworkAdapterSetting
Erstellen Sie ein Einstellungsobjekt für einen Netzwerkadapter im Tasksequenzschritt "Netzwerk anwenden" Einstellungen.
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>]
Beschreibung
Dieses Cmdlet erstellt ein Netzwerkadaptereinstellungsobjekt. Verwenden Sie dieses Objekt mit dem Parameter "AddAdapterSetting" für die Cmdlets "New-CMTSStepApplyNetworkSetting" oder "Set-CMTSStepApplyNetworkSetting".
Weitere Informationen finden Sie unter "Schritte zur Tasksequenz": Netzwerk Einstellungen anwenden.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\>
aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel 1: Hinzufügen von Netzwerkadaptereinstellungen für eine Verbindung mit mehreren Adressen
In diesem Beispiel werden zunächst drei Arrayvariablen definiert, die die mehreren Adressen definieren. Die $dns Variable ist ein Array mit zwei DNS-Serveradressen. Die $gw Variable ist ein Array mit zwei Gatewayadressen. Die $ip-Variable ist ein Array mit zwei Hashtabellen. Jede Hashtabelle definiert ein Paar aus IP-Adresse und Subnetzmaske.
In der nächsten Zeile des Beispiels wird das Cmdlet "New-CMTSNetworkAdapterSetting" verwendet, um das Netzwerkadaptereinstellungsobjekt zu erstellen. Es verwendet die definierten Variablen und legt mehrere andere Optionen fest.
Im letzten Teil dieses Beispiels wird ein vorhandener Schritt "Netzwerk anwenden" Einstellungen einer Tasksequenz mit dem Namen Standardbetriebssystembereitstellungkonfiguriert. Dem Schritt werden die Netzwerkadaptereinstellungen hinzugefügt und das DNS-Suffix konfiguriert.
$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"
Parameter
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Dns
Geben Sie eine oder mehrere DNS-Serveradressen in der Reihenfolge der Verwendung an.
Type: | String[] |
Aliases: | DNSServerAddress, DNSServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableDnsRegistration
Fügen Sie diesen Parameter hinzu, um die Adressen dieser Verbindung im DNS zu registrieren. Diese Einstellung gilt für alle Verbindungen, bei denen TCP/IP aktiviert ist. Um das DNS-Suffix anzugeben, verwenden Sie den DnsSuffix-Parameter für die Cmdlets New-CMTSStepApplyNetworkSetting oder Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableFullDnsRegistration
Fügen Sie diesen Parameter hinzu, um das DNS-Suffix der Verbindung in der DNS-Registrierung zu verwenden. Diese Einstellung gilt für alle Verbindungen, bei denen TCP/IP aktiviert ist. Um das DNS-Suffix anzugeben, verwenden Sie den DnsSuffix-Parameter für die Cmdlets New-CMTSStepApplyNetworkSetting oder Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableIpProtocolFiltering
Fügen Sie diesen Parameter hinzu, um einige IP-Protokolle zu filtern. Verwenden Sie zum Aktivieren der TCP/IP-Filterung den Parameter "EnableTcpIpFiltering" für die Cmdlets "New-CMTSStepApplyNetworkSetting" oder "Set-CMTSStepApplyNetworkSetting".
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableLmHosts
Fügen Sie diesen Parameter hinzu, um die LMHOSTS-Suche zu aktivieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableTcpFiltering
Fügen Sie diesen Parameter hinzu, um einige TCP-Ports zu filtern. Verwenden Sie zum Aktivieren der TCP/IP-Filterung den Parameter "EnableTcpIpFiltering" für die Cmdlets "New-CMTSStepApplyNetworkSetting" oder "Set-CMTSStepApplyNetworkSetting".
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableUdpFiltering
Fügen Sie diesen Parameter hinzu, um einige UDP-Ports zu filtern. Verwenden Sie zum Aktivieren der TCP/IP-Filterung den Parameter "EnableTcpIpFiltering" für die Cmdlets "New-CMTSStepApplyNetworkSetting" oder "Set-CMTSStepApplyNetworkSetting".
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Gateway
Wenn für diese Verbindung kein DHCP verwendet wird, verwenden Sie diesen Parameter, um eine oder mehrere Gatewayadressen anzugeben.
Verwenden Sie bei Bedarf den Parameter "Metric". Standardmäßig verwendet das Gateway eine automatische Metrik.
Type: | String[] |
Aliases: | GatewayIpAddress, GatewayIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpAddress
Wenn für diese Verbindung kein DHCP verwendet wird, verwenden Sie diesen Parameter, um eine oder mehrere IP-Adressen und entsprechende Subnetzmasken anzugeben. Der Wert ist eine Hashtabelle. Der erste Wert ist der IP
und der zweite Wert ist der Mask
.
Beispiel: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }
Wenn Sie mehr als eine Kombination aus IP-Adresse und Subnetzmaske angeben müssen, verwenden Sie ein Array von Hashtabellen.
Beispiel: @( @{ 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
Wenn Sie den Parameter EnableIpProtocolFiltering verwenden, verwenden Sie diesen Parameter, um ein oder mehrere IP-Protokolle anzugeben.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metric
Geben Sie die Metrik an, die die Kosten für die Verwendung des Gatewaysangibt. Wenn Sie diesen Parameter nicht angeben, verwendet das Gateway eine automatische Metrik.
Type: | Int32 |
Aliases: | GatewayCostMetric |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Geben Sie einen eindeutigen Namen für diese Verbindung an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpFilterPortList
Wenn Sie den Parameter EnableTcpFiltering verwenden, verwenden Sie diesen Parameter, um einen oder mehrere TCP-Ports anzugeben.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpIpNetbiosOption
Geben Sie an, ob NetBIOS über TCP/IP aktiviert oder deaktiviert werden soll.
Type: | NetbiosOption |
Accepted values: | Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UdpFilterPortList
Wenn Sie den Parameter EnableUdpFiltering verwenden, verwenden Sie diesen Parameter, um einen oder mehrere UDP-Ports anzugeben.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wins
Geben Sie eine oder mehrere WINS-Serveradressen an.
Type: | String[] |
Aliases: | WinsServerAddress, WinsServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Keine
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_NetworkAdapterSettings Server-WMI-Klasse.