Set-SCGuestOSProfile

Modul:

VirtualMachineManager

Změní vlastnosti profilu hostovaného operačního systému použitého v nástroji 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

Rutina Set-SCGuestOSProfile změní jednu nebo více vlastností profilu hostovaného operačního systému používaného v prostředí Nástroje Virtual Machine Manager (VMM). Změny provedené v profilu hostovaného operačního systému mají vliv pouze na samotný profil hostovaného operačního systému. Změny nemají vliv na žádné existující virtuální počítače, které byly dříve vytvořeny pomocí tohoto profilu.

Příklady

Příklad 1: Zadejte název organizace pro existující profil hostovaného operačního systému.

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

První příkaz získá objekt profilu hostovaného operačního systému s názvem NewOSProfile01 a uloží objekt do proměnné $OSProfile.

Druhý příkaz nastaví společnost Contoso jako název organizace profilu hostovaného operačního systému uloženého v $OSProfile.

Příklad 2: Zadání klíče SSHKey pro existující profil hostovaného operačního systému Linux

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

První příkaz získá objekt profilu hostovaného operačního systému s názvem MyCentOSProfile a uloží objekt do proměnné $OSProfile.

Druhý příkaz získá objekt SSHKey s názvem My.Sshkey a uloží objekt do proměnné $Sshkey.

Poslední příkaz nastaví objekt My.sshkey v profilu hostovaného operačního systému uloženém v $OSProfile.

Parametry

-AnswerFile

Určuje objekt skriptu uložený v knihovně VMM, který se má použít jako soubor odpovědí. Název skriptu souboru odpovědí závisí na operačním systému, který chcete nainstalovat na virtuální počítač:

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

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

-AutoLogonCount

Určuje počet, kolikrát by systém Windows měl automaticky protokolovat správce zadaný v souboru odpovědí do relace konzoly.

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

-AutoLogonCredential

Určuje účet Spustit jako obsažený v souboru odpovědí, který systém Windows používá k přihlášení k relaci konzoly při povolení automatického přihlášení správce.

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

-ComputerName

Určuje název počítače, který nástroj VMM může jedinečně identifikovat ve vaší síti. Tento parametr přijímá tyto hodnoty:

• FQDN
• Adresa IPv4 nebo IPv6
• Název rozhraní NetBIOS

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

Určuje popis profilu hostovaného operačního systému.

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

-DisableAutoLogon

Zakáže automatické přihlášení správce.

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

-Domain

Určuje plně kvalifikovaný název domény (FQDN) pro doménu služby Active Directory.

Příklad formátu: -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

Určuje uživatelské jméno a heslo účtu, který má oprávnění připojit počítač k doméně. Doporučujeme používat účet s omezenými právy připojující počítače k doméně. To zahrnuje virtuální i fyzické počítače.

Aktuální parametr můžete použít k zadání přihlašovacích údajů v souboru VMHostProfile pro připojení fyzického hostitelského počítače k doméně nebo k zadání přihlašovacích údajů v nové nebo existující šabloně, v novém nebo existujícím profilu hostovaného operačního systému nebo na novém virtuálním počítači pro připojení virtuálního počítače k doméně.

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

-DomainJoinOrganizationalUnit

Určuje organizační jednotku, ke které je počítač připojený během bezobslužného mini-setupu.

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

-FullName

Určuje jméno osoby, ve které je virtuální počítač zaregistrovaný.

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

-GuestOSProfile

Určuje objekt profilu hostovaného operačního systému.

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

-GuiRunOnceCommands

Určuje pole příkazů, které se mají přidat do oddílu [GuiRunOnce] souboru bezobslužné odpovědi. U každého řetězce uzavřeného do dvojitých uvozovek použijte jednoduché uvozovky.

Příklad formátu: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Informace o tom, jak Windows PowerShell používá uvozovky, zadejte Get-Help about_Quoting_Rules.

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-LinuxAdministratorSSHKey

Určuje soubor veřejného klíče pro klíč SSH s Linuxem.

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

-LinuxAdministratorSSHKeyString

Určuje klíč SSH správce Linuxu jako řetězec.

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

-LinuxDomainName

Určuje plně kvalifikovaný název domény (FQDN), který se použije ve spojení s specializacemi operačního systému Linux.

Příklad formátu: -LinuxDomainName "Domain01.Corp.Contoso.com"

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

-LocalAdministratorCredential

Určuje uživatelské jméno a heslo pro účet místního správce (nebo kořenový účet Linuxu v případě profilu hostovaného operačního systému kompatibilního s Linuxem).

Zadání přihlašovacích údajů pro novou nebo existující šablonu, v novém nebo existujícím profilu hostovaného operačního systému nebo na novém virtuálním počítači přepíše jakékoli stávající heslo správce.

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

-MergeAnswerFile

Určuje, jestli tato rutina sloučí soubor odpovědí společně s nastavením hostovaného operačního systému. Výchozí hodnota je $True. Konzola VMM používá tento parametr. Tento parametr nezadávejte.

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

-Name

Určuje název objektu VMM.

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

-OperatingSystem

Určuje typ operačního systému pro virtuální počítač.

Chcete-li získat názvy všech dostupných operačních systémů v nástroji VMM, zadejte Get-SCOperatingSystem.

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

-OrganizationName

Určuje jméno organizace osoby, ve které je virtuální počítač zaregistrovaný.

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

-Owner

Určuje vlastníka objektu VMM ve formátu platného uživatelského účtu domény.

• Příklad formátu: -Owner "Contoso\PattiFuller"
• Příklad formátu: -Owner "PattiFuller@Contoso"

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

-ProductKey

Určuje kód Product Key. Kód Product Key je 25místné číslo, které identifikuje licenci produktu. Kód Product Key lze použít k registraci nástroje VMM nebo operačního systému, který se má nainstalovat na virtuálním počítači nebo hostiteli.

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

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (tip PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

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

-RemoveDomainJoinOrganizationalUnit

Označuje, že tato rutina odebere organizační jednotku, kterou počítač připojil během instalace.

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

-RemoveServerFeatures

Označuje, že tato rutina odebere ze šablony všechny role a funkce serveru.

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

-RunAsynchronously

Označuje, že úloha se spouští asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

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

-Shielded

Určuje, zda je objekt stíněný.

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

-TimeZone

Určuje číslo (index), které identifikuje geografickou oblast, která sdílí stejný standardní čas. Seznam indexů časových pásem najdete v tématu Hodnoty indexu časového pásma společnosti Microsoft na adrese http://go.microsoft.com/fwlink/?LinkId=120935. Pokud není zadáno žádné časové pásmo, výchozí časové pásmo použité pro virtuální počítač je stejné nastavení časového pásma, které je na hostiteli virtuálního počítače.

Příklad formátu pro určení standardního časového pásma GMT: -TimeZone 085

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

-UnattendSettings

Určuje pár klíč/hodnota skládající se z string, String.

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

Určuje objekt role uživatele.

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

-Workgroup

Určuje novou nebo existující šablonu, v novém nebo existujícím profilu hostovaného operačního systému nebo na novém virtuálním počítači název pracovní skupiny, ke které chcete připojit virtuální počítač. Tento parametr můžete použít k přepsání existující hodnoty v šabloně nebo v profilu hostovaného operačního systému.

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

Výstupy

GuestOSProfile

Tato rutina vrátí objekt GuestOSProfile .

Poznámky

• Vyžaduje objekt profilu hostovaného operačního systému VMM, který lze načíst pomocí rutiny Get-SCGuestOSProfile .

Související odkazy

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