Freigeben über


New-CMTSStepApplyNetworkSetting

Erstellen Sie einen Schritt Netzwerkeinstellungen anwenden , den Sie einer Tasksequenz hinzufügen können.

Syntax

New-CMTSStepApplyNetworkSetting
   [-AddAdapterSetting <IResultObject[]>]
   [-DnsSuffix <String>]
   [-DomainName <String>]
   [-DomainOU <String>]
   [-EnableTcpIpFiltering]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkgroupName <String>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Dieses Cmdlet erstellt ein neues Schrittobjekt zum Anwenden von Netzwerkeinstellungen . Verwenden Sie dann das Cmdlet Add-CMTaskSequenceStep , um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt 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

In diesem Beispiel wird zunächst das integrierte Cmdlet ConvertTo-SecureString verwendet, um eine sichere Zeichenfolge für das Benutzerkennwort zu erstellen. Diese Methode wird hier als einfaches Beispiel verwendet, aber nicht die sicherste, da das Nur-Text-Kennwort im Skript enthalten ist. Weitere Informationen zu diesem Cmdlet und anderen Optionen finden Sie unter ConvertTo-SecureString.

In der nächsten Zeile wird ein -Objekt für den Schritt Netzwerkeinstellungen anwenden mithilfe der Kennwortvariablen für sichere Zeichenfolgen erstellt.

Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz am Index 11 hinzu.

$Secure_String_Pwd = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force

$step = New-CMTSStepApplyNetworkSetting -Name "Apply network settings" -DnsSuffix "corp.contoso.com" -DomainName "na.corp.contoso.com" -DomainOU "LDAP://OU=Ops,OU=ITS,DC=na,DC=corp,DC=contoso,DC=com" -UserName "contoso\_cmosdjoin" -UserPassword $Secure_String_Pwd

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

Parameter

-AddAdapterSetting

Geben Sie ein Netzwerkadaptereinstellungsobjekt an, das diesem Schritt hinzugefügt werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet New-CMTSNetworkAdapterSetting .

Typ:IResultObject[]
Aliase:AddAdapterSettings
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Condition

Geben Sie ein Bedingungsobjekt an, das mit diesem Schritt verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts eines der Tasksequenzbedingungs-Cmdlets. Beispiel: Get-CMTSStepConditionVariable.

Typ:IResultObject[]
Aliase:Conditions
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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

-ContinueOnError

Fügen Sie diesen Parameter hinzu, um die Schrittoption Bei Fehler fortsetzen zu aktivieren. Wenn Sie diese Option aktivieren und der Schritt fehlschlägt, wird die Tasksequenz fortgesetzt.

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

-Description

Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.

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

-Disable

Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.

Typ:SwitchParameter
Aliase:DisableThisStep
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

-DnsSuffix

Geben Sie das DNS-Suffix an. Beispiel: corp.contoso.com. Diese Einstellung wird auf alle Verbindungen angewendet, für die TCP/IP aktiviert ist.

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

-DomainName

Um diesen Schritt so zu konfigurieren, dass der Computer einer Domäne beitritt, verwenden Sie diesen Parameter, um den Namen einer Domäne anzugeben, der beitreten soll. Verwenden Sie dann die folgenden anderen Parameter:

  • DomainOU: Geben Sie optional eine Organisationseinheit an, in der das neue Computerkonto erstellt werden soll.
  • UserName: Geben Sie das Benutzerkonto mit Berechtigungen an, um einen Computer in die Domäne einzubinden.
  • UserPassword: Geben Sie das Kennwort für das Benutzerkonto an.
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainOU

Wenn Sie den Parameter DomainName verwenden, können Sie auch den Pfad zu einer Organisationseinheit (OE) angeben. Wenn der Computer der Domäne beigetreten ist und ein neues Computerkonto erstellt wird, befindet sich dieses Konto in dieser Organisationseinheit.

Beispiel: LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com

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

-EnableTcpIpFiltering

Fügen Sie diesen Parameter hinzu, um die TCP/IP-Filterung für die Verbindung zu aktivieren.

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

-Name

Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.

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

-UserName

Wenn Sie den Parameter DomainName verwenden, verwenden Sie diesen Parameter, um das Domänenbenutzerkonto anzugeben, das zum Hinzufügen des Zielcomputers zur Domäne verwendet wird. Verwenden Sie den Parameter UserPassword , um das Kontokennwort anzugeben.

Weitere Informationen finden Sie im Tasksequenzdomänenbeitrittskonto.

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

-UserPassword

Geben Sie das Kennwort als sichere Zeichenfolge für den UserName-Parameter an.

Typ:SecureString
Aliase:DomainUserPassword
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

-WorkgroupName

Um diesen Schritt so zu konfigurieren, dass der Computer einer Arbeitsgruppe beitritt, verwenden Sie diesen Parameter, um den Arbeitsgruppennamen anzugeben.

Typ:String
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_ApplyNetworkSettingsAction WMI-Serverklasse.