Delen via

New-SCVMHostProfile

  • Referentie
Module:
VirtualMachineManager

Hiermee maakt u een hostprofiel.

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

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

Voordat u een hostprofiel maakt, moet u ervoor zorgen dat het virtuele hardeschijfstationbestand (.vhd) dat u opgeeft, bestaat 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 $VHD variabele.

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

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.

Met de tweede opdracht wordt het hostprofiel gekopieerd dat is opgeslagen in $OrigHostProfile, krijgt het de opgegeven naam en slaat u 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 $VHDX variabele.

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

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

De vierde opdracht haalt het profielobject voor de hostnetwerkadapter op met de id 259f47c7-c5a9-429d-a421-d232f9b34991 en slaat het object op in de $HostNetAdapterProf variabele.

Met de laatste opdracht maakt u een hostprofiel met de naam Host Profile 03 met VHDX01 en het hostnetwerkadapterprofiel dat 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 antwoordbestandsscript 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Baseline

Hiermee geeft u een matrix van basislijnobjecten op.

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

-CodeIntegrityPolicy

Hiermee geeft u een code-integriteitsbeleid op.

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

-ComputerAccessRunAsAccount

Hiermee geeft u de computertoegang Uitvoeren als-account te gebruiken om de computer te implementeren. Dit Uitvoeren als-account wordt als lokale beheerder aan de computer toegevoegd en gebruikt om de computer te beheren.

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

-Description

Hiermee geeft u een beschrijving voor het hostprofiel.

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

-DomainJoinRunAsAccount

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

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

-DriverMatchingTag

Hiermee geeft u de aangepaste tags op 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GuiRunOnceCommands

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

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

Typ voor informatie over hoe Windows PowerShell aanhalingstekens Get-Help about_Quoting_Rulesgebruikt.

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

-IsGuarded

Geeft aan dat de host een beveiligde host moet zijn.

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

-JoinWorkgroup

Geeft aan dat deze bewerking lid wordt van een werkgroep.

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

-LocalAdministratorCredential

Hiermee geeft u de gebruikersnaam en het wachtwoord voor het lokale beheerdersaccount (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 profiel voor een gastbesturingssysteem, of op een nieuwe virtuele machine, wordt een bestaand beheerderswachtwoord overschreven.

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

-Name

Hiermee geeft u de naam van een VMM-object.

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

-Owner

Geeft de eigenaar van een VMM-object aan in de vorm van een geldig domeingebruikersaccount.

  • Voorbeeldindeling: -Owner "Contoso\PattiFuller"
  • Voorbeeldindeling: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeZone

Hiermee geeft u een getal (een index) dat een geografische regio identificeert die dezelfde standaardtijd deelt. Zie Microsoft Time Zone Index Values op voor een lijst met tijdzone-indexen op http://go.microsoft.com/fwlink/?LinkId=120935. 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualHardDisk

Hiermee geeft u een virtueel hardeschijfobject op.

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

-VMHostNetworkAdapterProfile

Hiermee geeft u een hostnetwerkadapterprofielobject.

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

-VMHostProfile

Hiermee geeft u een hostprofielobject voor virtuele machines op.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

-VMPaths

Hiermee geeft u een set standaardpaden (als 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Uitvoerwaarden

HostProfile

Met deze cmdlet wordt een HostProfile-object geretourneerd.