Set-SCGuestOSProfile

Referenz

Modul:: VirtualMachineManager

Ändert die Eigenschaften eines in VMM verwendeten Gastbetriebssystemprofils.

Syntax

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   -Domain <String>
   [-DeploymentTypeNano <Boolean>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Workgroup <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Die Set-SCGuestOSProfile Cmdlet ändert eine oder mehrere Eigenschaften eines Gastbetriebssystemprofils, das in einer VMM-Umgebung (Virtual Machine Manager) verwendet wird. Änderungen an einem Gastbetriebssystemprofil wirken sich nur auf das Gastbetriebssystemprofil selbst aus. Änderungen wirken sich nicht auf vorhandene virtuelle Computer aus, die zuvor mithilfe dieses Profils erstellt wurden.

Beispiele

Beispiel 1: Angeben eines Organisationsnamens für ein vorhandenes Gastbetriebssystemprofil

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -OrgName "Contoso"

Der erste Befehl ruft das Gastbetriebssystemprofilobjekt namens NewOSProfile01 ab und speichert das Objekt in der $OSProfile Variablen.

Mit dem zweiten Befehl wird Contoso als Organisationsname für das in $OSProfile gespeicherte Gastbetriebssystemprofil festgelegt.

Beispiel 2: Angeben eines SSHKeys für ein vorhandenes Linux-Gastbetriebssystemprofil

Vorsicht

In diesem Artikel wird auf CentOS verwiesen, eine Linux-Verteilung, die den Status "End Of Life" (EOL) erreicht hat. Bitte berücksichtigen Sie Ihre Nutzung und Planung entsprechend. Weitere Informationen finden Sie in der CentOS End Of Life-Anleitung.

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "My CentOS Profile"
PS C:\> $Sshkey = Get-SCSSHKey -Name "My.Sshkey"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -LinuxAdministratorSSHKey $Sshkey

Der erste Befehl ruft das Gastbetriebssystemprofilobjekt mit dem Namen MyCentOSProfile ab und speichert das Objekt in der $OSProfile Variablen.

Der zweite Befehl ruft das SSHKey-Objekt mit dem Namen My.Sshkey ab und speichert das Objekt in der $Sshkey Variablen.

Mit dem letzten Befehl wird das My.sshkey-Objekt auf dem in $OSProfile gespeicherten Gastbetriebssystemprofil festgelegt.

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
Aliase:	SysPrepFile
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-AutoLogonCount

Gibt an, wie oft Windows den in der Antwortdatei angegebenen Administrator automatisch bei der Konsolensitzung protokollieren soll.

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

-AutoLogonCredential

Gibt das In der Antwortdatei enthaltene Konto "Ausführen als" an, das Windows zum Anmelden bei der Konsolensitzung verwendet, wenn die automatische Administratoranmeldung aktiviert ist.

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

-ComputerName

Gibt den Namen eines Computers an, den VMM in Ihrem Netzwerk eindeutig identifizieren kann. Die zulässigen Werte für diesen Parameter sind:

FQDN
IPv4- oder IPv6-Adresse
NetBIOS-Name

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

-DeploymentTypeNano

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

-Description

Gibt eine Beschreibung für das Gastbetriebssystemprofil an.

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

-DisableAutoLogon

Deaktiviert die automatische Administratoranmeldung.

Typ:	SwitchParameter
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
Aliase:	JoinDomain
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DomainJoinCredential

Gibt den Benutzernamen und das Kennwort eines Kontos an, das über die Berechtigung zum Beitritt zu einem Computer zur Domäne verfügt. Es wird empfohlen, ein eingeschränktes Rechtekonto zu verwenden, das Computer mit der Domäne beitritt. Dies umfasst sowohl virtuelle als auch physische Computer.

Mit dem aktuellen Parameter können Sie Anmeldeinformationen für eine VMHostProfile- angeben, um einen physischen Hostcomputer zur Domäne hinzuzufügen, oder um Anmeldeinformationen, eine neue oder vorhandene Vorlage, ein neues oder vorhandenes Gastbetriebssystemprofil oder auf einem neuen virtuellen Computer anzugeben, um einen virtuellen Computer mit der Domäne zu verknüpfen.

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

-DomainJoinOrganizationalUnit

Gibt die Organisationseinheit an, mit der der Computer während einer unbeaufsichtigten Minieinrichtung verbunden ist.

Typ:	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

-GuestOSProfile

Gibt ein Gastbetriebssystemprofilobjekt an.

Typ:	GuestOSProfile
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
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

-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

-LinuxAdministratorSSHKey

Gibt die Öffentliche Schlüsseldatei für einen Linux-SSH-Schlüssel an.

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

-LinuxAdministratorSSHKeyString

Gibt einen Linux-Administrator-SSH-Schlüssel als Zeichenfolge an.

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

-LinuxDomainName

Gibt einen vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) an, der in Verbindung mit der Linux-Betriebssystemspezialisierung verwendet werden soll.

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

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
Aliase:	AdminPasswordCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MergeAnswerFile

Gibt an, ob dieses Cmdlet die Antwortdatei zusammen mit den Einstellungen des Gastbetriebssystems zusammenführt. Der Standardwert ist $True. Die VMM-Konsole verwendet diesen Parameter. Geben Sie diesen Parameter nicht an.

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-OperatingSystem

Gibt den Typ des Betriebssystems für einen virtuellen Computer an.

Geben Sie Get-SCOperatingSystemein, um die Namen aller verfügbaren Betriebssysteme in VMM abzurufen.

Typ:	OperatingSystem
Position:	Named
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
Aliase:	OrgName
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

-RemoveDomainJoinOrganizationalUnit

Gibt an, dass dieses Cmdlet die Organisationseinheit entfernt, die der Computer während des Setups beigetreten ist.

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

-RemoveServerFeatures

Gibt an, dass dieses Cmdlet alle Serverrollen und Features aus einer Vorlage 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

-Shielded

Gibt an, ob das Objekt abgeschirmt ist.

Typ:	Boolean
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

-UnattendSettings

Gibt ein Schlüssel-Wert-Paar an, das aus String, Stringbesteht.

Typ:	System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UserRole

Gibt ein Benutzerrollenobjekt an.

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

-Workgroup

Gibt für eine neue oder vorhandene Vorlage, für ein neues oder vorhandenes Gastbetriebssystemprofil oder auf einem neuen virtuellen Computer den Namen der Arbeitsgruppe an, der Sie einem virtuellen Computer beitreten möchten. Sie können diesen Parameter verwenden, um den vorhandenen Wert in einer Vorlage oder in einem Gastbetriebssystemprofil außer Kraft zu setzen.

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

Ausgaben

GuestOSProfile

Dieses Cmdlet gibt ein GuestOSProfile--Objekt zurück.

Hinweise

Erfordert ein VMM-Gastbetriebssystemprofilobjekt, das mithilfe des Cmdlets Get-SCGuestOSProfile abgerufen werden kann.

Freigeben über