New-CMTSNetworkAdapterSetting

[ネットワーク設定の適用] タスク シーケンス ステップで 、ネットワーク アダプターの設定オブジェクトを作成します。

構文

New-CMTSNetworkAdapterSetting
   [-Dns <String[]>]
   [-EnableDnsRegistration]
   [-EnableFullDnsRegistration]
   [-EnableIpProtocolFiltering]
   [-EnableLmHosts]
   [-EnableTcpFiltering]
   [-EnableUdpFiltering]
   [-Gateway <String[]>]
   [-IpAddress <Hashtable[]>]
   [-IpProtocolFilterList <String[]>]
   [-Metric <Int32>]
   -Name <String>
   [-TcpFilterPortList <Int32[]>]
   [-TcpIpNetbiosOption <NetbiosOption>]
   [-UdpFilterPortList <Int32[]>]
   [-Wins <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットは、ネットワーク アダプター設定オブジェクトを作成します。 このオブジェクトは、New-CMTSStepApplyNetworkSetting コマンドレットまたは Set-CMTSStepApplyNetworkSetting コマンドレットの AddAdapterSetting パラメーターと共使用します。

詳細については、「 タスク シーケンスの手順について: ネットワーク設定を適用する」を参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例 1: 複数のアドレスを持つ接続のネットワーク アダプター設定を追加する

この例では、最初に、複数のアドレスを定義する 3 つの配列変数を定義します。 $dns変数は、2 つの DNS サーバー アドレスを持つ配列です。 $gw変数は、2 つのゲートウェイ アドレスを持つ配列です。 $ip変数は、2 つのハッシュテーブルを持つ配列です。 各ハッシュテーブルは、IP アドレスとサブネット マスク のペアを定義します。

この例の次の行では、 New-CMTSNetworkAdapterSetting コマンドレットを使用して、ネットワーク アダプター設定オブジェクトを作成します。 定義された変数を使用し、他のいくつかのオプションを設定します。

この例の最後の部分では、既定の OS 展開という名前のタスク シーケンスの既存の [ネットワーク設定の適用] ステップを構成します。 ネットワーク アダプターの設定を手順に追加し、DNS サフィックスを構成します。

$dns = @("192.168.1.100","10.0.1.100")
$gw = @("192.168.1.1","10.0.1.1")

$ip = @(
    @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; },
    @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; }
)

$conn1 = New-CMTSNetworkAdapterSetting -Name "local connection" -Dns $dns -EnableDnsRegistration -EnableFullDnsRegistration -Gateway $gw -IpAddress $ip -TcpIpNetbiosOption DisableNetbiosOverTcpip

$tsNameOsd = "Default OS deployment"
$tsStepNameApplyNetSet = "Apply Network Settings"

Set-CMTSStepApplyNetworkSetting -TaskSequenceName $tsNameOsd -StepName $tsStepNameApplyNetSet -AddAdapterSetting $conn1 -DnsSuffix "corp.contoso.com"

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Dns

使用順に 1 つ以上の DNS サーバー アドレスを指定します。

型:String[]
Aliases:DNSServerAddress, DNSServerAddresses
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableDnsRegistration

このパラメーターを追加して、この接続のアドレスを DNS に登録します。 この設定は、TCP/IP が有効になっているすべての接続に適用されます。 DNS サフィックスを指定するには、New-CMTSStepApplyNetworkSetting コマンドレットまたは Set-CMTSStepApplyNetworkSetting コマンドレットで DnsSuffix パラメーターを使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableFullDnsRegistration

DNS 登録で接続の DNS サフィックスを使用するには、このパラメーターを追加します。 この設定は、TCP/IP が有効になっているすべての接続に適用されます。 DNS サフィックスを指定するには、New-CMTSStepApplyNetworkSetting コマンドレットまたは Set-CMTSStepApplyNetworkSetting コマンドレットで DnsSuffix パラメーターを使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableIpProtocolFiltering

このパラメーターを追加して、一部の IP プロトコルをフィルター処理します。 TCP/IP フィルタリングを有効にするには、New-CMTSStepApplyNetworkSetting コマンドレットまたは Set-CMTSStepApplyNetworkSetting コマンドレットで EnableTcpIpFiltering パラメーターを使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableLmHosts

LMHOSTS 参照を有効にするには、このパラメーターを追加します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableTcpFiltering

一部の TCP ポートをフィルター処理するには、このパラメーターを追加します。 TCP/IP フィルタリングを有効にするには、New-CMTSStepApplyNetworkSetting コマンドレットまたは Set-CMTSStepApplyNetworkSetting コマンドレットで EnableTcpIpFiltering パラメーターを使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableUdpFiltering

一部の UDP ポートをフィルター処理するには、このパラメーターを追加します。 TCP/IP フィルタリングを有効にするには、New-CMTSStepApplyNetworkSetting コマンドレットまたは Set-CMTSStepApplyNetworkSetting コマンドレットで EnableTcpIpFiltering パラメーターを使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Gateway

この接続で DHCP を使用しない場合は、このパラメーターを使用して 1 つ以上のゲートウェイ アドレスを指定します。

必要に応じて、 Metric パラメーターを使用します。 既定では、ゲートウェイは自動メトリックを使用します。

型:String[]
Aliases:GatewayIpAddress, GatewayIpAddresses
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IpAddress

この接続で DHCP を使用しない場合は、このパラメーターを使用して、1 つ以上の IP アドレスと対応するサブネット マスクを指定します。 値はハッシュテーブルです。 最初の値は IP 、2 番目の値は Maskです。

例: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }

複数の IP アドレスとサブネット マスクの組み合わせを指定する必要がある場合は、ハッシュテーブルの配列を使用します。

例: @( @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }, @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; } )

型:Hashtable[]
Aliases:NetworkSettingIpAddress, NetworkSettingIpAddresses
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IpProtocolFilterList

EnableIpProtocolFiltering パラメーターを使用する場合は、このパラメーターを使用して 1 つ以上の IP プロトコルを指定します。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Metric

ゲートウェイを使用するコストを示すメトリックを指定 します。 このパラメーターを指定しない場合、ゲートウェイは自動メトリックを使用します。

型:Int32
Aliases:GatewayCostMetric
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

この接続の一意の名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TcpFilterPortList

EnableTcpFiltering パラメーターを使用する場合は、このパラメーターを使用して 1 つ以上の TCP ポートを指定します。

型:Int32[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TcpIpNetbiosOption

TCP/IP 経由で NetBIOS を有効または無効にするかどうかを指定します。

型:NetbiosOption
指定可能な値:Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UdpFilterPortList

EnableUdpFiltering パラメーターを使用する場合は、このパラメーターを使用して 1 つ以上の UDP ポートを指定します。

型:Int32[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Wins

1 つ以上の WINS サーバー アドレスを指定します。

型:String[]
Aliases:WinsServerAddress, WinsServerAddresses
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_NetworkAdapterSettings」を参照してください。