New-CMTSStepJoinDomainWorkgroup
Erstellen Sie einen Schritt "Domäne beitreten" oder "Arbeitsgruppe", den Sie einer Tasksequenz hinzufügen können.
Syntax
New-CMTSStepJoinDomainWorkgroup
[-DomainName <String>]
[-OU <String>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkgroupName <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Mit diesem Cmdlet wird ein neues Schrittobjekt "Join Domain" oder "Workgroup" erstellt. Verwenden Sie dann das Cmdlet "Add-CMTaskSequenceStep", um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt finden Sie unter Informationen zu den Schritten in der Tasksequenz: Domänen- oder Arbeitsgruppenbeitritt.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\>
aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel1
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 sich das Nur-Text-Kennwort im Skript befindet. 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 "Domäne beitreten" oder "Arbeitsgruppe" mithilfe der Kennwortvariablen für sichere Zeichenfolgen erstellt.
Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz bei Index 11 hinzu.
$Secure_String_Pwd = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force
$step = New-CMTSStepJoinDomainWorkgroup -Name "Join Domain or Workgroup" -DomainName "na.corp.contoso.com" -OU "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
- DomainName
Verwenden Sie diesen Parameter, um diesen Schritt so zu konfigurieren, dass der Computer einer Domäne beitritt, um den Namen einer Domäne anzugeben, der der Domäne beigetreten werden soll. Verwenden Sie dann die folgenden anderen Parameter:
- DomainOU: Geben Sie optional eine Organisationseinheit an, in der das neue Computerkonto erstellt werden soll.
- Benutzername: Geben Sie das Benutzerkonto mit Berechtigungen an, um einen Computer mit der Domäne zu verknüpfen.
- UserPassword: Geben Sie das Kennwort für das Benutzerkonto an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Bedingung
Geben Sie ein Bedingungsobjekt an, das für diesen Schritt verwendet werden soll. Um dieses Objekt abzurufen, verwenden Sie eines der Cmdlets für die Tasksequenzbedingung. Beispiel: Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 |
-ContinueOnError
Fügen Sie diesen Parameter hinzu, um die Schrittoption "Continue on error" zu aktivieren. Wenn Sie diese Option aktivieren, wird die Tasksequenz fortgesetzt, wenn der Schritt fehlschlägt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
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 |
-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 |
-Name
Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OU
Wenn Sie den Parameter "DomainName" verwenden, können Sie auch den Pfad zu einer Organisationseinheit (Organizational Unit, OU) angeben. Wenn der Computer der Domäne beitritt und ein neues Computerkonto erstellt, befindet sich dieses Konto in dieser OE.
Beispiel: LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com
Type: | String |
Aliases: | OrganizationalUnit |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Wenn Sie den Parameter "DomainName" verwenden, geben Sie mit diesem Parameter das Domänenbenutzerkonto an, das zum Hinzufügen des Zielcomputers zur Domäne verwendet wird. Verwenden Sie den Parameter UserPassword, um das Kontokennwort anzugeben.
Weitere Informationen finden Sie unter dem Konto für den Domänenbeitritt in der Tasksequenz.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPassword
Geben Sie das Kennwort als sichere Zeichenfolge für den Parameter "UserName" an.
Type: | SecureString |
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 |
-WorkgroupName
Um diesen Schritt so zu konfigurieren, dass der Computer einer Arbeitsgruppe beitritt, verwenden Sie diesen Parameter, um den Arbeitsgruppennamen anzugeben.
Type: | String |
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_JoinDomainWorkgroupAction Server-WMI-Klasse.