New-CMTSNetworkAdapterSetting

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie im Tasksequenzschritt Netzwerkeinstellungen anwenden ein Einstellungsobjekt für einen Netzwerkadapter.

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 AddAdapterSetting-Parameter für die Cmdlets New-CMTSStepApplyNetworkSetting oder Set-CMTSStepApplyNetworkSetting .

Weitere Informationen finden Sie unter Informationen zu Tasksequenzschritten: Anwenden von Netzwerkeinstellungen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . 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 verschiedenen Adressen definieren. Die variable $dns ist ein Array mit zwei DNS-Serveradressen. Die variable $gw 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 weitere Optionen fest.

Im letzten Teil dieses Beispiels wird ein vorhandener Schritt Netzwerkeinstellungen anwenden einer Tasksequenz namens Standardbetriebssystembereitstellung konfiguriert. Es fügt dem Schritt die Netzwerkadaptereinstellungen hinzu und konfiguriert das DNS-Suffix.

$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.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Dns

Geben Sie eine oder mehrere DNS-Serveradressen in der Reihenfolge der Verwendung an.

Typ:String[]
Aliase:DNSServerAddress, DNSServerAddresses
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableDnsRegistration

Fügen Sie diesen Parameter hinzu, um die Adressen dieser Verbindung im DNS zu registrieren. Diese Einstellung gilt für alle Verbindungen, für die TCP/IP aktiviert ist. Um das DNS-Suffix anzugeben, verwenden Sie den DnsSuffix-Parameter für die Cmdlets New-CMTSStepApplyNetworkSetting oder Set-CMTSStepApplyNetworkSetting .

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableFullDnsRegistration

Fügen Sie diesen Parameter hinzu, um das DNS-Suffix der Verbindung bei der DNS-Registrierung zu verwenden. Diese Einstellung gilt für alle Verbindungen, für die TCP/IP aktiviert ist. Um das DNS-Suffix anzugeben, verwenden Sie den DnsSuffix-Parameter für die Cmdlets New-CMTSStepApplyNetworkSetting oder Set-CMTSStepApplyNetworkSetting .

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 .

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableLmHosts

Fügen Sie diesen Parameter hinzu, um die LMHOSTS-Suche zu aktivieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 .

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 .

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Gateway

Wenn für diese Verbindung kein DHCP verwendet wird, verwenden Sie diesen Parameter, um mindestens eine Gatewayadresse anzugeben.

Verwenden Sie bei Bedarf den Parameter Metric . Standardmäßig verwendet das Gateway eine automatische Metrik.

Typ:String[]
Aliase:GatewayIpAddress, GatewayIpAddresses
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IpAddress

Wenn diese Verbindung kein DHCP verwendet, verwenden Sie diesen Parameter, um eine oder mehrere IP-Adressen und die entsprechenden 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"; } )

Typ:Hashtable[]
Aliase:NetworkSettingIpAddress, NetworkSettingIpAddresses
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IpProtocolFilterList

Wenn Sie den Parameter EnableIpProtocolFiltering verwenden, verwenden Sie diesen Parameter, um mindestens ein IP-Protokoll anzugeben.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Metric

Geben Sie die Metrik an, die die Kosten für die Verwendung des Gateways angibt. Wenn Sie diesen Parameter nicht angeben, verwendet das Gateway eine automatische Metrik.

Typ:Int32
Aliase:GatewayCostMetric
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie einen eindeutigen Namen für diese Verbindung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TcpFilterPortList

Wenn Sie den Parameter EnableTcpFiltering verwenden, verwenden Sie diesen Parameter, um einen oder mehrere TCP-Ports anzugeben.

Typ:Int32[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TcpIpNetbiosOption

Geben Sie an, ob NetBIOS über TCP/IP aktiviert oder deaktiviert werden soll.

Typ:NetbiosOption
Zulässige Werte:Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UdpFilterPortList

Wenn Sie den Parameter EnableUdpFiltering verwenden, verwenden Sie diesen Parameter, um einen oder mehrere UDP-Ports anzugeben.

Typ:Int32[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Wins

Geben Sie eine oder mehrere WINS-Serveradressen an.

Typ:String[]
Aliase:WinsServerAddress, WinsServerAddresses
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_NetworkAdapterSettings WMI-Serverklasse.