Add-SCNetworkService

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

VMM にネットワーク サービスを追加します。

構文

Add-SCNetworkService
   [-ProvisionSelfSignedCertificatesForNetworkService <Boolean>]
   [-VMMServer <ServerConnection>]
   [-ConnectionString] <String>
   -Manufacturer <String>
   -Model <String>
   [-Version <String>]
   -RunAsAccount <RunAsAccount>
   -VMHostGroup <HostGroup[]>
   -Name <String>
   [-Description <String>]
   [-BandwidthCapacityKBps <UInt64>]
   [-Certificate <ClientCertificate[]>]
   [-LogicalNetworkVIP <LogicalNetwork[]>]
   [-LogicalNetworkDedicatedIP <LogicalNetwork[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCNetworkService
   [-ProvisionSelfSignedCertificatesForNetworkService <Boolean>]
   [-VMMServer <ServerConnection>]
   [-ConnectionString] <String>
   [-Version <String>]
   -RunAsAccount <RunAsAccount>
   -VMHostGroup <HostGroup[]>
   -Name <String>
   [-Description <String>]
   -ConfigurationProvider <ConfigurationProvider>
   [-BandwidthCapacityKBps <UInt64>]
   [-Certificate <ClientCertificate[]>]
   [-LogicalNetworkVIP <LogicalNetwork[]>]
   [-LogicalNetworkDedicatedIP <LogicalNetwork[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Add-SCNetworkService コマンドレットは、仮想マシン マネージャー (VMM) にネットワーク サービスを追加します。

例

例 1: ネットワーク コントローラーのネットワーク サービスを VMM に追加する

PS C:\> $RunAsAccount = Get-SCRunAsAccount -ID "dc90a558-c402-4a70-9f6b-e50bc2fad540"
PS C:\> $ConfigurationProvider = Get-SCConfigurationProvider -Name "Microsoft Network Controller"
PS C:\> $VmHostGroup = @()
PS C:\> $VmHostGroup += Get-SCVMHostGroup -Name "All Hosts"
PS C:\> $Certificates = @()
PS C:\> $Certificates += Get-SCCertificate -ComputerName "networkcontroller.contoso.com" -TCPPort 443
PS C:\> Add-SCNetworkService -Name "NetworkController" -RunAsAccount $runAsAccount -ConfigurationProvider $ConfigurationProvider -VMHostGroup $vmHostGroup -ConnectionString "serverUrl=https://networkcontroller.contoso.com;serviceName=NC_Service" -Certificate $Certificates -ProvisionSelfSignedCertificatesForNetworkService $True

最初のコマンドは、VMM がネットワーク サービスと通信するために使用する実行アカウントを取得します。 このコマンドは、$RunAsAccount変数に格納します。

2 番目のコマンドは、ネットワーク コントローラーの構成プロバイダーを取得します。

3 番目のコマンドは、$VmHostGroupという名前の配列変数を作成します。 4 番目のコマンドは、ネットワーク サービスが$VmHostGroupにアクセスできるホスト グループを追加します。

5 番目のコマンドは、$Certificatesという名前の配列変数を作成します。 6 番目のコマンドは、ネットワーク コントローラーで使用可能な証明書を$Certificatesに追加します。

最後のコマンドは、ネットワーク コントローラーのネットワーク サービスを VMM に追加します。 このコマンドは、前のコマンドで作成した値を指定します。 この例では、ネットワーク コントローラーに自己署名証明書を使用するため、 ProvisionSelfSignedCertificatesForNetworkService の値は $True。

パラメーター

-BandwidthCapacityKBps

ネットワーク サービスの帯域幅容量をキロバイト/秒 (KBps) 単位で指定します。

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

-Certificate

セキュリティ証明書オブジェクトの配列を指定します。

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

-ConfigurationProvider

構成プロバイダー オブジェクトを指定します。

構成プロバイダーは、VMM PowerShell コマンドをロード バランサーの種類に固有の API 呼び出しに変換する VMM へのプラグインです。 構成プロバイダーが指定されていない場合、VMM は製造元とモデルの情報を使用して、使用可能な構成プロバイダーを選択します。 構成プロバイダーが見つからない場合、ロード バランサーは追加されません。

Type:ConfigurationProvider
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionString

仮想スイッチ拡張機能マネージャーに接続するために必要な情報を指定します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

ネットワーク サービスの説明を指定します。

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

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

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

-LogicalNetworkDedicatedIP

論理ネットワーク オブジェクトの配列を指定します。

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

-LogicalNetworkVIP

論理ネットワーク オブジェクトの配列を指定します。

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

-Manufacturer

物理デバイスを製造した会社の名前を指定します。 このパラメーターの有効値は、次のとおりです。

  • 文字 (a ~ z)
  • 数値 (0 - 9)
  • アンダースコア (_)
  • ハイフン (-)
  • ドット (.)
  • 単一引用符 (')
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Model

物理デバイスのモデルを指定します。

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

-Name

ネットワーク オブジェクトの名前を指定します。

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

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

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

-ProvisionSelfSignedCertificatesForNetworkService

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

-RunAsAccount

このアクションを実行するアクセス許可を持つ資格情報を含む実行アカウントを指定します。

Type:RunAsAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

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

-Version

バージョンを指定します。

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

-VMHostGroup

仮想マシン ホスト グループ オブジェクトまたはホスト グループ オブジェクトの配列を指定します。

Type:HostGroup[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

VMM サーバー オブジェクトを指定します。

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False