Dela via

New-SCVMHostProfile

  • Referens
Modul:
VirtualMachineManager

Skapar en värdprofil.

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

Cmdleten New-SCVMHostProfile skapar en värdprofil. Värdprofiler innehåller konfigurationsinställningarna för maskinvara och operativsystem som används för att distribuera en fysisk dator som en Hyper-V-värd.

Innan du skapar en värdprofil kontrollerar du att den virtuella hårddiskfilen (.vhd) som du anger finns i en biblioteksresurs.

Exempel

Exempel 1: Skapa en värdprofil

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

Det första kommandot hämtar det virtuella hårddiskobjektet med namnet VHD01.vhd och lagrar objektet i variabeln $VHD.

Det andra kommandot uppmanar dig att ange autentiseringsuppgifter. Ange autentiseringsuppgifterna för ett administratörskonto i prompten. Kommandot lagrar autentiseringsuppgifterna i variabeln $Credential.

Det tredje kommandot skapar en värdprofil med namnet HostProfile01 med hjälp av den virtuella hårddisken som lagras i $VHD och de autentiseringsuppgifter som lagras i $Credential.

Det senaste kommandot visar information om den nyligen skapade värdprofilen för användaren.

Exempel 2: Klona en befintlig värdprofil

PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfile

Det första kommandot hämtar värdprofilobjektet med namnet HostProfile01 och lagrar objektet i variabeln $OrigHostProfile.

Det andra kommandot kopierar värdprofilen som lagras i $OrigHostProfile, ger den det angivna namnet och lagrar det nya profilobjektet i variabeln $NewHostProfile.

Exempel 3: Skapa en värdprofil som innehåller en profil för värdnätverkskort

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

Det första kommandot hämtar det virtuella hårddiskobjektet med namnet VHDX01.vhdx och lagrar objektet i variabeln $VHDX.

Det andra kommandot hämtar Kör som-kontoobjektet med namnet DomainJoinRAA och lagrar objektet i variabeln $DomainJoinCreds.

Det tredje kommandot uppmanar användaren att ange autentiseringsuppgifter för lokal administratör och lagrar de angivna autentiseringsuppgifterna i variabeln $LocalAdminCreds.

Det fjärde kommandot hämtar profilobjektet för värdnätverkskortet med ID:t 259f47c7-c5a9-429d-a421-d232f9b34991 och lagrar objektet i variabeln $HostNetAdapterProf.

Det senaste kommandot skapar en värdprofil med namnet Värdprofil 03 med hjälp av VHDX01 och profilen för värdnätverkskort som lagras i $HostNetAdapterProf.

Parametrar

-AnswerFile

Anger ett skriptobjekt som lagras i vmm-biblioteket (Virtual Machine Manager) som ska användas som svarsfil. Namnet på svarsfilskriptet beror på vilket operativsystem du vill installera på en virtuell dator:

  • Sysprep.inf. Windows XP, Windows Server 2000 eller Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 eller Windows Server 2008
Type:Script
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Baseline

Anger en matris med baslinjeobjekt .

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

-BypassVHDConversion

Anger om en dynamisk virtuell hårddisk som är kopplad till en värdprofil inte konverteras till en fast typ under distributionen.

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

-CodeIntegrityPolicy

Anger en kodintegritetsprincip.

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

-ComputerAccessRunAsAccount

Anger den dator som kör som-kontot ska använda för att distribuera datorn. Det här Kör som-kontot läggs till på datorn som lokal administratör och används för att hantera datorn.

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

-Description

Anger en beskrivning av värdprofilen.

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

-DiskConfiguration

Anger disk- och partitionskonfigurationen för den fysiska dator som ska distribueras med Windows Hyper-V.

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

-Domain

Anger ett fullständigt kvalificerat domännamn (FQDN) för en Active Directory-domän.

Exempelformat: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinRunAsAccount

Anger ett Kör som-konto som har behörighet att ansluta till den angivna domänen.

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

-DriverMatchingTag

Anger de anpassade taggarna som ska matcha drivrutinsegenskaperna under distributionen. När taggar anges matchar distributionsprocessen de taggar som anges i värdprofilen med taggarna i drivrutinerna för att ladda ned matchande drivrutiner och installera dem i målbilden.

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

-FullName

Anger namnet på den person i vars namn en virtuell dator har registrerats.

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

-GuiRunOnceCommands

Anger en matris med kommandon som ska läggas till i avsnittet [GuiRunOnce] i en obevakad svarsfil. Använd enkla citattecken runt varje sträng som omges av dubbla citattecken.

Exempelformat: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Om du vill ha information om hur Windows PowerShell använder citattecken skriver du Get-Help about_Quoting_Rules.

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

-IsGuarded

Anger att värden måste vara en skyddad värd.

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

-JobGroup

Anger en identifierare för en serie kommandon som ska köras som en uppsättning precis innan det sista kommandot som innehåller samma jobbgruppsidentifierare körs.

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

-JobVariable

Anger att jobb förloppet spåras och lagras i variabeln med namnet av den här parametern.

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

-JoinWorkgroup

Anger att den här åtgärden ansluter till en arbetsgrupp.

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

-LocalAdministratorCredential

Anger användarnamn och lösenord för det lokala administratörskontot (eller Linux-rotkontot om det gäller en Linux-kompatibel gästoperativsystemprofil).

Om du anger autentiseringsuppgifter för en ny eller befintlig mall, på en ny eller befintlig gästoperativsystemprofil eller på en ny virtuell dator åsidosätts alla befintliga administratörslösenord.

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

-Name

Anger namnet på ett VMM-objekt.

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

-OrganizationName

Anger namnet på organisationen för den person i vars namn en virtuell dator har registrerats.

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

-Owner

Anger ägaren av ett VMM-objekt i form av ett giltigt domänanvändarkonto.

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

-ProductKey

Anger en produktnyckel. Produktnyckeln är ett 25-siffrigt nummer som identifierar produktlicensen. En produktnyckel kan användas för att registrera VMM eller ett operativsystem som ska installeras på en virtuell dator eller värd.

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

-PROTipID

Anger ID för tipset om prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-TimeZone

Anger ett tal (ett index) som identifierar en geografisk region som delar samma standardtid. En lista över tidszonsindex finns i Microsoft Time Zone Index Values på http://go.microsoft.com/fwlink/?LinkId=120935. Om ingen tidszon anges är standardtidszonen som används för en virtuell dator samma tidszonsinställning som finns på den virtuella datorvärden.

Exempelformat för att ange gmt-standardtidszonen: -TimeZone 085

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

-VirtualHardDisk

Anger ett virtuellt hårddiskobjekt.

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

-VMHostNetworkAdapterProfile

Anger ett profilobjekt för värdnätverkskort.

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

-VMHostProfile

Anger ett värdprofilobjekt för en virtuell dator.

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

-VMMServer

Anger ett VMM-serverobjekt.

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

-VMPaths

Anger en uppsättning standardsökvägar (som strängar avgränsade med pipelineoperatorn) på en värd där filer för virtuella datorer kan lagras.

Exempelformat: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

Utdata

HostProfile

Den här cmdleten returnerar ett HostProfile-objekt .