Set-SCGuestOSProfile

Module:

VirtualMachineManager

Hiermee wijzigt u de eigenschappen van een gastbesturingssysteemprofiel dat wordt gebruikt in VMM.

Syntaxis

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>]

Description

De Set-SCGuestOSProfile cmdlet wijzigt een of meer eigenschappen van een gastbesturingssysteemprofiel dat wordt gebruikt in een VMM-omgeving (Virtual Machine Manager). Wijzigingen in een gastbesturingssysteemprofiel zijn alleen van invloed op het profiel van het gastbesturingssysteem zelf. Wijzigingen hebben geen invloed op bestaande virtuele machines die eerder zijn gemaakt met dit profiel.

Voorbeelden

Voorbeeld 1: Geef een organisatienaam op voor een bestaand gastbesturingssysteemprofiel

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

Met de eerste opdracht wordt het gast-os-profielobject met de naam NewOSProfile01 opgehaald en wordt het object opgeslagen in de $OSProfile variabele.

Met de tweede opdracht wordt Contoso ingesteld als de organisatienaam voor het gastbesturingssysteemprofiel dat is opgeslagen in $OSProfile.

Voorbeeld 2: Een SSHKey opgeven voor een bestaand Linux-gastbesturingssysteemprofiel

Voorzichtigheid

Dit artikel verwijst naar CentOS, een Linux-distributie die de EOL-status (End Of Life) heeft bereikt. Overweeg uw gebruik en planning dienovereenkomstig. Zie de Richtlijnen voor het einde van de levensduur van CentOS voor meer informatie.

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

Met de eerste opdracht wordt het profielobject van het gastbesturingssystemen met de naam MyCentOSProfile opgehaald en wordt het object opgeslagen in de $OSProfile variabele.

Met de tweede opdracht wordt het SSHKey-object met de naam My.Sshkey opgehaald en wordt het object opgeslagen in de $Sshkey variabele.

Met de laatste opdracht wordt het object My.sshkey ingesteld op het profiel van het gastbesturingssysteem dat is opgeslagen in $OSProfile.

Parameters

-AnswerFile

Hiermee geeft u een scriptobject op dat is opgeslagen in de VMM-bibliotheek die moet worden gebruikt als antwoordbestand. De naam van het antwoordbestandscript is afhankelijk van het besturingssysteem dat u wilt installeren op een virtuele machine:

• Sysprep.inf. Windows XP, Windows Server 2000 of Windows Server 2003
• Unattend.xml. Windows Vista, Windows 7 of Windows Server 2008

Type:	Script
Aliassen:	SysPrepFile
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AutoLogonCount

Hiermee geeft u het aantal keren op dat Windows automatisch de beheerder moet registreren die is opgegeven in het antwoordbestand op de consolesessie.

Type:	UInt32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AutoLogonCredential

Hiermee geeft u het Uitvoeren als-account in het antwoordbestand dat windows gebruikt om u aan te melden bij de consolesessie wanneer automatische beheerdersaanmelding is ingeschakeld.

Type:	RunAsAccount
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ComputerName

Hiermee geeft u de naam op van een computer die VMM uniek kan identificeren in uw netwerk. De acceptabele waarden voor deze parameter zijn:

• FQDN
• IPv4- of IPv6-adres
• NetBIOS-naam

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

Type:	Boolean
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Description

Hiermee geeft u een beschrijving voor het gastbesturingssysteemprofiel.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisableAutoLogon

Hiermee schakelt u automatische aanmelding van beheerders uit.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Domain

Hiermee geeft u een FQDN (Fully Qualified Domain Name) voor een Active Directory-domein.

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

Type:	String
Aliassen:	JoinDomain
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DomainJoinCredential

Hiermee geeft u de gebruikersnaam en het wachtwoord op van een account dat gemachtigd is om een computer aan het domein toe te voegen. U wordt aangeraden een beperkt rechtenaccount te gebruiken dat computers aan het domein voegt. Dit omvat zowel virtuele als fysieke computers.

U kunt de huidige parameter gebruiken om referenties op te geven op een VMHostProfile voor het toevoegen van een fysieke hostcomputer aan het domein, of om referenties op te geven, op een nieuwe of bestaande sjabloon, op een nieuw of bestaand gastbesturingssysteemprofiel, of op een nieuwe virtuele machine, om een virtuele machine toe te voegen aan het domein.

Type:	VMMCredential
Aliassen:	JoinDomainCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DomainJoinOrganizationalUnit

Hiermee geeft u de organisatie-eenheid waaraan de computer wordt toegevoegd tijdens een mini-installatie zonder toezicht.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-FullName

Hiermee geeft u de naam van de persoon in wiens naam een virtuele machine is geregistreerd.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-GuestOSProfile

Hiermee geeft u een gastbesturingssysteemprofielobject.

Type:	GuestOSProfile
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-GuiRunOnceCommands

Hiermee geeft u een matrix van opdrachten toe te voegen aan de [GuiRunOnce] sectie van een onbeheerd antwoordbestand. Gebruik enkele aanhalingstekens rond elke tekenreeks tussen dubbele aanhalingstekens.

Voorbeeldindeling: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Typ Get-Help about_Quoting_Rulesvoor informatie over hoe Windows PowerShell aanhalingstekens gebruikt.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-LinuxAdministratorSSHKey

Hiermee geeft u het openbare-sleutelbestand voor een Linux SSH-sleutel.

Type:	SSHKey
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-LinuxAdministratorSSHKeyString

Hiermee geeft u een Linux-beheerders-SSH-sleutel op als een tekenreeks.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-LinuxDomainName

Hiermee geeft u een FQDN (Fully Qualified Domain Name) op die moet worden gebruikt in combinatie met specialisatie van Linux-besturingssystemen.

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

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-LocalAdministratorCredential

Hiermee geeft u de gebruikersnaam en het wachtwoord voor het lokale administrator-account (of Linux-hoofdaccount in het geval van een linux-compatibel gastbesturingssysteemprofiel).

Als u referenties opgeeft voor een nieuwe of bestaande sjabloon, op een nieuw of bestaand gastbesturingssysteemprofiel, of op een nieuwe virtuele machine, wordt een bestaand beheerderswachtwoord overschreven.

Type:	VMMCredential
Aliassen:	AdminPasswordCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MergeAnswerFile

Hiermee wordt aangegeven of met deze cmdlet het antwoordbestand wordt samengevoegd met instellingen van het gastbesturingssysteem. De standaardwaarde is $True. In de VMM-console wordt deze parameter gebruikt. Geef deze parameter niet op.

Type:	Boolean
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-OperatingSystem

Hiermee geeft u het type besturingssysteem voor een virtuele machine.

Als u de namen van alle beschikbare besturingssystemen in VMM wilt ophalen, typt u Get-SCOperatingSystem.

Type:	OperatingSystem
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-OrganizationName

Hiermee geeft u de naam van de organisatie voor de persoon in wiens naam een virtuele machine is geregistreerd.

Type:	String
Aliassen:	OrgName
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Owner

Hiermee geeft u de eigenaar van een VMM-object in de vorm van een geldig domeingebruikersaccount.

• Voorbeeldindeling: -Owner "Contoso\PattiFuller"
• Voorbeeldindeling: -Owner "PattiFuller@Contoso"

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ProductKey

Hiermee geeft u een productcode op. De productcode is een getal van 25 cijfers waarmee de productlicentie wordt geïdentificeerd. Een productcode kan worden gebruikt om VMM of een besturingssysteem te registreren dat moet worden geïnstalleerd op een virtuele machine of host.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:	Guid
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RemoveDomainJoinOrganizationalUnit

Geeft aan dat met deze cmdlet de organisatie-eenheid wordt verwijderd die tijdens de installatie is toegevoegd aan de computer.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RemoveServerFeatures

Geeft aan dat met deze cmdlet alle serverfuncties en -onderdelen uit een sjabloon worden verwijderd.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Shielded

Geeft aan of het object is afgeschermd.

Type:	Boolean
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-TimeZone

Hiermee geeft u een getal (een index) aan dat een geografische regio identificeert die dezelfde standaardtijd deelt. Zie Microsoft Time Zone Index Values op http://go.microsoft.com/fwlink/?LinkId=120935voor een lijst met tijdzone-indexen. Als er geen tijdzone is opgegeven, is de standaardtijdzone die wordt gebruikt voor een virtuele machine dezelfde tijdzone-instelling die zich op de host van de virtuele machine bevindt.

Voorbeeldindeling voor het opgeven van de gmt-standaardtijdzone: -TimeZone 085

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UnattendSettings

Hiermee geeft u een sleutel/waardepaar op dat bestaat uit tekenreeks, tekenreeks.

Type:	System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UserRole

Hiermee geeft u een gebruikersrolobject.

Type:	UserRole
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Workgroup

Hiermee geeft u op een nieuwe of bestaande sjabloon, op een nieuw of bestaand gastbesturingssysteemprofiel, of op een nieuwe virtuele machine de naam van de werkgroep waaraan u een virtuele machine wilt toevoegen. U kunt deze parameter gebruiken om de bestaande waarde op een sjabloon of in een gastbesturingssysteemprofiel te overschrijven.

Type:	String
Aliassen:	JoinWorkgroup
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Uitvoerwaarden

GuestOSProfile

Met deze cmdlet wordt een GuestOSProfile--object geretourneerd.

Notities

• Hiervoor is een VMM-profielobject voor het gastbesturingssysteem vereist, dat kan worden opgehaald met behulp van de Get-SCGuestOSProfile cmdlet.

Verwante koppelingen

• Get-SCGuestOSProfile
• New-SCGuestOSProfile
• Remove-SCGuestOSProfile