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 コマンドレットは、仮想マシン テンプレートまたはサービス テンプレートを Virtual Machine Manager (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

ネットワーク ファイル転送で暗号化が必要ないことを示します。 暗号化されていないネットワーク ファイル転送を許可すると、ソース ホストと宛先ホストのどちらも暗号化を必要としないと、パフォーマンスが向上する可能性があります。

次の場合は、このパラメーターを使用します。

  • ライブラリとの間で暗号化されていないファイル転送を許可します。
  • ホスト グループへの、またはホスト グループからの、またはホスト グループ内への暗号化されていないファイル転送を許可します。
Type:SwitchParameter
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:False
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

インポートまたはエクスポート操作によって、同じ名前の既存のファイルが上書きされることを示します。 または、インポート操作によって、同じ名前の既存の仮想マシン テンプレートまたはサービス テンプレート オブジェクトが上書きされます。

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

-PackageMapping

パッケージ マッピング オブジェクトの配列を指定します。

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

-Password

パスワードを含むセキュリティで保護された文字列を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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\]"
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Release

ライブラリ リソースのリリースを記述する文字列を指定します。 VMM は、ライブラリにインポートされたすべてのリソースのリリース値を自動的に作成します。 リソースがインポートされたら、文字列をカスタマイズできます。

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

-SettingsIncludePrivate

機密性の高いテンプレート設定がインポートまたはエクスポート操作に含まれていることを示します。

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

-SharePath

汎用名前付け規則 (UNC) パスを使用する既存のライブラリ サーバー上にある有効なライブラリ共有へのパスを指定します。

形式の例: -SharePath "\\LibServer01\LibShare"

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

-TemplatePackage

サービスまたは仮想マシン テンプレートのシリアル化された設定を含むエクスポートされたテンプレート パッケージを指定します。

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

-VMMServer

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

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

出力

SCTemplate

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