Delen via

New-SCVMHostProfile

  • Referentie
Module:
VirtualMachineManager

Hiermee maakt u een hostprofiel.

Syntaxis

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

De New-SCVMHostProfile cmdlet maakt een hostprofiel. Hostprofielen bevatten de configuratie-instellingen voor hardware en het besturingssysteem die worden gebruikt voor het implementeren van een fysieke computer als een Hyper-V host.

Voordat u een hostprofiel maakt, moet u ervoor zorgen dat het bestand van de virtuele harde schijf (.vhd) dat u opgeeft, aanwezig is in een bibliotheekshare.

Voorbeelden

Voorbeeld 1: Een hostprofiel maken

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

Met de eerste opdracht wordt het virtuele hardeschijfobject met de naam VHD01.vhd opgehaald en wordt het object opgeslagen in de variabele $VHD.

Met de tweede opdracht wordt u om referenties gevraagd. Voer bij de prompt de referenties van een beheerdersaccount in. Met de opdracht worden de referenties opgeslagen in de variabele $Credential.

Met de derde opdracht maakt u een hostprofiel met de naam HostProfile01 met behulp van de virtuele harde schijf die is opgeslagen in $VHD en de referenties die zijn opgeslagen in $Credential.

Met de laatste opdracht wordt informatie weergegeven over het zojuist gemaakte hostprofiel voor de gebruiker.

Voorbeeld 2: Een bestaand hostprofiel klonen

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

Met de eerste opdracht wordt het hostprofielobject met de naam HostProfile01 opgehaald en wordt het object opgeslagen in de $OrigHostProfile variabele.

De tweede opdracht kopieert het hostprofiel dat is opgeslagen in $OrigHostProfile, geeft het de opgegeven naam en slaat het nieuwe profielobject op in de $NewHostProfile variabele.

Voorbeeld 3: Een hostprofiel maken dat een hostnetwerkadapterprofiel bevat

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

Met de eerste opdracht wordt het virtuele hardeschijfobject met de naam VHDX01.vhdx opgehaald en wordt het object opgeslagen in de variabele $VHDX.

Met de tweede opdracht wordt het Uitvoeren als-accountobject met de naam DomainJoinRAA opgehaald en wordt het object opgeslagen in de variabele $DomainJoinCreds.

De derde opdracht vraagt de gebruiker om lokale beheerdersreferenties en slaat de opgegeven referenties op in de $LocalAdminCreds variabele.

Met de vierde opdracht wordt het profielobject van de hostnetwerkadapter opgehaald met de id 259f47c7-c5a9-429d-a421-d232f9b34991 en wordt het object opgeslagen in de $HostNetAdapterProf variabele.

Met de laatste opdracht maakt u een hostprofiel met de naam Host Profile 03 met behulp van VHDX01 en het profiel van de hostnetwerkadapter die is opgeslagen in $HostNetAdapterProf.

Parameters

-AnswerFile

Hiermee geeft u een scriptobject op dat is opgeslagen in de VMM-bibliotheek (Virtual Machine Manager) die moet worden gebruikt als antwoordbestand. De naam van het antwoordbestandscript is afhankelijk van het besturingssysteem dat u wilt installeren op een virtuele machine:

  • Sysprep.inf. Windows XP, Windows Server 2000 of Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 of Windows Server 2008
Type:Script
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Baseline

Hiermee geeft u een matrix van Basislijn objecten.

Type:Baseline[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BypassVHDConversion

Geeft aan of een dynamische VHD die is gekoppeld aan een hostprofiel niet wordt geconverteerd naar een vast type tijdens de implementatie.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CodeIntegrityPolicy

Hiermee geeft u een code-integriteitsbeleid op.

Type:CodeIntegrityPolicy
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ComputerAccessRunAsAccount

Hiermee geeft u het Uitvoeren als-account voor computertoegang op dat moet worden gebruikt om de computer te implementeren. Dit Uitvoeren als-account wordt als lokale beheerder toegevoegd aan de computer en wordt gebruikt om de computer te beheren.

Type:RunAsAccount
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Hiermee geeft u een beschrijving voor het hostprofiel.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DiskConfiguration

Hiermee geeft u de schijf- en partitieconfiguratie op voor de fysieke computer die moet worden geïmplementeerd met Windows Hyper-V.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Domain

Hiermee geeft u een FQDN (Fully Qualified Domain Name) voor een Active Directory-domein.

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

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DomainJoinRunAsAccount

Hiermee geeft u een Uitvoeren als-account op dat gemachtigd is om lid te worden van het opgegeven domein.

Type:RunAsAccount
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DriverMatchingTag

Hiermee geeft u de aangepaste tags die overeenkomen met stuurprogramma-eigenschappen tijdens de implementatie. Wanneer tags worden opgegeven, komt het implementatieproces overeen met de tags die zijn opgegeven in het hostprofiel met de tags in de stuurprogramma's om overeenkomende stuurprogramma's te downloaden en te installeren in de doelinstallatiekopie.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FullName

Hiermee geeft u de naam van de persoon in wiens naam een virtuele machine is geregistreerd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-GuiRunOnceCommands

Hiermee geeft u een matrix van opdrachten toe te voegen aan de [GuiRunOnce] sectie van een onbeheerd antwoordbestand. Gebruik enkele aanhalingstekens rond elke tekenreeks tussen dubbele aanhalingstekens.

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

Typ Get-Help about_Quoting_Rulesvoor informatie over hoe Windows PowerShell aanhalingstekens gebruikt.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IsGuarded

Geeft aan dat de host een beveiligde host moet zijn.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JoinWorkgroup

Geeft aan dat deze bewerking lid wordt van een werkgroep.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LocalAdministratorCredential

Hiermee geeft u de gebruikersnaam en het wachtwoord voor het lokale administrator-account (of Linux-hoofdaccount in het geval van een linux-compatibel gastbesturingssysteemprofiel).

Als u referenties opgeeft voor een nieuwe of bestaande sjabloon, op een nieuw of bestaand gastbesturingssysteemprofiel, of op een nieuwe virtuele machine, wordt een bestaand beheerderswachtwoord overschreven.

Type:VMMCredential
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OrganizationName

Hiermee geeft u de naam van de organisatie voor de persoon in wiens naam een virtuele machine is geregistreerd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Owner

Hiermee geeft u de eigenaar van een VMM-object in de vorm van een geldig domeingebruikersaccount.

  • Voorbeeldindeling: -Owner "Contoso\PattiFuller"
  • Voorbeeldindeling: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProductKey

Hiermee geeft u een productcode op. De productcode is een getal van 25 cijfers waarmee de productlicentie wordt geïdentificeerd. Een productcode kan worden gebruikt om VMM of een besturingssysteem te registreren dat moet worden geïnstalleerd op een virtuele machine of host.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimeZone

Hiermee geeft u een getal (een index) aan dat een geografische regio identificeert die dezelfde standaardtijd deelt. Zie Microsoft Time Zone Index Values op http://go.microsoft.com/fwlink/?LinkId=120935voor een lijst met tijdzone-indexen. Als er geen tijdzone is opgegeven, is de standaardtijdzone die wordt gebruikt voor een virtuele machine dezelfde tijdzone-instelling die zich op de host van de virtuele machine bevindt.

Voorbeeldindeling voor het opgeven van de gmt-standaardtijdzone: -TimeZone 085

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VirtualHardDisk

Hiermee geeft u een virtuele harde schijf-object.

Type:VirtualHardDisk
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMHostNetworkAdapterProfile

Hiermee geeft u een hostnetwerkadapterprofielobject.

Type:PhysicalComputerNetworkAdapterProfile[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMHostProfile

Hiermee geeft u een hostprofielobject voor de virtuele machine op.

Type:PhysicalComputerProfile
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMPaths

Hiermee geeft u een set standaardpaden op (zoals tekenreeksen gescheiden door de pijplijnoperator) op een host waar bestanden van virtuele machines kunnen worden opgeslagen.

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

HostProfile

Met deze cmdlet wordt een HostProfile--object geretourneerd.