New-SCGuestOSProfile

Modul:

VirtualMachineManager

Skapar en gästoperativsystemprofil för användning i 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

Cmdleten New-SCGuestOSProfile skapar en gästoperativsystemprofil för användning i Virtual Machine Manager (VMM). Ett gästoperativsystem är operativsystemet på en virtuell dator, till skillnad från ett värdoperativsystem som finns på den fysiska värddatorn där en eller flera virtuella datorer distribueras.

En gästoperativsystemprofil lagrar konfigurationsinformation för operativsystemet. En profil består av en uppsättning egenskaper som innehåller de vanligaste inställningarna som anges i en obevakad svarsfil (till exempel en Sysprep.inf eller en Unattend.xml fil).

Du kan skapa en fristående gästoperativsystemprofil eller anpassa en mall eller virtuell dator för att inkludera profilinställningar för gästoperativsystem. Cmdleten New-SCGuestOSProfile lagrar det nya gästoperativsystemprofilobjektet i VMM-biblioteket.

Du kan skapa en gästoperativsystemprofil baserat på standardinställningarna, baserat på en befintlig profil för gästoperativsystem, eller så kan du anpassa inställningarna när du skapar profilen. Om du inte anger några parametrar förutom parametern Namn skapar New-SCGuestOSProfile cmdlet ett standardobjekt för gästoperativsystemprofilen.

Exempel

Exempel 1: Skapa en standardprofil för gästoperativsystem

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

Det första kommandot hämtar operativsystemobjektet "64-bitarsutgåvan av Windows Server 2008 R2 Enterprise" från VMMServer01 och lagrar objektet i variabeln $OS.

Det andra kommandot skapar en standardprofil för gästoperativsystem med namnet NewProfile01 och anger namnet på operativsystemet.

Exempel 2: Skapa en gästoperativsystemprofil som ska användas för att ansluta en virtuell dator till en domän

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

Det första kommandot hämtar Kör som-kontoobjektet med namnet RunAsAccount01 och lagrar objektet i variabeln $DomainCredential.

Det andra kommandot hämtar operativsystemobjektet med namnet 64-bitarsversionen av Windows Server 2008 R2 Enterprise från VMMServer01 och lagrar objektet i variabeln $OS.

Det sista kommandot skapar en gästoperativsystemprofil med namnet NewOSProfile02 och anger namnet på operativsystemet. När du använder NewOSProfile02 för att skapa en virtuell dator använder profilen det angivna Kör som-kontot för att ansluta den virtuella datorn till den Contoso.com domänen.

Obs! Om du anger ett PSCredential- objekt i stället för ett RunAs-konto för parametern DomainJoinCredential rekommenderar vi att du endast använder ett konto med begränsade rättigheter för att automatiskt ansluta en virtuell dator till en domän eftersom domännamnet och lösenordet visas kort i klartext på värdservern.

Exempel 3: Klona en befintlig gästoperativsystemprofil

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

Det första kommandot hämtar gästoperativsystemprofilobjektet NewOSProfile02 och lagrar objektet i variabeln $OSProfile.

Det andra kommandot hämtar operativsystemobjektet med namnet 64-bitarsutgåvan av Windows Server 2008 R2 Datacenter och lagrar objektet i variabeln $OS.

Det senaste kommandot skapar en gästoperativsystemprofil med namnet NewOSProfile03, som baseras på NewOSProfile02, men ändrar datornamnet och anger ett annat namn för operativsystemet. Alla andra inställningar i NewOSProfile03 är identiska med dem i NewOSProfile02.

Exempel 4: Skapa en Linux-gästoperativsystemprofil och ange Linux DNS-domännamnet

Försiktighet

Den här artikeln refererar till CentOS, en Linux-distribution som har nått EOL-status (End Of Life). Överväg att använda och planera i enlighet med detta. Mer information finns i vägledningen CentOS End Of Life.

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

Det första kommandot hämtar operativsystemobjektet CentOS Linux 6 (64 bitar) från VMMServer01 och lagrar objektet i variabeln $OS.

Det andra kommandot skapar en gästoperativsystemprofil med namnet My CentOS Profile och anger namnet på operativsystemet och Linux DNS-domännamnet. När du använder Min CentOS-profil för att skapa en virtuell dator använder profilen det angivna Linux DNS-domännamnet.

Parametrar

-AnswerFile

Anger ett skriptobjekt som lagras i VMM-biblioteket som ska användas som svarsfil. Namnet på svarsfilskriptet beror på vilket operativsystem du vill installera på en virtuell dator:

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

Typ:	Script
Alias:	SysPrepFile
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-AutoLogonCount

Anger antalet gånger som Windows automatiskt ska logga administratören som anges i svarsfilen på konsolsessionen.

Typ:	UInt32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AutoLogonCredential

Anger kör som-kontot som finns i svarsfilen som Windows använder för att logga in på konsolsessionen när automatisk administratörsinloggning är aktiverad.

Typ:	RunAsAccount
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ComputerName

Anger namnet på en dator som VMM unikt kan identifiera i nätverket. De godtagbara värdena för den här parametern är:

• FQDN
• IPv4- eller IPv6-adress
• NetBIOS-namn

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

Typ:	Boolean
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Description

Anger en beskrivning av gästoperativsystemprofilen.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisableAutoLogon

Anger att den här cmdleten inaktiverar automatisk administratörsinloggning.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Domain

Anger ett fullständigt kvalificerat domännamn (FQDN) för en Active Directory-domän.

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

Typ:	String
Alias:	JoinDomain
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DomainJoinCredential

Anger användarnamnet och lösenordet för ett konto som har behörighet att ansluta en dator till domänen. Vi rekommenderar att du använder ett konto med begränsade rättigheter som ansluter datorer till domänen. Detta omfattar både virtuella och fysiska datorer.

Du kan använda den aktuella parametern för att ange autentiseringsuppgifter på en VMHostProfile- för att ansluta en fysisk värddator till domänen, eller för att ange autentiseringsuppgifter, på en ny eller befintlig mall, på en ny eller befintlig gästoperativsystemprofil eller på en ny virtuell dator, för att ansluta en virtuell dator till domänen.

Typ:	VMMCredential
Alias:	JoinDomainCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DomainJoinOrganizationalUnit

Anger den organisationsenhet som datorn är ansluten till under en obevakad minikonfiguration.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-FullName

Anger namnet på den person i vars namn en virtuell dator är registrerad.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-GuestOSProfile

Anger ett gästoperativsystemprofilobjekt.

Typ:	GuestOSProfile
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-GuiRunOnceCommands

Anger en matris med kommandon som ska läggas till i [GuiRunOnce] avsnitt i en obevakad svarsfil. Använd enkla citattecken runt varje sträng som omges av dubbla citattecken.

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

Om du vill ha information om hur Windows PowerShell använder citattecken skriver du Get-Help about_Quoting_Rules.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln med namnet av den här parametern.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-LinuxAdministratorSSHKey

Anger den offentliga nyckelfilen för en Linux SSH-nyckel.

Typ:	SSHKey
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-LinuxAdministratorSSHKeyString

Anger en SSH-nyckel för Linux-administratör som en sträng.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-LinuxDomainName

Anger ett fullständigt kvalificerat domännamn (FQDN) som ska användas tillsammans med Linux-operativsystemets specialisering.

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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-LocalAdministratorCredential

Anger användarnamnet och lösenordet för det lokala administratörskontot (eller Linux-rotkontot om det gäller en Linux-kompatibel gästoperativsystemprofil).

Om du anger autentiseringsuppgifter för en ny eller befintlig mall, på en ny eller befintlig gästoperativsystemprofil eller på en ny virtuell dator åsidosätts alla befintliga administratörslösenord.

Typ:	VMMCredential
Alias:	AdminPasswordCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MergeAnswerFile

Anger om den här cmdleten sammanfogar svarsfilen med inställningar för gästoperativsystem. Standardvärdet är $True. VMM-konsolen använder den här parametern. Ange inte den här parametern.

Typ:	Boolean
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Anger namnet på ett VMM-objekt.

Typ:	String
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-OperatingSystem

Anger typ av operativsystem för en virtuell dator. Om du vill hämta namnen på alla tillgängliga operativsystem i VMM skriver du Get-SCOperatingSystem.

Typ:	OperatingSystem
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-OrganizationName

Anger namnet på organisationen för den person i vars namn en virtuell dator är registrerad.

Typ:	String
Alias:	OrgName
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Owner

Anger ägaren till ett VMM-objekt i form av ett giltigt domänanvändarkonto.

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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ProductKey

Anger en produktnyckel. Produktnyckeln är ett 25-siffrigt nummer som identifierar produktlicensen. En produktnyckel kan användas för att registrera VMM eller ett operativsystem som ska installeras på en virtuell dator eller värd.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PROTipID

Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

Typ:	Guid
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RemoveDomainJoinOrganizationalUnit

Anger att den här cmdleten tar bort den organisationsenhet som datorn anslöt under installationen.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RemoveServerFeatures

Anger att den här cmdleten tar bort alla serverroller och funktioner från en mall.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen omedelbart återgår till kommandogränssnittet.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Shielded

Anger om objektet är avskärmat.

Typ:	Boolean
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-TimeZone

Anger ett tal (ett index) som identifierar en geografisk region som delar samma standardtid. En lista över tidszonsindex finns i Microsoft Time Zone Index Values at http://go.microsoft.com/fwlink/?LinkId=120935. Om ingen tidszon har angetts är standardtidszonen som används för en virtuell dator samma tidszonsinställning som på den virtuella datorvärden.

Exempelformat för att ange gmt standardtidszonen: -TimeZone 085

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UnattendSettings

Anger ett nyckel/värde-par som består av String, String.

Typ:	System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UserRole

Anger ett användarrollobjekt.

Typ:	UserRole
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-VMMServer

Anger ett VMM-serverobjekt.

Typ:	ServerConnection
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Workgroup

Anger på en ny eller befintlig mall, på en ny eller befintlig gästoperativsystemprofil eller på en ny virtuell dator namnet på den arbetsgrupp som du vill ansluta till en virtuell dator. Du kan använda den här parametern för att åsidosätta det befintliga värdet i en mall eller på en gästoperativsystemprofil.

Typ:	String
Alias:	JoinWorkgroup
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Utdata

GuestOSProfile

Den här cmdleten returnerar ett GuestOSProfile-objekt.

Relaterade länkar

• Get-SCGuestOSProfile
• Get-SCOperatingSystem
• Get-SCRunAsAccount
• Remove-SCGuestOSProfile
• Set-SCGuestOSProfile