Freigeben über

Set-SCVMHostProfile

  • Referenz
Modul:
VirtualMachineManager

Ändert die Eigenschaften eines Hostprofils.

Syntax

Set-SCVMHostProfile
   -VMHostProfile <PhysicalComputerProfile>
   [-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
   [[-Name] <String>]
   [-VirtualHardDisk <VirtualHardDisk>]
   [-Domain <String>]
   [-DomainJoinRunAsAccount <RunAsAccount>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-RemoveAnswerFile]
   [-RemoveGuiRunOnceCommands]
   [-Description <String>]
   [-Owner <String>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-GuiRunOnceCommands <String[]>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-AnswerFile <Script>]
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-SCVMHostProfile ändert die Eigenschaften eines Hostprofils.

Geben Sie Get-Help New-SCVMHostProfile -Detailedein, um Informationen zum Erstellen eines Hostprofils zu erstellen.

Beispiele

Beispiel 1: Festlegen des Zeitzonenwerts für ein angegebenes Hostprofil

PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035

Dieser Befehl ruft das Hostprofilobjekt mit dem Namen HostProfile01 ab und legt seinen Zeitzonenwert auf die Zeitzone der USA (035) fest.

Beispiel 2: Hinzufügen eines Hostnetzwerkadapterprofils zu einem Hostprofil

PS C:\> $VMHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> Set-SCVMHostProfile -VMHostPRofile $VMHostProfile -VMHostNetworkAdapterProfile $HostNetAdapterProf

Der erste Befehl ruft das Hostprofilobjekt mit dem Namen HostProfile01 ab und speichert das Objekt in der $VMHostProfile Variablen.

Der zweite Befehl ruft das Profilobjekt des Hostnetzwerkadapters mit der ID 259f47c7-c5a9-429d-a421-d232f9b34991 ab und speichert das Objekt in der $HostNetAdapterProf Variablen.

Mit dem letzten Befehl wird das in $HostNetAdapterProf gespeicherte Hostnetzwerkadapterprofil zu HostProfile01 hinzugefügt.

Parameter

-AnswerFile

Gibt ein Skriptobjekt an, das in der VMM-Bibliothek als Antwortdatei verwendet werden soll. Der Name des Antwortdateiskripts hängt vom Betriebssystem ab, das Sie auf einem virtuellen Computer installieren möchten:

  • Sysprep.inf. Windows XP, Windows Server 2000 oder Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 oder Windows Server 2008
Typ:Script
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Baseline

Gibt ein Array von Baseline -Objekten an.

Typ:Baseline[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CodeIntegrityPolicy

Gibt eine Codeintegritätsrichtlinie an.

Typ:CodeIntegrityPolicy
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ComputerAccessRunAsAccount

Gibt den Computerzugriff auf "Ausführen als"-Konto an, das zum Bereitstellen des Computers verwendet werden soll. Dieses Konto "Ausführen als" wird dem Computer als lokaler Administrator hinzugefügt und zum Verwalten des Computers verwendet.

Typ:RunAsAccount
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für das Hostprofil an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DiskConfiguration

Gibt die Datenträger- und Partitionskonfiguration für den physischen Computer an, der mit Windows Hyper-V bereitgestellt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Domain

Gibt einen vollqualifizierten Domänennamen (FQDN) für eine Active Directory-Domäne an.

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainJoinRunAsAccount

Gibt ein Run As-Konto an, das über die Berechtigung zum Beitreten zur angegebenen Domäne verfügt.

Typ:RunAsAccount
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DriverMatchingTag

Gibt die benutzerdefinierten Tags an, die während der Bereitstellung mit Treibereigenschaften übereinstimmen sollen. Wenn Tags angegeben werden, entspricht der Bereitstellungsprozess den im Hostprofil angegebenen Tags mit den Tags in den Treibern, um übereinstimmende Treiber herunterzuladen und im Zielimage zu installieren.

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FullName

Gibt den Namen der Person an, in der ein virtueller Computer registriert ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GuiRunOnceCommands

Gibt ein Array von Befehlen an, die dem [GuiRunOnce] Abschnitt 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 Get-Help about_Quoting_Rulesein.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsGuarded

Gibt an, dass der Host ein geschützter Host sein muss.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobGroup

Gibt eine ID für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der dieselbe Auftragsgruppen-ID enthält.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LocalAdministratorCredential

Gibt den Benutzernamen und das Kennwort für das lokale Administratorkonto (oder das Linux-Stammkonto bei einem Linux-kompatiblen Gastbetriebssystemprofil) an.

Wenn Sie Anmeldeinformationen für eine neue oder vorhandene Vorlage, ein neues oder vorhandenes Gastbetriebssystemprofil angeben, oder auf einem neuen virtuellen Computer werden alle vorhandenen Administratorkennwörter außer Kraft gesetzt.

Typ:VMMCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines VMM-Objekts an.

Typ:String
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OrganizationName

Gibt den Namen der Organisation für die Person an, in der ein virtueller Computer registriert ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Owner

Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProductKey

Gibt einen Product Key an. Der Product Key ist eine 25-stellige Nummer, die die Produktlizenz identifiziert. Ein Product Key kann verwendet werden, um VMM oder ein Betriebssystem zu registrieren, das auf einem virtuellen Computer oder Host installiert werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveAnswerFile

Gibt an, dass dieser Vorgang die Antwortdatei aus dem Hostprofil entfernt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveGuiRunOnceCommands

Indient, dass dieser Vorgang die GUI Run Once Commands-Eigenschaft aus einem Hostprofil entfernt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeZone

Gibt eine Zahl (einen Index) an, die eine geografische Region identifiziert, die die gleiche Standardzeit hat. Eine Liste der Zeitzonenindizes finden Sie unter Microsoft Time Zone Index Values at http://go.microsoft.com/fwlink/?LinkId=120935. Wenn keine Zeitzone angegeben wird, ist die standardzeitzone, die für einen virtuellen Computer verwendet wird, dieselbe Zeitzoneneinstellung, die sich auf dem Host des virtuellen Computers befindet.

Beispielformat zum Angeben der GMT-Standardzeitzone: -TimeZone 085

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualHardDisk

Gibt ein virtuelles Festplattenobjekt an.

Typ:VirtualHardDisk
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMHostNetworkAdapterProfile

Gibt ein Array von Hostnetzwerkadapterprofilobjekten an.

Typ:PhysicalComputerNetworkAdapterProfile[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMHostProfile

Gibt ein Hostprofilobjekt eines virtuellen Computers an.

Typ:PhysicalComputerProfile
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMPaths

Gibt einen Satz von Standardpfaden (als durch den Pipelineoperator getrennte Zeichenfolgen) auf einem Host an, auf dem Dateien des virtuellen Computers gespeichert werden können.

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

HostProfile[]

Dieses Cmdlet gibt ein oder mehrere HostProfile--Objekte zurück.