Set-SCGuestOSProfile
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 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 nazwę firmy Contoso jako nazwę organizacji dla profilu systemu operacyjnego gościa przechowywanego w $OSProfile.
Przykład 2. Określanie klucza SSHKey dla istniejącego profilu systemu operacyjnego gościa systemu operacyjnego Linux
Ostrożność
W tym artykule odwołuje się do systemu CentOS — dystrybucji systemu Linux, która osiągnęła stan Zakończenia życia (EOL). Rozważ odpowiednie użycie i planowanie. Aby uzyskać więcej informacji, zobacz wskazówki dotyczące 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 $SshkeyPierwsze 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:
- Sysprep.inf. Windows XP, Windows Server 2000 lub Windows Server 2003
- Unattend.xml. Windows Vista, Windows 7 lub Windows Server 2008
| Typ: | Script |
| Aliasy: | SysPrepFile |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-AutoLogonCount
Określa liczbę prób automatycznego rejestrowania administratora określonego w pliku odpowiedzi w sesji konsoli systemu Windows.
| Typ: | UInt32 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | RunAsAccount |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ComputerName
Określa nazwę komputera, który program VMM może jednoznacznie zidentyfikować w sieci. Dopuszczalne wartości tego parametru to:
- FQDN
- Adres IPv4 lub IPv6
- Nazwa NetBIOS
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DeploymentTypeNano
{{Fill DeploymentTypeNano Description}}
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Description
Określa opis profilu systemu operacyjnego gościa.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DisableAutoLogon
Wyłącza automatyczne logowanie administratora.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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"
| Typ: | String |
| Aliasy: | JoinDomain |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DomainJoinCredential
Określa nazwę użytkownika i hasło konta, które ma uprawnienia do przyłączenia komputera do domeny. Zalecamy używanie ograniczonego konta praw przyłączanego komputerów do domeny. Dotyczy to zarówno komputerów wirtualnych, jak i fizycznych.
Można użyć bieżącego parametru, aby określić poświadczenia na VMHostProfile do przyłączenia fizycznego komputera hosta do domeny lub określić poświadczenia, na nowym lub istniejącym szablonie, w nowym lub istniejącym profilu systemu operacyjnego gościa lub na nowej maszynie wirtualnej, do przyłączenia maszyny wirtualnej do domeny.
| Typ: | VMMCredential |
| Aliasy: | JoinDomainCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DomainJoinOrganizationalUnit
Określa jednostkę organizacyjną, do której komputer jest przyłączony podczas nienadzorowanej minikonfiguratora.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-FullName
Określa nazwę osoby, w której jest zarejestrowana nazwa maszyny wirtualnej.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-GuestOSProfile
Określa obiekt profilu systemu operacyjnego gościa.
| Typ: | GuestOSProfile |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-GuiRunOnceCommands
Określa tablicę poleceń, które mają zostać dodane do [GuiRunOnce] sekcji pliku odpowiedzi nienadzorowanej. Użyj pojedynczych cudzysłowów wokół każdego ciągu ujętego w podwójny cudzysłów.
Przykładowy format: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'
Aby uzyskać informacje o sposobie korzystania z cudzysłowów w programie Windows PowerShell, wpisz Get-Help about_Quoting_Rules.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-LinuxAdministratorSSHKey
Określa plik klucza publicznego dla klucza SSH systemu Linux.
| Typ: | SSHKey |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-LinuxAdministratorSSHKeyString
Określa klucz SSH administratora systemu Linux jako ciąg.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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"
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | VMMCredential |
| Aliasy: | AdminPasswordCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Określa nazwę obiektu programu VMM.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | OperatingSystem |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-OrganizationName
Określa nazwę organizacji dla osoby, w której jest zarejestrowana nazwa maszyny wirtualnej.
| Typ: | String |
| Aliasy: | OrgName |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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"
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Guid |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-RemoveDomainJoinOrganizationalUnit
Wskazuje, że to polecenie cmdlet usuwa jednostkę organizacyjną, którą komputer dołączył podczas instalacji.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-RemoveServerFeatures
Wskazuje, że to polecenie cmdlet usuwa wszystkie role i funkcje serwera z szablonu.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Shielded
Wskazuje, czy obiekt jest chroniony.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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 nie określono żadnej strefy czasowej, 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ą GMT w warstwie Standardowa: -TimeZone 085
| Typ: | Int32 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UnattendSettings
Określa parę klucz/wartość składającą się z String, String.
| Typ: | System.Collections.Generic.Dictionary`2[System.String,System.String] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UserRole
Określa obiekt roli użytkownika.
| Typ: | UserRole |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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ą. Tego parametru można użyć do zastąpienia istniejącej wartości szablonu lub profilu systemu operacyjnego gościa.
| Typ: | String |
| Aliasy: | JoinWorkgroup |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wyjściowe
GuestOSProfile
To polecenie cmdlet zwraca obiekt
Uwagi
- Wymaga obiektu profilu systemu operacyjnego gościa programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCGuestOSProfile.