Set-SCVMHostProfile
Modyfikuje właściwości profilu hosta.
Składnia
Set-SCVMHostProfile
-VMHostProfile <PhysicalComputerProfile>
[-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
[[-Name] <String>]
[-VirtualHardDisk <VirtualHardDisk>]
[-Domain <String>]
[-DomainJoinRunAsAccount <RunAsAccount>]
[-LocalAdministratorCredential <VMMCredential>]
[-RemoveAnswerFile]
[-RemoveGuiRunOnceCommands]
[-Description <String>]
[-Owner <String>]
[-DiskConfiguration <String>]
[-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
[-VMPaths <String>]
[-FullName <String>]
[-GuiRunOnceCommands <String[]>]
[-IsGuarded <Boolean>]
[-CodeIntegrityPolicy <CodeIntegrityPolicy>]
[-OrganizationName <String>]
[-ProductKey <String>]
[-TimeZone <Int32>]
[-AnswerFile <Script>]
[-ComputerAccessRunAsAccount <RunAsAccount>]
[-Baseline <Baseline[]>]
[-JobGroup <Guid>]
[-BypassVHDConversion <Boolean>]
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Opis
Polecenie cmdlet Set-SCVMHostProfile modyfikuje właściwości profilu hosta.
Aby uzyskać informacje o sposobie tworzenia profilu hosta, wpisz Get-Help New-SCVMHostProfile -Detailed
.
Przykłady
Przykład 1. Ustawianie wartości strefy czasowej dla określonego profilu hosta
PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035
To polecenie pobiera obiekt profilu hosta o nazwie HostProfile01 i ustawia jego wartość strefy czasowej na wschodnią strefę czasową USA (035).
Przykład 2. Dodawanie profilu karty sieciowej hosta do profilu hosta
PS C:\> $VMHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> Set-SCVMHostProfile -VMHostPRofile $VMHostProfile -VMHostNetworkAdapterProfile $HostNetAdapterProf
Pierwsze polecenie pobiera obiekt profilu hosta o nazwie HostProfile01 i przechowuje obiekt w zmiennej $VMHostProfile.
Drugie polecenie pobiera obiekt profilu karty sieciowej hosta o identyfikatorze 259f47c7-c5a9-429d-a421-d232f9b34991 i przechowuje obiekt w zmiennej $HostNetAdapterProf.
Ostatnie polecenie dodaje profil karty sieciowej hosta przechowywany w $HostNetAdapterProf do elementu HostProfile01.
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 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Baseline
Określa tablicę obiektów linii bazowej
Typ: | Baseline[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-BypassVHDConversion
Wskazuje, czy dynamiczny dysk VHD dołączony do profilu hosta nie jest konwertowany na stały typ podczas wdrażania.
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-CodeIntegrityPolicy
Określa zasady integralności kodu.
Typ: | CodeIntegrityPolicy |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ComputerAccessRunAsAccount
Określa konto Uruchom jako do użycia w celu wdrożenia komputera. To konto Uruchom jako zostanie dodane do maszyny jako administrator lokalny i będzie używane do zarządzania maszyną.
Typ: | RunAsAccount |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Description
Określa opis profilu hosta.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DiskConfiguration
Określa konfigurację dysku i partycji dla komputera fizycznego, który ma zostać wdrożony z funkcją Hyper-V systemu Windows.
Typ: | String |
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 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DomainJoinRunAsAccount
Określa konto Uruchom jako, które ma uprawnienia do dołączania do określonej domeny.
Typ: | RunAsAccount |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DriverMatchingTag
Określa tagi niestandardowe, które mają być zgodne z właściwościami sterowników podczas wdrażania. Po określeniu tagów proces wdrażania jest zgodny z tagami określonymi w profilu hosta z tagami w sterownikach w celu pobrania pasujących sterowników i zainstalowania ich na obrazie docelowym.
Typ: | System.Collections.Generic.List`1[System.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 |
-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 |
-IsGuarded
Wskazuje, że host musi być hostem chronionym.
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-JobGroup
Określa identyfikator serii poleceń, które będą uruchamiane jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.
Typ: | Guid |
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 |
-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 |
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: | 0 |
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 |
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 |
-RemoveAnswerFile
Wskazuje, że ta operacja usuwa plik odpowiedzi z profilu hosta.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-RemoveGuiRunOnceCommands
Indie, że ta operacja usuwa właściwość Run Once Commands graficznego interfejsu użytkownika z profilu hosta.
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 |
-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 |
-VirtualHardDisk
Określa obiekt wirtualnego dysku twardego.
Typ: | VirtualHardDisk |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-VMHostNetworkAdapterProfile
Określa tablicę obiektów profilu karty sieciowej hosta.
Typ: | PhysicalComputerNetworkAdapterProfile[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-VMHostProfile
Określa obiekt profilu hosta maszyny wirtualnej.
Typ: | PhysicalComputerProfile |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-VMMServer
Określa obiekt serwera programu VMM.
Typ: | ServerConnection |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-VMPaths
Określa zestaw domyślnych ścieżek (jako ciągi oddzielone operatorem potoku) na hoście, na którym można przechowywać pliki maszyn wirtualnych.
Przykładowy format: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wyjściowe
HostProfile[]
To polecenie cmdlet zwraca co najmniej jeden obiekt HostProfile.