Import-SCTemplate
仮想マシン テンプレートまたはサービス テンプレートを VMM ライブラリにインポートします。
構文
Import-SCTemplate
-Path <String>
[-Name <String>]
[-Release <String>]
[-Overwrite]
[-SettingsIncludePrivate]
[-PackageMapping <PackageMapping[]>]
[-AllowUnencryptedTransfer]
[-SharePath <String>]
[-Password <String>]
[-VMMServer <ServerConnection>]
[<CommonParameters>]Import-SCTemplate
-TemplatePackage <Package>
[-Name <String>]
[-Release <String>]
[-Overwrite]
[-SettingsIncludePrivate]
[-PackageMapping <PackageMapping[]>]
[-AllowUnencryptedTransfer]
[-SharePath <String>]
[-Password <String>]
[-VMMServer <ServerConnection>]
[<CommonParameters>]説明
Import-SCTemplate コマンドレットは、仮想マシン テンプレートまたはサービス テンプレートを仮想マシン マネージャー (VMM) ライブラリにインポートします。 ライブラリからテンプレートをエクスポートするには、Export-SCTemplate を使用します。
例
例 1: 以前にエクスポートしたテンプレート パッケージをインポートする
PS C:\> $Package = Get-SCTemplatePackage -Path "C:\TemplateExports\ServiceTemplate01.new.xml"
PS C:\> Import-SCTemplate -TemplatePackage $Package -SettingsIncludePrivate最初のコマンドは、指定したパスでエクスポートされたテンプレート パッケージ オブジェクトを取得し、$Package変数にオブジェクトを格納します。
2 番目のコマンドは、すべてのテンプレート設定を含め、$Packageに格納されているテンプレート パッケージ オブジェクトをインポートします。
例 2: エクスポート パッケージをインポートし、インポートしたテンプレートの新しい名前とリリースを指定する
PS C:\> Import-SCTemplate -Path "C:\TemplateExports\ServiceTemplate01.new.xml" -SettingsIncludePrivate -Name "New Service Name" -Release "1.0"このコマンドは、指定したテンプレート エクスポート パッケージをテンプレートのすべての設定と共にインポートし、インポートされたテンプレートの新しい名前とリリースを指定します。
例 3: マッピングの変更中にエクスポートされたパッケージ内の一部またはすべてのリソースを含むテンプレートをインポートする
PS C:\> $Mappings = New-SCPackageMapping -Path "C:\TemplateExports\VMTemplate01.xml" -PreferPackageResources
PS C:\> $Mapping = $Mappings | where {$_.PackageID -eq "VHD01.vhd"}
PS C:\> $Resource = Get-SCVirtualHardDisk -Name "VHD01.vhd"
PS C:\> Set-SCPackageMapping -PackageMapping $Mapping -TargetObject $Resource
PS C:\> Set-SCPackageMapping -PackageMapping $Mapping -PackageFile "C:\TemplateExports\Resources\VHD01.vhd"
PS C:\> Import-SCTemplate -Path C:\TemplateExports\VMTemplate01.xml -PackageMapping $Mapping -SharePath "\\LibServer01\Share01"最初のコマンドは、指定したパスに格納されているパッケージのパッケージ マッピング オブジェクトを作成し、パッケージ マッピング オブジェクトを$Mappings変数に格納します。
2 番目のコマンドは、パッケージ ID によってマッピング オブジェクトを取得し、$Mapping変数にオブジェクトを格納します。
3 番目のコマンドは、VHD01 という名前の仮想ハード ディスク オブジェクトを取得し、そのオブジェクトを $Resource 変数に格納します。
4 番目のコマンドは、$Mappingに格納されているマッピングを、$Resource (VHD01) に格納されているオブジェクトにバインドします。
5 番目のコマンドは、$Mappingに格納されているマッピングのパッケージ ファイルを設定します。
最後のコマンドは、指定したマッピングを使用して、指定したパスでテンプレートをインポートします (この場合、VHD01 は Share01 にインポートされます)。
パラメーター
-AllowUnencryptedTransfer
ネットワーク ファイル転送で暗号化が必要ないことを示します。 暗号化されていないネットワーク ファイル転送を許可すると、ソース ホストと宛先ホストのどちらでも暗号化が必要でなければ、パフォーマンスが向上する可能性があります。
このパラメーターを使用して、次の操作を行います。
- ライブラリとの間で暗号化されていないファイル転送を許可します。
- ホスト グループとの間またはホスト グループ内での暗号化されていないファイル転送を許可します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Overwrite
インポートまたはエクスポート操作によって、同じ名前の既存のファイルが上書きされることを示します。 または、インポート操作によって、既存の仮想マシン テンプレートまたはサービス テンプレート オブジェクトが同じ名前で上書きされます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PackageMapping
パッケージ マッピング オブジェクトの配列を指定します。
| 型: | PackageMapping[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Password
パスワードを含むセキュリティで保護された文字列を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Path
操作の宛先パスを指定します。
形式の例:
- ローカル パス:
-Path "F:\" - UNC パス:
-Path "\\Library\Templates" - ボリューム GUID パス:
-Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\" - VMware ESX パス:
-Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx" - Citrix XenServer パス:
-Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Release
ライブラリ リソースのリリースを記述する文字列を指定します。 VMM は、ライブラリにインポートされるすべてのリソースのリリース値を自動的に作成します。 リソースがインポートされたら、文字列をカスタマイズできます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SettingsIncludePrivate
機密性の高いテンプレート設定がインポート操作またはエクスポート操作に含まれていることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SharePath
汎用名前付け規則 (UNC) パスを使用する既存のライブラリ サーバー上の有効なライブラリ共有へのパスを指定します。
形式の例: -SharePath "\\LibServer01\LibShare"
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TemplatePackage
サービスまたは仮想マシン テンプレートのシリアル化された設定を含むエクスポートされたテンプレート パッケージを指定します。
| 型: | Package |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
SCTemplate
このコマンドレットは、SCTemplate オブジェクトを返します。