Set-SCGuestOSProfile

Modul:

VirtualMachineManager

Ändrar egenskaperna för en gästoperativsystemprofil som används i VMM.

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

Cmdleten Set-SCGuestOSProfile ändrar en eller flera egenskaper för en gästoperativsystemprofil som används i en VMM-miljö (Virtual Machine Manager). Ändringar som görs i en gästoperativsystemprofil påverkar endast själva gästoperativsystemprofilen. Ändringar påverkar inte befintliga virtuella datorer som tidigare har skapats med hjälp av den här profilen.

Exempel

Exempel 1: Ange ett organisationsnamn för en befintlig gästoperativsystemprofil

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

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

Det andra kommandot anger Contoso som organisationsnamn för gästoperativsystemprofilen som lagras i $OSProfile.

Exempel 2: Ange en SSHKey för en befintlig Linux-gästoperativsystemprofil

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:\> $OSProfile = Get-SCGuestOSProfile -Name "My CentOS Profile"
PS C:\> $Sshkey = Get-SCSSHKey -Name "My.Sshkey"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -LinuxAdministratorSSHKey $Sshkey

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

Det andra kommandot hämtar SSHKey-objektet med namnet My.Sshkey och lagrar objektet i variabeln $Sshkey.

Det sista kommandot anger objektet My.sshkey i gästoperativsystemprofilen som lagras i $OSProfile.

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

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:	0
Standardvärde:	None
Obligatorisk:	True
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:	Named
Standardvärde:	None
Obligatorisk:	False
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

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

Kommentarer

• Kräver ett VMM-gästoperativsystemprofilobjekt som kan hämtas med hjälp av cmdleten Get-SCGuestOSProfile.

Relaterade länkar

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