Set-SCGuestOSProfile

Ändert die Eigenschaften eines Gastbetriebssystemprofils, das in VMM verwendet wird.

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

Das Cmdlet Set-SCGuestOSProfile ändert eine oder mehrere Eigenschaften eines Gastbetriebssystemprofils, das in einer Virtual Machine Manager -Umgebung (VMM) verwendet wird. An einem Gastbetriebssystem-Profil vorgenommene Änderungen wirken sich nur auf das Gastbetriebssystem-Profil 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 Gast-Betriebssystemprofilobjekt namens NewOSProfile01 ab und speichert das Objekt in der $OSProfile Variable.

Der zweite Befehl legt Contoso als Organisationsname für das in $OSProfile gespeicherte Gastbetriebssystemprofil fest.

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

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 namens MyCentOSProfile ab und speichert das Objekt in der $OSProfile Variable.

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

Der letzte Befehl legt das My.sshkey-Objekt auf dem in $OSProfile gespeicherten Gastbetriebssystemprofil fest.

Parameter

-AnswerFile

Gibt ein in der VMM-Bibliothek gespeichertes Skriptobjekt an, das 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
Aliases:SysPrepFile
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AutoLogonCount

Gibt die Anzahl der Zeiten an, in denen Windows den in der Antwortdatei angegebenen Administrator automatisch bei der Konsolensitzung protokollieren sollte.

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

-AutoLogonCredential

Gibt das in der Antwortdatei enthaltene Run As-Konto an, das Windows verwendet, um sich bei der Konsolensitzung anzumelden, wenn die automatische Administratoranmeldung aktiviert ist.

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

-ComputerName

Gibt den Namen eines Computers an, der von VMM eindeutig im Netzwerk identifiziert werden kann. Zulässige Werte für diesen Parameter:

  • FQDN
  • IPv4- oder IPv6-Adresse
  • NetBIOS-Name
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

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

-Description

Gibt eine Beschreibung für das Gastbetriebssystemprofil an.

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

-DisableAutoLogon

Deaktiviert die automatische Anmeldung des Administrators.

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

-DomainJoinCredential

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

Sie können den aktuellen Parameter verwenden, um Anmeldeinformationen auf einem VMHostProfile anzugeben, um einem physischen Hostcomputer der Domäne beizutreten, oder um Anmeldeinformationen, auf einer neuen oder vorhandenen Vorlage, auf einem neuen oder vorhandenen Gastbetriebssystemprofil oder auf einem neuen virtuellen Computer anzugeben, um einer virtuellen Maschine zur Domäne beizutreten.

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

-DomainJoinOrganizationalUnit

Gibt die Organisationseinheit an, der der Computer während eines unbeaufsichtigten Mini-Setups beigetreten ist.

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

-GuestOSProfile

Gibt ein Gastbetriebssystem-Profilobjekt an.

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

-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

-LinuxAdministratorSSHKey

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

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

-LinuxAdministratorSSHKeyString

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

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

-LinuxDomainName

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

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

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

-LocalAdministratorCredential

Gibt den Benutzernamen und das Kennwort für das lokale Administratorkonto an (oder Linux-Stammkonto im Fall eines Linux-kompatiblen Gastbetriebssystemprofils).

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

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-OperatingSystem

Gibt den Betriebssystemtyp für eine virtuelle Maschine an.

Geben Sie Get-SCOperatingSystemden Namen aller verfügbaren Betriebssysteme in VMM ein.

Type:OperatingSystem
Position:Named
Default value:None
Required:False
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
Aliases:OrgName
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

-RemoveDomainJoinOrganizationalUnit

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

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

-RemoveServerFeatures

Gibt an, dass dieses Cmdlet alle Serverrollen und Features aus einer Vorlage entfernt.

Type:SwitchParameter
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

-Shielded

Gibt an, ob das Objekt abgeschirmt ist.

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

-UnattendSettings

Gibt ein Schlüssel-/Wertpaar an, das aus String, String besteht.

Type:System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

Gibt ein Benutzerrollenobjekt an.

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

-Workgroup

Gibt auf einer neuen oder vorhandenen Vorlage, auf einem neuen oder vorhandenen Gastbetriebssystemprofil oder auf einem neuen virtuellen Computer den Namen der Arbeitsgruppe an, zu der Sie einem virtuellen Computer beitreten möchten. Mithilfe dieses Parameters können Sie den vorhandenen Wert in einer Vorlage oder einem Gastbetriebssystem-Profil überschreiben.

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