Set-SCGuestOSProfile

Modul:

VirtualMachineManager

Změní vlastnosti profilu hostovaného operačního systému použitého v nástroji VMM.

Syntaxe

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 jenom 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: Zadání názvu 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í contoso jako název organizace pro profil hostovaného operačního systému uložený v $OSProfile.

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

Opatrnost

Tento článek odkazuje na CentOS, linuxovou distribuci, která dosáhla stavu Ukončení životnosti (EOL). Zvažte své použití a plánování odpovídajícím způsobem. Další informace najdete v pokynů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

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 $Sshkey proměnné.

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

Typ:	Script
Aliasy:	SysPrepFile
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-AutoLogonCount

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

Typ:	UInt32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	RunAsAccount
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ComputerName

Určuje název počítače, který může nástroj VMM jednoznačně identifikovat v síti. Přijatelné hodnoty pro tento parametr jsou:

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Description

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisableAutoLogon

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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"

Typ:	String
Aliasy:	JoinDomain
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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žít omezený účet práv připojující počítače k doméně. To zahrnuje virtuální i fyzické počítače.

Pomocí aktuálního parametru můžete zadat přihlašovací údaje na 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ě, profilu nového nebo existujícího 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ě.

Typ:	VMMCredential
Aliasy:	JoinDomainCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DomainJoinOrganizationalUnit

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-FullName

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-GuestOSProfile

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

Typ:	GuestOSProfile
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-GuiRunOnceCommands

Určuje pole příkazů, které se mají přidat do oddílu [GuiRunOnce] souboru bezobslužné odpovědi. Kolem 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.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LinuxAdministratorSSHKey

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

Typ:	SSHKey
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LinuxAdministratorSSHKeyString

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LinuxDomainName

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

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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ů 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 přepíše jakékoli stávající heslo správce.

Typ:	VMMCredential
Aliasy:	AdminPasswordCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MergeAnswerFile

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

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Určuje název objektu VMM.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	OperatingSystem
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-OrganizationName

Určuje název organizace osoby, jejíž jméno je virtuální počítač zaregistrovaný.

Typ:	String
Aliasy:	OrgName
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Owner

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

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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í počítač nebo hostitele.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	Guid
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RemoveDomainJoinOrganizationalUnit

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RemoveServerFeatures

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RunAsynchronously

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Shielded

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

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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ých pásem společnosti Microsoft na http://go.microsoft.com/fwlink/?LinkId=120935. Pokud není zadané žá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 zadání standardního časového pásma GMT: -TimeZone 085

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-UnattendSettings

Určuje pár klíč/hodnota skládající se z řetězcové, řetězcové.

Typ:	System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-UserRole

Určuje objekt role uživatele.

Typ:	UserRole
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	String
Aliasy:	JoinWorkgroup
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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-SCGuestOSPro file.

Související odkazy

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