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

パラメーター

-AddAdapterSetting

この手順に追加するネットワーク アダプター設定オブジェクトを指定します。 このオブジェクトを取得するには 、New-CMTSNetworkAdapterSetting コマンドレットを使用 します。

Type:IResultObject[]
Aliases:AddAdapterSettings
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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
-DnsSuffix

DNS サフィックスを指定します。 たとえば、corp.contoso.com などです。 この設定は、TCP/IP が有効になっているすべての接続に適用されます。

Type:String
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
-DomainOU

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
-EnableTcpIpFiltering

接続の TCP/IP フィルターを有効にするには、このパラメーターを追加します。

Type:SwitchParameter
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
-UserName

DomainName パラメーターを 使用する 場合は、このパラメーターを使用して、宛先コンピューターをドメインに追加するために使用するドメイン ユーザー アカウントを指定します。 アカウント パスワード を指定するには、UserPassword パラメーターを使用します。

詳細については、「タスク シーケンス ドメイン 参加アカウント」を参照してください

Type:String
Aliases:DomainUserName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserPassword

UserName パラメーターのセキュリティで保護された文字列として パスワードを指定 します。

Type:SecureString
Aliases:DomainUserPassword
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_ApplyNetworkSettingsAction WMI クラス」を参照してください