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-SCOperatingSystem
den 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.