Udostępnij za pośrednictwem

New-SCVMHostProfile

  • Odwołanie
Moduł:
VirtualMachineManager

Tworzy profil hosta.

Składnia

New-SCVMHostProfile
   [-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   -Domain <String>
   -DomainJoinRunAsAccount <RunAsAccount>
   -LocalAdministratorCredential <VMMCredential>
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-GuiRunOnceCommands <String[]>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostProfile
   -VMHostProfile <PhysicalComputerProfile>
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   [-JoinWorkgroup]
   -LocalAdministratorCredential <VMMCredential>
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-GuiRunOnceCommands <String[]>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   -Domain <String>
   -DomainJoinRunAsAccount <RunAsAccount>
   -LocalAdministratorCredential <VMMCredential>
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-GuiRunOnceCommands <String[]>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-SCVMHostProfile tworzy profil hosta. Profile hostów zawierają ustawienia konfiguracji sprzętu i systemu operacyjnego używane do wdrażania komputera fizycznego jako hosta funkcji Hyper-V.

Przed utworzeniem profilu hosta upewnij się, że określony plik wirtualnego dysku twardego (vhd) istnieje w udziale bibliotecznym.

Przykłady

Przykład 1. Tworzenie profilu hosta

PS C:\> $VHD = Get-SCVirtualHardDisk -Name "VHD01.vhd"
PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAcct01"
PS C:\> $Credential = Get-Credential
PS C:\> $HostProfile = New-SCVMHostProfile -Name "HostProfile01" -Owner "Contoso\Katarina" -Description "Host Profile 01" -Domain "Contoso.com" -DomainJoinRunAsAccount $RunAsAcct -VirtualHardDisk $VHD -LocalAdministratorCredential $Credential
PS C:\> $HostProfile

Pierwsze polecenie pobiera wirtualny obiekt dysku twardego o nazwie VHD01.vhd i przechowuje obiekt w zmiennej $VHD.

Drugie polecenie wyświetla monit o podanie poświadczeń. Po wyświetleniu monitu wprowadź poświadczenia konta administratora. Polecenie przechowuje poświadczenia w zmiennej $Credential.

Trzecie polecenie tworzy profil hosta o nazwie HostProfile01 przy użyciu wirtualnego dysku twardego przechowywanego w $VHD i poświadczeń przechowywanych w $Credential.

Ostatnie polecenie wyświetla informacje o nowo utworzonym profilu hosta dla użytkownika.

Przykład 2. Klonowanie istniejącego profilu hosta

PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfile

Pierwsze polecenie pobiera obiekt profilu hosta o nazwie HostProfile01 i przechowuje obiekt w zmiennej $OrigHostProfile.

Drugie polecenie kopiuje profil hosta przechowywany w $OrigHostProfile, nadaje mu określoną nazwę i przechowuje nowy obiekt profilu w zmiennej $NewHostProfile.

Przykład 3. Tworzenie profilu hosta zawierającego profil karty sieciowej hosta

PS C:\> $VHDX = Get-SCVirtualHardDisk -Name "VHDX01.vhdx"
PS C:\> $DomainJoinCreds = Get-SCRunAsAccount -Name "DomainJoinRAA"
PS C:\> $LocalAdminCreds = Get-Credential
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> New-SCVMHostProfile -Name "HostProfile03" -Owner "Contoso\Katarina" -Description "Host Profile 03" -Domain "Contoso.com" -DomainJoinRunAsAccount $DomainJoinCreds -VirtualHardDisk $VHDX -LocalAdministratorCredential $LocalAdminCreds -VMHostNetworkAdapterProfile $HostNetAdapterProf

Pierwsze polecenie pobiera wirtualny obiekt dysku twardego o nazwie VHDX01.vhdx i przechowuje obiekt w zmiennej $VHDX.

Drugie polecenie pobiera obiekt konta Uruchom jako o nazwie DomainJoinRAA i przechowuje obiekt w zmiennej $DomainJoinCreds.

Trzecie polecenie wyświetla użytkownikowi poświadczenia administratora lokalnego i przechowuje podane poświadczenia w zmiennej $LocalAdminCreds.

Czwarte polecenie pobiera obiekt profilu karty sieciowej hosta o identyfikatorze 259f47c7-c5a9-429d-a421-d232f9b34991 i przechowuje obiekt w zmiennej $HostNetAdapterProf.

Ostatnie polecenie tworzy profil hosta o nazwie Profil hosta 03 przy użyciu dysku VHDX01 i profilu karty sieciowej hosta przechowywanego w $HostNetAdapterProf.

Parametry

-AnswerFile

Określa obiekt skryptu przechowywany w bibliotece programu Virtual Machine Manager (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
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Baseline

Określa tablicę obiektów punktu odniesienia .

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

-BypassVHDConversion

Wskazuje, czy dynamiczny dysk VHD dołączony do profilu hosta nie jest konwertowany na stały typ podczas wdrażania.

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

-CodeIntegrityPolicy

Określa zasady integralności kodu.

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

-ComputerAccessRunAsAccount

Określa dostęp do konta Uruchom jako komputera do wdrożenia komputera. To konto Uruchom jako jest dodawane do maszyny jako administrator lokalny i używane do zarządzania maszyną.

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

-Description

Określa opis profilu hosta.

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

-DiskConfiguration

Określa konfigurację dysku i partycji dla komputera fizycznego, który ma zostać wdrożony z funkcją Hyper-V systemu Windows.

Type:String
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
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DomainJoinRunAsAccount

Określa konto Uruchom jako, które ma uprawnienia do dołączania do określonej domeny.

Type:RunAsAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:System.Collections.Generic.List`1[System.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

-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

-IsGuarded

Wskazuje, że host musi być hostem chronionym.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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ń.

Type:Guid
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

-JoinWorkgroup

Wskazuje, że ta operacja łączy grupę roboczą.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę obiektu programu VMM.

Type:String
Position:0
Default value:None
Required:True
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
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

-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

-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

-VirtualHardDisk

Określa obiekt wirtualnego dysku twardego.

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

-VMHostNetworkAdapterProfile

Określa obiekt profilu karty sieciowej hosta.

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

-VMHostProfile

Określa obiekt profilu hosta maszyny wirtualnej.

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

-VMMServer

Określa obiekt serwera programu VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 maszyny wirtualnej.

Przykładowy format: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

Dane wyjściowe

HostProfile

To polecenie cmdlet zwraca obiekt HostProfile .