다음을 통해 공유

New-SCVMHostProfile

  • 참조
모듈:
VirtualMachineManager

호스트 프로필을 만듭니다.

Syntax

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

-Baseline

Baseline 개체의 배열을 지정합니다.

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

-BypassVHDConversion

배포 중에 호스트 프로필에 연결된 동적 VHD가 고정 형식으로 변환되지 않는지 여부를 나타냅니다.

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

-CodeIntegrityPolicy

코드 무결성 정책을 지정합니다.

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

-ComputerAccessRunAsAccount

컴퓨터를 배포하는 데 사용할 컴퓨터 액세스 실행 계정을 지정합니다. 이 실행 계정은 로컬 관리자로 컴퓨터에 추가되고 컴퓨터를 관리하는 데 사용됩니다.

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

-Description

호스트 프로필에 대한 설명을 지정합니다.

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

-DiskConfiguration

Windows Hyper-V를 사용하여 배포할 물리적 컴퓨터의 디스크 및 파티션 구성을 지정합니다.

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

-Domain

Active Directory 도메인의 정규 도메인 이름(FQDN)을 지정합니다.

예제 형식: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinRunAsAccount

지정된 도메인에 가입할 수 있는 권한이 있는 실행 계정을 지정합니다.

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

-DriverMatchingTag

배포하는 동안 드라이버 속성과 일치시킬 사용자 지정 태그를 지정합니다. 태그를 지정하면 배포 프로세스는 호스트 프로필에 지정된 태그와 드라이버의 태그를 일치시켜 일치하는 드라이버를 다운로드하고 대상 이미지에 설치합니다.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullName

가상 컴퓨터가 등록된 사용자의 이름을 지정합니다.

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

-GuiRunOnceCommands

무인 응답 파일의 [GuiRunOnce] 섹션에 추가할 명령 배열을 지정합니다. 큰따옴표로 묶인 각 문자열 주위에 작은따옴표를 사용합니다.

예제 형식: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Windows PowerShell 따옴표를 사용하는 방법에 대한 자세한 내용은 다음을 입력합니다Get-Help about_Quoting_Rules.

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

-IsGuarded

호스트가 보호된 호스트여야 했음을 나타냅니다.

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

-JobGroup

동일한 작업 그룹 식별자를 포함하는 마지막 명령이 실행되기 직전에 하나의 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.

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

-JobVariable

작업 진행률을 추적하여 이 매개 변수로 이름이 지정된 변수에 보관하도록 지정합니다.

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

-JoinWorkgroup

이 작업이 작업 그룹에 조인되었음을 나타냅니다.

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

-LocalAdministratorCredential

로컬 관리자 계정(또는 Linux 호환 게스트 운영 체제 프로필의 경우 Linux 루트 계정)에 대한 사용자 이름 및 암호를 지정합니다.

새 템플릿 또는 기존 템플릿, 새 게스트 운영 체제 프로필 또는 새 가상 머신에서 자격 증명을 지정하면 기존 관리자 암호가 재정의됩니다.

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

-Name

VMM 개체의 이름을 지정합니다.

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

-OrganizationName

가상 머신이 등록된 사용자의 조직 이름을 지정합니다.

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

-Owner

유효한 도메인 사용자 계정의 형태로 VMM 개체의 소유자를 지정합니다.

  • 예제 형식: -Owner "Contoso\PattiFuller"
  • 예제 형식: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProductKey

제품 키를 지정합니다. 제품 키는 제품 라이선스를 식별하는 25자리 숫자입니다. 제품 키를 사용하여 가상 머신 또는 호스트에 설치할 VMM 또는 운영 체제를 등록할 수 있습니다.

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

-PROTipID

이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.

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

-RunAsynchronously

컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.

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

-TimeZone

동일한 표준 시간을 공유하는 지리적 지역을 식별하는 숫자(인덱스)를 지정합니다. 표준 시간대 인덱스 목록은 Microsoft 표준 시간대 인덱스 값을 참조하세요http://go.microsoft.com/fwlink/?LinkId=120935. 표준 시간대를 지정하지 않으면 가상 머신에 사용되는 기본 표준 시간대는 가상 머신 호스트에 있는 표준 시간대 설정과 동일합니다.

GMT 표준 시간대를 지정하는 예제 형식: -TimeZone 085

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

-VirtualHardDisk

가상 하드 디스크 개체를 지정합니다.

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

-VMHostNetworkAdapterProfile

호스트 네트워크 어댑터 프로필 개체를 지정합니다.

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

-VMHostProfile

가상 머신 호스트 프로필 개체를 지정합니다.

Type:PhysicalComputerProfile
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

-VMPaths

가상 컴퓨터 파일을 보관하는 데 사용할 호스트의 기본 경로(파이프라인 연산자로 구분된 문자열 형식) 집합을 지정합니다.

예제 형식: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

출력

HostProfile

이 cmdlet은 HostProfile 개체를 반환합니다.