New-CMTSStepApplyNetworkSetting
[ネットワークの適用] 設定作成し、タスク シーケンスに追加できます。
構文
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>]
説明
このコマンドレットは、新しいApply Network 設定作成します。 次に 、Add-CMTaskSequenceStep コマンドレットを使用して、手順をタスク シーケンスに追加します。 この手順の詳細については、「タスク シーケンスの手順について: ネットワーク を適用する」を参照設定。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。
例
例 1
この例では、最初に ConvertTo-SecureString 組み込みコマンドレットを使用して、ユーザー パスワードのセキュリティで保護された文字列を作成します。 このメソッドは簡単な例として使用されますが、テキスト形式のパスワードがスクリプト内にあるので、最も安全ではありません。 このコマンドレットと他のオプションの詳細については 、「ConvertTo-SecureString」を参照してください。
次の行では、セキュリティで保護された文字列パスワード変数を設定、 ネットワークの適用手順のオブジェクトを作成します。
次に、タスク シーケンス オブジェクトを取得し、インデックス 11 のタスク シーケンスにこの新しい手順を追加します。
$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
パラメーター
この手順に追加するネットワーク アダプター設定オブジェクトを指定します。 このオブジェクトを取得するには 、New-CMTSNetworkAdapterSetting コマンドレットを使用 します。
| Type: | IResultObject[] |
| Aliases: | AddAdapterSettings |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば 、Get-CMTSStepConditionVariable です。
| Type: | IResultObject[] |
| Aliases: | Conditions |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットを実行する前に確認メッセージを表示します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターを追加して、エラー時にステップ オプション [続行] を有効にします。 このオプションを有効にすると、手順が失敗した場合、タスク シーケンスは続行されます。
| Type: | SwitchParameter |
| 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 |
このパラメーターを追加して、このタスク シーケンス ステップを無効にします。
| Type: | SwitchParameter |
| Aliases: | DisableThisStep |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
DNS サフィックスを指定します。 たとえば、corp.contoso.com などです。 この設定は、TCP/IP が有効になっているすべての接続に適用されます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コンピューターがドメインに参加するためにこの手順を構成するには、このパラメーターを使用して参加するドメインの名前を指定します。 次に、次の他のパラメーターを使用します。
- DomainOU: 必要に応じて、新しいコンピューター アカウントを作成する組織単位を指定します。
- UserName: コンピューターをドメインに参加するためのアクセス許可を持つユーザー アカウントを指定します。
- UserPassword: ユーザー アカウントのパスワードを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
DomainName パラメーターを 使用する 場合は、組織単位 (OU) へのパスを指定することもできます。 コンピューターがドメインに参加すると、新しいコンピューター アカウントが作成された場合、そのアカウントはこの OU に含まれる。
たとえば、LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com のように指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
接続の TCP/IP フィルターを有効にするには、このパラメーターを追加します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| 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 |
DomainName パラメーターを 使用する 場合は、このパラメーターを使用して、宛先コンピューターをドメインに追加するために使用するドメイン ユーザー アカウントを指定します。 アカウント パスワード を指定するには、UserPassword パラメーターを使用します。
詳細については、「タスク シーケンス ドメイン 参加アカウント」を参照してください。
| Type: | String |
| Aliases: | DomainUserName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
UserName パラメーターのセキュリティで保護された文字列として パスワードを指定 します。
| Type: | SecureString |
| Aliases: | DomainUserPassword |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 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_ApplyNetworkSettingsAction WMI クラス」を参照してください。