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 skapades tidigare 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

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 på 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

Type:	Script
Aliases:	SysPrepFile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AutoLogonCount

Anger hur många gånger som Windows automatiskt ska logga administratören som anges i svarsfilen till konsolsessionen.

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

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

-ComputerName

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

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

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

Anger en beskrivning av gästoperativsystemprofilen.

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

-DisableAutoLogon

Inaktiverar automatisk administratörsinloggning.

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

-Domain

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

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

Anger användarnamn och lösenord 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.

Type:	VMMCredential
Aliases:	JoinDomainCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainJoinOrganizationalUnit

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

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

-FullName

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

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

-GuestOSProfile

Anger ett gästoperativsystemprofilobjekt.

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

-GuiRunOnceCommands

Anger en matris med kommandon som ska läggas till i avsnittet [GuiRunOnce] 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.

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

-JobVariable

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

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

-LinuxAdministratorSSHKey

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

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

-LinuxAdministratorSSHKeyString

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

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

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

-LocalAdministratorCredential

Anger användarnamn och lösenord för det lokala administratörskontot (eller Linux-rotkontot när 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.

Type:	VMMCredential
Aliases:	AdminPasswordCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MergeAnswerFile

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

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

-Name

Anger namnet på ett VMM-objekt.

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

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

-OrganizationName

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

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

-Owner

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

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

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

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

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

-RemoveDomainJoinOrganizationalUnit

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

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

-RemoveServerFeatures

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

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

-RunAsynchronously

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

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

-Shielded

Anger om objektet är avskärmat.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 finns på den virtuella datorvärden.

Exempelformat för att ange GMT Standard Tidszon: -TimeZone 085

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

-UnattendSettings

Anger ett nyckel-/värdepar som består av Sträng, Sträng.

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

Anger ett användarrollobjekt.

Type:	UserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 för en mall eller på en gästoperativsystemprofil.

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

Utdata

GuestOSProfile

Den här cmdleten returnerar ett GuestOSProfile-objekt .

Kommentarer

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

Relaterade länkar

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