New-SCVMConfiguration

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

仮想マシン テンプレートから仮想マシン構成を作成します。

構文

New-SCVMConfiguration
   -VMTemplate <Template>
   [-Name <String>]
   [-Description <String>]
   [-CostCenter <String>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMConfiguration
   -VMTemplate <Template>
   -Name <String>
   [-Description <String>]
   -Cloud <Cloud>
   [-CostCenter <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMConfiguration
   -VMTemplate <Template>
   -Name <String>
   [-Description <String>]
   -VMHostGroup <HostGroup>
   [-CostCenter <String>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMConfiguration
   -ComputerTier <ComputerTier>
   [-Name <String>]
   [-Description <String>]
   [-CostCenter <String>]
   [-ComputerName <String>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

New-SCVMConfiguration コマンドレットは、仮想マシン テンプレートから仮想マシン構成を作成します。 仮想マシン構成は、仮想マシン構成をデプロイするときに使用するインスタンス固有の値を指定するために使用されます。

例

例 1: ホスト グループに仮想マシンを配置するための仮想マシン構成を作成する

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "Production"
PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $VMConfig = New-SCVMConfiguration -VMTemplate $VMTemplate -VMHostGroup $HostGroup -CostCenter 1234 -Name "VMConfig01"

最初のコマンドは、Production という名前のホスト グループ オブジェクトを取得し、そのオブジェクトを $HostGroup 変数に格納します。

2 番目のコマンドは、すべての仮想マシン テンプレート オブジェクトを取得し、VMTemplate01 という名前のテンプレートを選択し、そのオブジェクトを $VMTemplate 変数に格納します。

最後のコマンドでは、$HostGroupに格納されているホスト グループにデプロイするために、$VMTemplateに格納されている仮想マシン テンプレートの VMConfig01 という名前の仮想マシン構成を作成し、コスト センターの値として 1234 を指定します。

パラメーター

-AvailabilitySetNames

可用性セット名の一覧を指定します。

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CapabilityProfile

機能プロファイル オブジェクトを指定します。

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

-Cloud

プライベート クラウド オブジェクトを指定します。

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

-ComputerName

ネットワーク内で Virtual Machine Manager が一意に識別できるコンピュータの名前を指定します。 有効な形式:

  • FQDN
  • IPv4 アドレス
  • IPv6 アドレス
  • NetBIOS 名
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerTier

コンピューター層オブジェクトを指定します。

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

-CostCenter

仮想マシン (または仮想マシンに割り当てられたリソース) の割り当てに関するデータを収集して、課金システムで使用できるように、仮想マシンのコスト センターを指定します。

Type:String
Position:Named
Default value:None
Required:False
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

-Name

仮想マシン マネージャー (VMM) オブジェクトの名前を指定します。

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

-OnBehalfOfUser

ユーザーの名前を指定します。 このコマンドレットは、このパラメーターが指定するユーザーとしてユーザーの代理を設定します。

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

-OnBehalfOfUserRole

ユーザー ロールを指定します。 このコマンドレットは、このパラメーターが指定するユーザー ロールとしてユーザー ロールの代理を設定します。 ユーザー ロール オブジェクトを取得するには、 Get-SCUserRole コマンドレットを 使用します。

Type:UserRole
Position:Named
Default value:None
Required:False
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

-RunAsynchronously

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

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

-VMTemplate

仮想マシンの作成に使用する VMM テンプレート オブジェクトを指定します。

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

出力

VMConfiguration

このコマンドレットは 、VMConfiguration オブジェクトを返します。

メモ

  • Get-SCVMTemplate コマンドレットを使用して取得できる VMM 仮想マシン テンプレート オブジェクトが必要です。