Delen via


New-SCGuestOSProfile

Hiermee maakt u een gastbesturingssysteemprofiel voor gebruik in VMM.

Syntax

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

Description

De cmdlet New-SCGuestOSProfile maakt een gastbesturingssysteemprofiel voor gebruik in Virtual Machine Manager (VMM). Een gastbesturingssysteem is het besturingssysteem op een virtuele machine, in tegenstelling tot een hostbesturingssysteem dat zich op de fysieke hostcomputer bevindt waarop een of meer virtuele machines worden geïmplementeerd.

In een gastbesturingssysteemprofiel worden configuratiegegevens van het besturingssysteem opgeslagen. Een profiel bestaat uit een set eigenschappen met de meest voorkomende instellingen die zijn opgegeven in een antwoordbestand zonder toezicht (zoals een Sysprep.inf- of een Unattend.xml-bestand).

U kunt een profiel voor een zelfstandig gastbesturingssysteem maken of een sjabloon of virtuele machine aanpassen om profielinstellingen voor gastbesturingssystemen op te nemen. De cmdlet New-SCGuestOSProfile slaat het nieuwe profielobject van het gastbesturingssysteem op in de VMM-bibliotheek.

U kunt een gastbesturingssysteemprofiel maken op basis van standaardinstellingen, op basis van een bestaand gastbesturingssysteemprofiel, of u kunt instellingen aanpassen terwijl u het profiel maakt. Als u geen parameters opgeeft behalve de parameter Name, maakt de cmdlet New-SCGuestOSProfile een standaardprofielobject voor het gastbesturingssysteem.

Voorbeelden

Voorbeeld 1: Een standaardprofiel voor gastbesturingssysteem maken

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"}
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile01" -OperatingSystem $OS

Met de eerste opdracht wordt het besturingssysteemobject met de naam 64-bits editie van Windows Server 2008 R2 Enterprise opgehaald uit VMMServer01 en wordt het object opgeslagen in de variabele $OS.

Met de tweede opdracht maakt u een standaardprofiel voor het gastbesturingssysteem met de naam NewProfile01 en geeft u de naam van het besturingssysteem op.

Voorbeeld 2: Een gastbesturingssysteemprofiel maken om een virtuele machine aan een domein toe te voegen

PS C:\> $DomainCredential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile02" -JoinDomain "Contoso.com" -DomainJoinCredential $DomainCredential -OperatingSystem $OS

Met de eerste opdracht wordt het Run As-accountobject met de naam RunAsAccount01 opgehaald en wordt het object opgeslagen in de $DomainCredential variabele.

Met de tweede opdracht wordt het besturingssysteemobject met de naam 64-bits editie van Windows Server 2008 R2 Enterprise opgehaald uit VMMServer01 en wordt het object opgeslagen in de $OS variabele.

Met de laatste opdracht maakt u een gastbesturingssysteemprofiel met de naam NewOSProfile02 en geeft u de naam van het besturingssysteem op. Wanneer u NewOSProfile02 gebruikt om een virtuele machine te maken, gebruikt het profiel het opgegeven Uitvoeren als-account om de virtuele machine toe te voegen aan het Contoso.com domein.

Opmerking: Als u een PSCredential-object opgeeft in plaats van een RunAs-account voor de parameter DomainJoinCredential , is het raadzaam om alleen een account met beperkte rechten te gebruiken voor het automatisch toevoegen van een virtuele machine aan een domein, omdat de domeinnaam en het wachtwoord kort worden weergegeven in tekst zonder opmaak op de hostserver.

Voorbeeld 3: Een bestaand gastbesturingssysteemprofiel klonen

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile02"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Datacenter"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile03" -GuestOSProfile $OSProfile -ComputerName "Contoso03" -OperatingSystem $OS

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

Met de tweede opdracht wordt het besturingssysteemobject met de naam 64-bits editie van Windows Server 2008 R2 Datacenter opgehaald en wordt het object opgeslagen in de $OS variabele.

Met de laatste opdracht maakt u een gastbesturingssysteemprofiel met de naam NewOSProfile03, dat is gebaseerd op NewOSProfile02, maar wijzigt de computernaam en geeft u een andere naam voor het besturingssysteem. Alle andere instellingen in NewOSProfile03 zijn identiek aan die in NewOSProfile02.

Voorbeeld 4: Een Linux-gastbesturingssysteemprofiel maken en de Linux DNS-domeinnaam instellen

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "CentOS Linux 6 (64 bit)"} 
PS C:\> New-SCGuestOSProfile -Name "My CentOS Profile" -LinuxDomainName "contoso.com" -OperatingSystem $os

Met de eerste opdracht wordt het besturingssysteemobject met de naam CentOS Linux 6 (64-bits) opgehaald uit VMMServer01 en wordt het object opgeslagen in de $OS variabele.

Met de tweede opdracht maakt u een gastbesturingssysteemprofiel met de naam Mijn CentOS-profiel en geeft u de naam van het besturingssysteem en de Linux DNS-domeinnaam op. Wanneer u het My CentOS-profiel gebruikt om een virtuele machine te maken, gebruikt het profiel de opgegeven Linux DNS-domeinnaam.

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 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 windows gebruikt om u aan te melden bij de consolesessie wanneer automatische beheerdersaanmelding 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 door VMM uniek kan worden geïdentificeerd 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 wordt aangegeven dat met deze cmdlet automatische beheerdersaanmelding wordt uitgeschakeld.

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) 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 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 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 profielobject voor het gastbesturingssysteem op.

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

-GuiRunOnceCommands

Hiermee geeft u een matrix van opdrachten toe te voegen 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 Get-Help about_Quoting_Rulesgebruikt.

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 SSH-sleutel voor Linux-beheerders 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 het Linux-besturingssysteem.

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 beheerdersaccount (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 profiel voor een gastbesturingssysteem, 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:0
Default value:None
Required:True
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 u Get-SCOperatingSystem.

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 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
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 -functies 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) dat een geografische regio identificeert die dezelfde standaardtijd deelt. Zie Microsoft Time Zone Index Values op voor een lijst met tijdzone-indexen op http://go.microsoft.com/fwlink/?LinkId=120935. 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 op 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 op.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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 op 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

Met deze cmdlet wordt een GuestOSProfile-object geretourneerd.