Set-SCGuestOSProfile

Moduł:

VirtualMachineManager

Zmienia właściwości profilu systemu operacyjnego gościa używanego w programie VMM.

Składnia

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

Opis

Polecenie cmdlet Set-SCGuestOSProfile zmienia co najmniej jedną właściwość profilu systemu operacyjnego gościa używanego w środowisku programu Virtual Machine Manager (VMM). Zmiany wprowadzone w profilu systemu operacyjnego gościa mają wpływ tylko na sam profil systemu operacyjnego gościa. Zmiany nie mają wpływu na żadne istniejące maszyny wirtualne, które zostały wcześniej utworzone przy użyciu tego profilu.

Przykłady

Przykład 1. Określanie nazwy organizacji dla istniejącego profilu systemu operacyjnego gościa

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

Pierwsze polecenie pobiera obiekt profilu systemu operacyjnego gościa o nazwie NewOSProfile01 i przechowuje obiekt w zmiennej $OSProfile.

Drugie polecenie ustawia contoso jako nazwę organizacji profilu systemu operacyjnego gościa przechowywanego w $OSProfile.

Przykład 2. Określanie klucza SSHKey dla istniejącego profilu systemu operacyjnego gościa systemu 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

Pierwsze polecenie pobiera obiekt profilu systemu operacyjnego gościa o nazwie MyCentOSProfile i przechowuje obiekt w zmiennej $OSProfile.

Drugie polecenie pobiera obiekt SSHKey o nazwie My.Sshkey i przechowuje obiekt w zmiennej $Sshkey.

Ostatnie polecenie ustawia obiekt My.sshkey w profilu systemu operacyjnego gościa przechowywanym w $OSProfile.

Parametry

-AnswerFile

Określa obiekt skryptu przechowywany w bibliotece programu VMM do użycia jako plik odpowiedzi. Nazwa skryptu pliku odpowiedzi zależy od systemu operacyjnego, który chcesz zainstalować na maszynie wirtualnej:

• Pliku sysprep.inf. Windows XP, Windows Server 2000 lub Windows Server 2003
• Unattend.xml. Windows Vista, Windows 7 lub Windows Server 2008

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

-AutoLogonCount

Określa, ile razy system Windows powinien automatycznie rejestrować administratora określonego w pliku odpowiedzi w sesji konsoli.

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

-AutoLogonCredential

Określa konto Uruchom jako zawarte w pliku odpowiedzi używanym przez system Windows do logowania się do sesji konsoli po włączeniu automatycznego logowania administratora.

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

-ComputerName

Określa nazwę komputera, który program VMM może jednoznacznie zidentyfikować w sieci. Dopuszczalne wartości dla tego parametru to:

• Nazwa FQDN
• Adres IPv4 lub IPv6
• Nazwa 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

Określa opis profilu systemu operacyjnego gościa.

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

-DisableAutoLogon

Wyłącza automatyczne logowanie administratora.

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

-Domain

Określa w pełni kwalifikowaną nazwę domeny (FQDN) dla domeny usługi Active Directory.

Przykładowy format: -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

Określa nazwę użytkownika i hasło konta, które ma uprawnienia do przyłączania komputera do domeny. Zalecamy używanie konta z ograniczonymi prawami przyłączających komputery do domeny. Dotyczy to zarówno komputerów wirtualnych, jak i fizycznych.

Za pomocą bieżącego parametru można określić poświadczenia na maszynie wirtualnej VMHostProfile do przyłączenia komputera hosta fizycznego do domeny lub określić poświadczenia, w nowym lub istniejącym szablonie, w nowym lub istniejącym profilu systemu operacyjnego gościa lub na nowej maszynie wirtualnej, w celu przyłączenia maszyny wirtualnej do domeny.

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

-DomainJoinOrganizationalUnit

Określa jednostkę organizacyjną, do której komputer jest przyłączony podczas nienadzorowanej minikonfigurowania.

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

-FullName

Określa nazwę osoby, w której nazwa jest zarejestrowana maszyna wirtualna.

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

-GuestOSProfile

Określa obiekt profilu systemu operacyjnego gościa.

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

-GuiRunOnceCommands

Określa tablicę poleceń, które mają zostać dodane do sekcji [GuiRunOnce] pliku odpowiedzi nienadzorowanej. Używaj pojedynczych cudzysłowów wokół każdego ciągu ujętego w znaki podwójnego cudzysłowu.

Przykładowy format: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Aby uzyskać informacje o tym, jak Windows PowerShell używa cudzysłowów, wpisz Get-Help about_Quoting_Rules.

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

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

-LinuxAdministratorSSHKey

Określa plik klucza publicznego dla klucza SSH systemu Linux.

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

-LinuxAdministratorSSHKeyString

Określa klucz SSH administratora systemu Linux jako ciąg.

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

-LinuxDomainName

Określa w pełni kwalifikowaną nazwę domeny (FQDN) do użycia w połączeniu ze specjalizacją systemu operacyjnego Linux.

Przykładowy format: -LinuxDomainName "Domain01.Corp.Contoso.com"

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

-LocalAdministratorCredential

Określa nazwę użytkownika i hasło dla konta administratora lokalnego (lub konta głównego systemu Linux w przypadku profilu systemu operacyjnego gościa zgodnego z systemem Linux).

Określanie poświadczeń w nowym lub istniejącym szablonie, w nowym lub istniejącym profilu systemu operacyjnego gościa lub na nowej maszynie wirtualnej zastępuje wszelkie istniejące hasło administratora.

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

-MergeAnswerFile

Wskazuje, czy to polecenie cmdlet scala plik odpowiedzi wraz z ustawieniami systemu operacyjnego gościa. Wartość domyślna to $True. Konsola programu VMM używa tego parametru. Nie należy określać tego parametru.

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

-Name

Określa nazwę obiektu programu VMM.

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

-OperatingSystem

Określa typ systemu operacyjnego dla maszyny wirtualnej.

Aby uzyskać nazwy wszystkich dostępnych systemów operacyjnych w programie VMM, wpisz Get-SCOperatingSystem.

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

-OrganizationName

Określa nazwę organizacji dla osoby, w której nazwa maszyny wirtualnej jest zarejestrowana.

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

-Owner

Określa właściciela obiektu programu VMM w postaci prawidłowego konta użytkownika domeny.

• Przykładowy format: -Owner "Contoso\PattiFuller"
• Przykładowy format: -Owner "PattiFuller@Contoso"

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

-ProductKey

Określa klucz produktu. Klucz produktu to 25-cyfrowy numer identyfikujący licencję produktu. Klucz produktu może służyć do rejestrowania programu VMM lub systemu operacyjnego do zainstalowania na maszynie wirtualnej lub hoście.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RemoveDomainJoinOrganizationalUnit

Wskazuje, że to polecenie cmdlet usuwa jednostkę organizacyjną, którą komputer dołączył podczas instalacji.

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

-RemoveServerFeatures

Wskazuje, że to polecenie cmdlet usuwa wszystkie role i funkcje serwera z szablonu.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-Shielded

Wskazuje, czy obiekt jest chroniony.

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

-TimeZone

Określa liczbę (indeks), która identyfikuje region geograficzny, który współudzieli ten sam czas standardowy. Aby uzyskać listę indeksów strefy czasowej, zobacz Wartości indeksu strefy czasowej firmy Microsoft pod adresem http://go.microsoft.com/fwlink/?LinkId=120935. Jeśli strefa czasowa nie zostanie określona, domyślna strefa czasowa używana dla maszyny wirtualnej jest tym samym ustawieniem strefy czasowej, które znajduje się na hoście maszyny wirtualnej.

Przykładowy format określający strefę czasową standardową GMT: -TimeZone 085

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

-UnattendSettings

Określa parę klucz/wartość składającą się z Ciąg, Ciąg.

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

Określa obiekt roli użytkownika.

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

-Workgroup

Określa nowy lub istniejący szablon, w nowym lub istniejącym profilu systemu operacyjnego gościa lub na nowej maszynie wirtualnej nazwę grupy roboczej, do której chcesz dołączyć maszynę wirtualną. Za pomocą tego parametru można zastąpić istniejącą wartość szablonu lub profilu systemu operacyjnego gościa.

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

Dane wyjściowe

GuestOSProfile

To polecenie cmdlet zwraca obiekt GuestOSProfile .

Uwagi

• Wymaga obiektu profilu systemu operacyjnego gościa programu VMM, który można pobrać za pomocą polecenia cmdlet Get-SCGuestOSProfile .

Linki powiązane

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