New-SCVMHostProfile
호스트 프로필을 만듭니다.
구문
New-SCVMHostProfile
[-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
[-Name] <String>
-VirtualHardDisk <VirtualHardDisk>
-Domain <String>
-DomainJoinRunAsAccount <RunAsAccount>
-LocalAdministratorCredential <VMMCredential>
[-ComputerAccessRunAsAccount <RunAsAccount>]
[-DiskConfiguration <String>]
[-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
[-VMPaths <String>]
[-FullName <String>]
[-IsGuarded <Boolean>]
[-CodeIntegrityPolicy <CodeIntegrityPolicy>]
[-GuiRunOnceCommands <String[]>]
[-OrganizationName <String>]
[-ProductKey <String>]
[-TimeZone <Int32>]
[-Baseline <Baseline[]>]
[-JobGroup <Guid>]
[-Description <String>]
[-Owner <String>]
[-AnswerFile <Script>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
New-SCVMHostProfile
-VMHostProfile <PhysicalComputerProfile>
[-Name] <String>
[-Description <String>]
[-Owner <String>]
[-AnswerFile <Script>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
New-SCVMHostProfile
[-Name] <String>
-VirtualHardDisk <VirtualHardDisk>
[-JoinWorkgroup]
-LocalAdministratorCredential <VMMCredential>
[-ComputerAccessRunAsAccount <RunAsAccount>]
[-DiskConfiguration <String>]
[-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
[-VMPaths <String>]
[-FullName <String>]
[-IsGuarded <Boolean>]
[-CodeIntegrityPolicy <CodeIntegrityPolicy>]
[-GuiRunOnceCommands <String[]>]
[-OrganizationName <String>]
[-ProductKey <String>]
[-TimeZone <Int32>]
[-Baseline <Baseline[]>]
[-JobGroup <Guid>]
[-Description <String>]
[-Owner <String>]
[-AnswerFile <Script>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
New-SCVMHostProfile
[-Name] <String>
-VirtualHardDisk <VirtualHardDisk>
-Domain <String>
-DomainJoinRunAsAccount <RunAsAccount>
-LocalAdministratorCredential <VMMCredential>
[-ComputerAccessRunAsAccount <RunAsAccount>]
[-DiskConfiguration <String>]
[-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
[-VMPaths <String>]
[-FullName <String>]
[-GuiRunOnceCommands <String[]>]
[-OrganizationName <String>]
[-ProductKey <String>]
[-TimeZone <Int32>]
[-JobGroup <Guid>]
[-Description <String>]
[-Owner <String>]
[-AnswerFile <Script>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
New-SCVMHostProfile cmdlet은 호스트 프로필을 만듭니다. 호스트 프로필에는 물리적 컴퓨터를 Hyper-V 호스트로 배포하는 데 사용되는 하드웨어 및 운영 체제 구성 설정이 포함되어 있습니다.
호스트 프로필을 만들기 전에 지정한 가상 하드 디스크 드라이브(.vhd) 파일이 라이브러리 공유에 있는지 확인합니다.
예제
예제 1: 호스트 프로필 만들기
PS C:\> $VHD = Get-SCVirtualHardDisk -Name "VHD01.vhd"
PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAcct01"
PS C:\> $Credential = Get-Credential
PS C:\> $HostProfile = New-SCVMHostProfile -Name "HostProfile01" -Owner "Contoso\Katarina" -Description "Host Profile 01" -Domain "Contoso.com" -DomainJoinRunAsAccount $RunAsAcct -VirtualHardDisk $VHD -LocalAdministratorCredential $Credential
PS C:\> $HostProfile
첫 번째 명령은 VHD01.vhd라는 가상 하드 디스크 개체를 가져오고 개체를 $VHD 변수에 저장합니다.
두 번째 명령은 자격 증명을 묻는 메시지를 표시합니다. 프롬프트에서 관리자 계정의 자격 증명을 입력합니다. 이 명령은 자격 증명을 $Credential 변수에 저장합니다.
세 번째 명령은 $VHD 저장된 가상 하드 디스크와 $Credential 저장된 자격 증명을 사용하여 HostProfile01이라는 호스트 프로필을 만듭니다.
마지막 명령은 사용자에게 새로 만든 호스트 프로필에 대한 정보를 표시합니다.
예제 2: 기존 호스트 프로필 복제
PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfile
첫 번째 명령은 HostProfile01이라는 호스트 프로필 개체를 가져오고 개체를 $OrigHostProfile 변수에 저장합니다.
두 번째 명령은 $OrigHostProfile 저장된 호스트 프로필을 복사하고, 지정된 이름을 지정하고, 새 프로필 개체를 $NewHostProfile 변수에 저장합니다.
예제 3: 호스트 네트워크 어댑터 프로필을 포함하는 호스트 프로필 만들기
PS C:\> $VHDX = Get-SCVirtualHardDisk -Name "VHDX01.vhdx"
PS C:\> $DomainJoinCreds = Get-SCRunAsAccount -Name "DomainJoinRAA"
PS C:\> $LocalAdminCreds = Get-Credential
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> New-SCVMHostProfile -Name "HostProfile03" -Owner "Contoso\Katarina" -Description "Host Profile 03" -Domain "Contoso.com" -DomainJoinRunAsAccount $DomainJoinCreds -VirtualHardDisk $VHDX -LocalAdministratorCredential $LocalAdminCreds -VMHostNetworkAdapterProfile $HostNetAdapterProf
첫 번째 명령은 VHDX01.vhdx라는 가상 하드 디스크 개체를 가져오고 개체를 $VHDX 변수에 저장합니다.
두 번째 명령은 DomainJoinRAA라는 실행 계정 개체를 가져오고 개체를 $DomainJoinCreds 변수에 저장합니다.
세 번째 명령은 사용자에게 로컬 관리자 자격 증명을 묻는 메시지를 표시하고 제공된 자격 증명을 $LocalAdminCreds 변수에 저장합니다.
네 번째 명령은 ID가 259f47c7-c5a9-429d-a421-d232f9b34991인 호스트 네트워크 어댑터 프로필 개체를 가져오고 개체를 $HostNetAdapterProf 변수에 저장합니다.
마지막 명령은 VHDX01 및 $HostNetAdapterProf 저장된 호스트 네트워크 어댑터 프로필을 사용하여 호스트 프로필 03이라는 호스트 프로필을 만듭니다.
매개 변수
-AnswerFile
응답 파일로 사용할 VMM(Virtual Machine Manager) 라이브러리에 저장된 스크립트 개체를 지정합니다. 응답 파일 스크립트의 이름은 가상 머신에 설치하려는 운영 체제에 따라 달라집니다.
- Sysprep.inf. Windows XP, Windows Server 2000 또는 Windows Server 2003
- Unattend.xml. Windows Vista, Windows 7 또는 Windows Server 2008
형식: | Script |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Baseline
Baseline 개체의 배열을 지정합니다.
형식: | Baseline[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BypassVHDConversion
배포하는 동안 호스트 프로필에 연결된 동적 VHD가 고정 형식으로 변환되지 않는지 여부를 나타냅니다.
형식: | Boolean |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-CodeIntegrityPolicy
코드 무결성 정책을 지정합니다.
형식: | CodeIntegrityPolicy |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ComputerAccessRunAsAccount
컴퓨터를 배포하는 데 사용할 컴퓨터 액세스 실행 계정을 지정합니다. 이 실행 계정은 로컬 관리자로 컴퓨터에 추가되고 머신을 관리하는 데 사용됩니다.
형식: | RunAsAccount |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Description
호스트 프로필에 대한 설명을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DiskConfiguration
Windows Hyper-V를 사용하여 배포할 실제 컴퓨터의 디스크 및 파티션 구성을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Domain
Active Directory 도메인의 FQDN(정규화된 도메인 이름)을 지정합니다.
예제 형식: -Domain "Domain01.Corp.Contoso.com"
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DomainJoinRunAsAccount
지정된 도메인에 가입할 수 있는 권한이 있는 실행 계정을 지정합니다.
형식: | RunAsAccount |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DriverMatchingTag
배포 중에 드라이버 속성과 일치시킬 사용자 지정 태그를 지정합니다. 태그가 지정되면 배포 프로세스는 일치하는 드라이버를 다운로드하고 대상 이미지에 설치하기 위해 호스트 프로필에 지정된 태그를 드라이버의 태그와 일치합니다.
형식: | System.Collections.Generic.List`1[System.String] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-FullName
가상 머신이 등록된 이름을 가진 사람의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-GuiRunOnceCommands
무인 응답 파일의 [GuiRunOnce] 섹션에 추가할 명령 배열을 지정합니다. 큰따옴표로 묶인 각 문자열 주위에 작은따옴표를 사용합니다.
예제 형식: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'
Windows PowerShell에서 따옴표를 사용하는 방법에 대한 자세한 내용은 Get-Help about_Quoting_Rules
입력합니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-IsGuarded
호스트가 보호된 호스트여야 임을 나타냅니다.
형식: | Boolean |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-JobGroup
동일한 작업 그룹 식별자를 포함하는 최종 명령이 실행되기 직전에 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-JobVariable
작업 진행률이 추적되고 이 매개 변수로 명명된 변수에 저장되도록 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-JoinWorkgroup
이 작업이 작업 그룹에 조인되었음을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-LocalAdministratorCredential
로컬 관리자 계정(또는 Linux 호환 게스트 운영 체제 프로필의 경우 Linux 루트 계정)에 대한 사용자 이름 및 암호를 지정합니다.
새 템플릿 또는 기존 템플릿, 새 또는 기존 게스트 운영 체제 프로필 또는 새 가상 머신에서 자격 증명을 지정하면 기존 관리자 암호가 재정의됩니다.
형식: | VMMCredential |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Name
VMM 개체의 이름을 지정합니다.
형식: | String |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-OrganizationName
가상 머신이 등록된 이름을 가진 사람의 조직 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Owner
유효한 도메인 사용자 계정의 형태로 VMM 개체의 소유자를 지정합니다.
- 예제 형식:
-Owner "Contoso\PattiFuller"
- 예제 형식:
-Owner "PattiFuller@Contoso"
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ProductKey
제품 키를 지정합니다. 제품 키는 제품 라이선스를 식별하는 25자리 숫자입니다. 제품 키를 사용하여 가상 머신 또는 호스트에 설치할 VMM 또는 운영 체제를 등록할 수 있습니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PROTipID
이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RunAsynchronously
컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-TimeZone
동일한 표준 시간을 공유하는 지리적 지역을 식별하는 숫자(인덱스)를 지정합니다.
표준 시간대 인덱스 목록은
GMT 표준 시간대를 지정하는 예제 형식: -TimeZone 085
형식: | Int32 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VirtualHardDisk
가상 하드 디스크 개체를 지정합니다.
형식: | VirtualHardDisk |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VMHostNetworkAdapterProfile
호스트 네트워크 어댑터 프로필 개체를 지정합니다.
형식: | PhysicalComputerNetworkAdapterProfile[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VMHostProfile
가상 머신 호스트 프로필 개체를 지정합니다.
형식: | PhysicalComputerProfile |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-VMMServer
VMM 서버 개체를 지정합니다.
형식: | ServerConnection |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-VMPaths
가상 머신 파일을 저장할 수 있는 호스트에서 기본 경로 집합(파이프라인 연산자로 구분된 문자열)을 지정합니다.
예제 형식: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
출력
HostProfile
이 cmdlet은 HostProfile 개체를 반환합니다.