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」を参照してください。