Set-SCGuestOSProfile

Module:

VirtualMachineManager

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

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

Description

De cmdlet Set-SCGuestOSProfile 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 gastbesturingssysteemprofiel zelf. Wijzigingen hebben geen invloed op bestaande virtuele machines die eerder zijn gemaakt met behulp van 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 gastbesturingssysteemprofielobject met de naam NewOSProfile01 opgehaald en wordt het object opgeslagen in de variabele $OSProfile.

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

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 gastbesturingssysteem met de naam MyCentOSProfile opgehaald en wordt het object opgeslagen in de variabele $OSProfile.

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 een antwoordbestand. De naam van het antwoordbestandsscript 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
Aliases:	SysPrepFile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoLogonCredential

Hiermee geeft u het Uitvoeren als-account in het antwoordbestand op dat door Windows wordt gebruikt om u aan te melden bij de consolesessie wanneer automatische aanmelding van beheerders is ingeschakeld.

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

-ComputerName

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

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

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

Hiermee geeft u een beschrijving voor het gastbesturingssysteemprofiel.

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

-DisableAutoLogon

Hiermee schakelt u automatische aanmelding van beheerders uit.

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

-Domain

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

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

Hiermee geeft u de gebruikersnaam en het wachtwoord 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 toevoegt. Dit omvat zowel virtuele als fysieke computers.

U kunt de huidige parameter gebruiken om referenties op te geven in 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, voor het toevoegen van een virtuele machine aan het domein.

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

-GuestOSProfile

Hiermee geeft u een gastbesturingssysteemprofielobject.

Type:	GuestOSProfile
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-GuiRunOnceCommands

Hiermee geeft u een matrix van opdrachten die moeten worden toegevoegd aan de sectie [GuiRunOnce] van een antwoordbestand zonder toezicht. Gebruik enkele aanhalingstekens rond elke tekenreeks tussen dubbele aanhalingstekens.

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

Typ voor informatie over hoe Windows PowerShell aanhalingstekens gebruiktGet-Help about_Quoting_Rules.

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

-LinuxAdministratorSSHKey

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

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

-LinuxAdministratorSSHKeyString

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

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

-Name

Hiermee geeft u de naam van een VMM-object.

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

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

-OrganizationName

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

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

-Owner

Geeft de eigenaar van een VMM-object aan in de vorm van een geldig domeingebruikersaccount.

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

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

-ProductKey

Hiermee geeft u een productcode op. De productcode is een getal van 25 cijfers dat de productlicentie identificeert. 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveDomainJoinOrganizationalUnit

Hiermee wordt aangegeven 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveServerFeatures

Hiermee wordt aangegeven dat met deze cmdlet alle serverfuncties en -onderdelen uit een sjabloon worden verwijderd.

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

-Shielded

Geeft aan of het object is afgeschermd.

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

-UnattendSettings

Hiermee geeft u een sleutel-waardepaar dat bestaat uit Tekenreeks, Tekenreeks.

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

Hiermee geeft u een gebruikersrolobject.

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

Uitvoerwaarden

GuestOSProfile

Deze cmdlet retourneert een GuestOSProfile-object .

Notities

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

Verwante koppelingen

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