New-SCVMConfiguration
仮想マシン テンプレートから仮想マシン構成を作成します。
構文
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 仮想マシン テンプレート オブジェクトが必要です。