Import-SCTemplate
가상 머신 템플릿 또는 서비스 템플릿을 VMM 라이브러리로 가져옵니다.
Syntax
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>]
Description
Import-SCTemplate cmdlet은 가상 머신 템플릿 또는 서비스 템플릿을 VMM(Virtual Machine Manager) 라이브러리로 가져옵니다. 라이브러리에서 템플릿을 내보내려면 Export-SCTemplate을 사용합니다.
예제
예제 1: 이전에 내보낸 템플릿 패키지 가져오기
PS C:\> $Package = Get-SCTemplatePackage -Path "C:\TemplateExports\ServiceTemplate01.new.xml"
PS C:\> Import-SCTemplate -TemplatePackage $Package -SettingsIncludePrivate
첫 번째 명령은 지정된 경로에서 내보낸 템플릿 패키지 개체를 가져오고 개체를 $Package 변수에 저장합니다.
두 번째 명령은 모든 템플릿 설정을 포함하여 $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 변수에 저장합니다.
두 번째 명령은 패키지 ID별로 매핑 개체를 가져오고 $Mapping 변수에 개체를 저장합니다.
세 번째 명령은 VHD01이라는 가상 하드 디스크 개체를 가져오고 개체를 $Resource 변수에 저장합니다.
네 번째 명령은 $Mapping 저장된 매핑을 $Resource(VHD01)에 저장된 개체에 바인딩합니다.
다섯 번째 명령은 $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(Universal Naming Convention) 경로를 사용하는 기존 라이브러리 서버의 유효한 라이브러리 서버 경로를 지정합니다.
예제 형식: -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
이 cmdlet은 SCTemplate 개체를 반환합니다.