Udostępnij za pośrednictwem


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.