New-SCVMHostProfile
Erstellt ein Hostprofil.
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>] Beschreibung
Das Cmdlet "New-SCVMHostProfile " erstellt ein Hostprofil. Hostprofile enthalten die Hardware- und Betriebssystemkonfigurationseinstellungen, die zum Bereitstellen eines physischen Computers als Hyper-V-Host verwendet werden.
Stellen Sie vor dem Erstellen eines Hostprofils sicher, dass die virtuelle Festplatte (.vhd)-Datei, die Sie angeben, in einer Bibliotheksfreigabe vorhanden ist.
Beispiele
Beispiel 1: Erstellen eines Hostprofils
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:\> $HostProfileDer erste Befehl ruft das virtuelle Festplattenobjekt namens VHD01.vhd ab und speichert das Objekt in der $VHD Variablen.
Der zweite Befehl fordert Sie zu Anmeldeinformationen auf. Geben Sie bei der Eingabeaufforderung die Anmeldeinformationen eines Administratorkontos ein. Der Befehl speichert die Anmeldeinformationen in der variablen $Credential.
Der dritte Befehl erstellt ein Hostprofil namens HostProfile01 mithilfe der virtuellen Festplatte, die in $VHD gespeichert ist, und die Anmeldeinformationen, die in $Credential gespeichert sind.
Der letzte Befehl zeigt Informationen zum neu erstellten Hostprofil für den Benutzer an.
Beispiel 2: Klonen eines vorhandenen Hostprofils
PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfileDer erste Befehl ruft das Hostprofilobjekt namens HostProfile01 ab und speichert das Objekt in der $OrigHostProfile Variable.
Der zweite Befehl kopiert das in $OrigHostProfile gespeicherte Hostprofil, gibt ihn den angegebenen Namen und speichert das neue Profilobjekt in der $NewHostProfile Variablen.
Beispiel 3: Erstellen eines Hostprofils, das ein Hostnetzwerkadapterprofil enthält
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 $HostNetAdapterProfDer erste Befehl ruft das virtuelle Festplattenobjekt namens VHDX01.vhdx ab und speichert das Objekt in der $VHDX Variablen.
Der zweite Befehl ruft das Run As-Kontoobjekt namens DomainJoinRAA ab und speichert das Objekt in der $DomainJoinCreds Variablen.
Der dritte Befehl fordert den Benutzer für lokale Administratoranmeldeinformationen auf und speichert die bereitgestellten Anmeldeinformationen in der $LocalAdminCreds Variable.
Der vierte Befehl ruft das Hostnetzwerkadapterprofilobjekt mit der ID 259f47c7c7-c5a9-429d-a421-d232f9b34991 ab und speichert das Objekt in der $HostNetAdapterProf Variable.
Der letzte Befehl erstellt ein Hostprofil namens Hostprofil 03 mithilfe von VHDX01 und dem in $HostNetAdapterProf gespeicherten Hostnetzwerkadapterprofil.
Parameter
-AnswerFile
Gibt ein Skriptobjekt an, das in der VMM-Bibliothek (Virtual Machine Manager) gespeichert ist, die als Antwortdatei verwendet werden soll. Der Name des Antwortdateiskripts hängt von dem Betriebssystem ab, auf dem Sie die virtuelle Maschine installieren möchten:
- Sysprep.inf. Windows XP, Windows Server 2000 oder Windows Server 2003
- Unattend.xml. Windows Vista, Windows 7 oder Windows Server 2008
| Type: | Script |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Baseline
Gibt ein Array von Baseline-Objekten an.
| Type: | Baseline[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BypassVHDConversion
Gibt an, ob eine dynamische VHD, die an ein Hostprofil angefügt ist, während der Bereitstellung nicht in einen festen Typ konvertiert wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CodeIntegrityPolicy
Gibt eine Codeintegritätsrichtlinie an.
| Type: | CodeIntegrityPolicy |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerAccessRunAsAccount
Gibt den Computerzugriff als Konto an, mit dem der Computer bereitgestellt werden soll. Dieses Run As-Konto wird dem Computer als lokaler Administrator hinzugefügt und zum Verwalten des Computers verwendet.
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für das Hostprofil an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskConfiguration
Gibt die Datenträger- und Partitionskonfiguration für den physischen Computer an, der mit Windows Hyper-V bereitgestellt werden soll.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Domain
Gibt einen vollqualifizierten Domänennamen (FQDN) für eine Active Directory-Domäne an.
Beispielformat: -Domain "Domain01.Corp.Contoso.com"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainJoinRunAsAccount
Gibt ein Run As-Konto an, das über die Berechtigung zum Teilnehmen an der angegebenen Domäne verfügt.
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriverMatchingTag
Gibt die benutzerdefinierten Tags an, die während der Bereitstellung mit Treibereigenschaften übereinstimmen. Wenn Tags angegeben werden, entspricht der Bereitstellungsprozess den im Hostprofil angegebenen Tags mit den Tags in den Treibern, um übereinstimmende Treiber herunterzuladen und sie im Zielimage zu installieren.
| Type: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FullName
Gibt den Namen der Person an, in deren Namen eine virtuelle Maschine registriert ist.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GuiRunOnceCommands
Gibt ein Array von Befehlen an, die dem Abschnitt [GuiRunOnce] einer unbeaufsichtigten Antwortdatei hinzugefügt werden sollen. Verwenden Sie einzelne Anführungszeichen um jede Zeichenfolge, die in doppelte Anführungszeichen eingeschlossen ist.
Beispielformat: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'
Informationen dazu, wie Windows PowerShell Anführungszeichen verwendet, geben Sie den Typ Get-Help about_Quoting_Rules.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsGuarded
Gibt an, dass der Host ein guarded Host sein muss.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JoinWorkgroup
Gibt an, dass dieser Vorgang einer Arbeitsgruppe beigetreten ist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LocalAdministratorCredential
Gibt den Benutzernamen und das Kennwort für das lokale Administratorkonto (oder Linux-Stammkonto im Fall eines Linux-kompatiblen Gastbetriebssystemprofils) an.
Wenn Sie Anmeldeinformationen für eine neue oder vorhandene Vorlage angeben, in einem neuen oder vorhandenen Gastbetriebssystemprofil oder auf einem neuen virtuellen Computer werden alle vorhandenen Administratorkennworte außer Kraft gesetzt.
| Type: | VMMCredential |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt den Namen eines VMM-Objekts an.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OrganizationName
Gibt den Namen der Organisation für die Person an, deren Name ein virtueller Computer registriert ist.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Owner
Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an
- Beispielformat:
-Owner "Contoso\PattiFuller" - Beispielformat:
-Owner "PattiFuller@Contoso"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProductKey
Gibt einen Product Key an. Beim Product Key handelt es sich um eine 25-stellige Zahl zur Identifizierung der Produktlizenz. Ein Product Key kann verwendet werden, um VMM oder ein Betriebssystem zu registrieren, das auf einem virtuellen Computer oder Host installiert werden soll.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeZone
Gibt eine Zahl (ein Index) an, die eine geografische Region identifiziert, die dieselbe Standardzeit teilt.
Eine Liste der Zeitzonenindizes finden Sie unter Microsoft Time Zone Index Values at http://go.microsoft.com/fwlink/?LinkId=120935.
Wenn keine Zeitzone angegeben ist, wird als Standardzeitzone für eine virtuelle Maschine die gleiche Zeitzoneneinstellung wie auf dem Host für virtuelle Maschinen verwendet.
Beispielformat zum Angeben der GMT Standardzeitzone: -TimeZone 085
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDisk
Gibt ein virtuelles Festplattenobjekt an.
| Type: | VirtualHardDisk |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostNetworkAdapterProfile
Gibt ein Hostnetzwerkadapterprofilobjekt an.
| Type: | PhysicalComputerNetworkAdapterProfile[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostProfile
Gibt ein Hostprofilobjekt des virtuellen Computers an.
| Type: | PhysicalComputerProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMPaths
Gibt einen Satz Standardpfade (als durch den Pipelineoperator getrennte Zeichenfolgen) auf einem Host an, auf dem Dateien für virtuelle Maschinen gespeichert werden können.
Beispielformat: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Ausgaben
HostProfile
Dieses Cmdlet gibt ein HostProfile-Objekt zurück.