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
可用性セット名の一覧を指定します。
| 型: | System.Collections.Generic.List`1[System.String] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CapabilityProfile
機能プロファイル オブジェクトを指定します。
| 型: | CapabilityProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Cloud
プライベート クラウド オブジェクトを指定します。
| 型: | Cloud |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ComputerName
VMM がネットワーク上で一意に識別できるコンピューターの名前を指定します。 有効な形式は次のとおりです。
- FQDN
- IPv4 アドレス
- IPv6 アドレス
- NetBIOS 名
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ComputerTier
コンピューター層オブジェクトを指定します。
| 型: | ComputerTier |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CostCenter
仮想マシン (または仮想マシンに割り当てられたリソース) の割り当てに関するデータを収集して課金システムで使用できるように、仮想マシンのコスト センターを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
仮想マシン構成の説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
仮想マシン マネージャー (VMM) オブジェクトの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザーの名前を指定します。 このコマンドレットは、このパラメーターが指定するユーザーとしてユーザーの代理を設定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 このコマンドレットは、このパラメーターが指定するユーザー ロールとしてユーザー ロールの代理を設定します。 ユーザー ロール オブジェクトを取得するには、Get-SCUserRole コマンドレットを使用します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMHostGroup
仮想マシンのホスト グループ オブジェクトまたはホスト グループ オブジェクトの配列を指定します。
| 型: | HostGroup |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMTemplate
仮想マシンの作成に使用する VMM テンプレート オブジェクトを指定します。
| 型: | Template |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
VMConfiguration
このコマンドレットは、VMConfiguration オブジェクトを返します。
メモ
- Get-SCVMTemplate コマンドレットを使用して取得できる VMM 仮想マシン テンプレート オブジェクトが必要です。