New-CMTSStepJoinDomainWorkgroup
タスク シーケンス に追加できる参加 ドメインまたはワークグループ ステップを作成します。
構文
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>]
説明
このコマンドレットは、新しい Join Domain またはワークグループ ステップ オブジェクトを 作成します。 次に 、Add-CMTaskSequenceStep コマンドレットを使用して、手順をタスク シーケンスに追加します。 この手順の詳細については、「タスク シーケンスの手順 について:ドメインまたはワークグループに参加する」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1
この例では、最初に ConvertTo-SecureString 組み込みコマンドレットを使用して、ユーザー パスワードのセキュリティで保護された文字列を作成します。 このメソッドは簡単な例として使用されますが、テキスト形式のパスワードがスクリプト内にあるので、最も安全ではありません。 このコマンドレットと他のオプションの詳細については 、「ConvertTo-SecureString」を参照してください。
次の行では、セキュリティで保護された文字列パスワード変数を使用して、Join Domain または ワーク グループ ステップのオブジェクトを作成します。
次に、タスク シーケンス オブジェクトを取得し、インデックス 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
パラメーター
-Condition
この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば 、Get-CMTSStepConditionVariable です。
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
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 |
-Disable
このパラメーターを追加して、このタスク シーケンス ステップを無効にします。
Type: | SwitchParameter |
Aliases: | DisableThisStep |
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 |
-Name
タスク シーケンスで識別するには、この手順の名前を指定します。
Type: | String |
Aliases: | StepName |
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
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ワークグループ名
この手順を構成してコンピューターをワークグループに参加するには、このパラメーターを使用してワークグループ名を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
なし
出力
IResultObject
メモ
この戻り値オブジェクトとそのプロパティの詳細については、「SMS_TaskSequence_JoinDomainWorkgroupAction WMI クラス」を参照してください。