次の方法で共有

New-CMTSNetworkAdapterSetting

  • リファレンス
モジュール:
ConfigurationManager

ネットワーク アダプターの設定オブジェクトを作成するには、[ネットワークの適用] タスク 設定手順を実行します。

構文

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パラメーターでこのオブジェクトを使用します。

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

注意

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

例

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

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

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

この例の最後の部分では、Default 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

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

Type:SwitchParameter
Aliases:cf
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

-Dns

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

Type:String[]
Aliases:DNSServerAddress, DNSServerAddresses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableDnsRegistration

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableFullDnsRegistration

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableIpProtocolFiltering

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableLmHosts

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableTcpFiltering

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableUdpFiltering

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

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

-Gateway

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

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

Type:String[]
Aliases:GatewayIpAddress, GatewayIpAddresses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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"; } )

Type:Hashtable[]
Aliases:NetworkSettingIpAddress, NetworkSettingIpAddresses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IpProtocolFilterList

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Metric

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

Type:Int32
Aliases:GatewayCostMetric
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TcpFilterPortList

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

Type:Int32[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TcpIpNetbiosOption

TCP/IP を使用して NetBIOS を有効または無効にするかどうかを指定します。

Type:NetbiosOption
Accepted values:Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UdpFilterPortList

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

Type:Int32[]
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

-Wins

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

Type:String[]
Aliases:WinsServerAddress, WinsServerAddresses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

入力

なし

出力

IResultObject

メモ

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