New-CMTSStepJoinDomainWorkgroup
建立 加入網域或工作組 步驟，您可以將其新增至任務順序。
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>] Description
此 Cmdlet 會建立新的 加入網域或工作組 步驟物件。 然後使用 CMTaskSequenceStep Cmdlet，將步驟新增至任務順序。 如需此步驟的詳細資訊，請參閱 關於任務順序的步驟：加入網域或工作組。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。
範例
範例 1
這個範例會先使用 ConvertTo SecureString 內建 Cmdlet，建立使用者密碼的安全字串。 此方法的範例是簡單的範例，但不是最安全的範例，因為純文字密碼是在腳本中。 如需此 Cmdlet 及其他選項的詳細資訊，請參閱 ConvertTo SecureString。
下一行使用安全字串密碼變數，建立 加入網域或工作組 步驟的物件。
然後，它會取得任務順序物件，並將此新步驟加入至索引11的任務順序。
$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參數
-Confirm
執行 Cmdlet 之前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContinueOnError
新增此參數以啟用 [步驟] 選項 [ 在錯誤時繼續] 選項。 當您啟用此選項時，任務順序會繼續執行。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定此任務順序步驟的選用描述。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainName
若要將此步驟設定為讓電腦加入網域，請使用此參數指定要加入的網功能變數名稱稱。 然後使用下列其他參數：
- DomainOU：（選用）指定要在其中建立新電腦帳戶的組織單位。
- UserName：指定具有將電腦加入網域之許可權的使用者帳戶。
- UserPassword：指定使用者帳戶的密碼。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OU
當您使用 DomainName 參數時，您也可以指定組織單位 (OU) 的路徑。 當電腦加入網域時，如果它建立新的電腦帳戶，該帳戶就會在此 OU 中。
例如，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
當您使用 DomainName 參數時，請使用此參數指定用來將目的地電腦新增至網域的網域使用者帳戶。 使用 UserPassword 參數可指定帳戶密碼。
如需詳細資訊，請參閱 任務順序網域加入帳戶。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserPassword
指定密碼做為 UserName 參數的安全字串。
| Type: | SecureString |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkgroupName
若要將此步驟設定為讓電腦加入工作組，請使用此參數來指定工作組名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-停用
新增此參數以停用此任務序列步驟。
| Type: | SwitchParameter |
| Aliases: | DisableThisStep |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-名稱
指定此步驟的名稱，以在任務順序中識別。
| Type: | String |
| Aliases: | StepName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-條件
指定要與此步驟搭配使用的 condition 物件。 若要取得此物件，請使用其中一個工作順序條件 Cmdlet。 例如， CMTSStepConditionVariable。
| Type: | IResultObject[] |
| Aliases: | Conditions |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
無
輸出
IResultObject
備註
如需此 return 物件及其屬性的詳細資訊，請參閱 SMS_TaskSequence_JoinDomainWorkgroupAction SERVER WMI 類別。