New-SCVMHostProfile
Crée un profil hôte.
Syntaxe
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>] Description
La cmdlet New-SCVMHostProfile crée un profil hôte. Les profils hôtes contiennent les paramètres de configuration du matériel et du système d’exploitation utilisés pour déployer un ordinateur physique en tant qu’hôte Hyper-V.
Avant de créer un profil hôte, vérifiez que le fichier de disque dur virtuel (.vhd) que vous spécifiez existe dans un partage de bibliothèque.
Exemples
Exemple 1 : Créer un profil hôte
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:\> $HostProfileLa première commande obtient l’objet de disque dur virtuel nommé VHD01.vhd et stocke l’objet dans la variable $VHD.
La deuxième commande vous invite à entrer les informations d’identification. À l’invite, entrez les informations d’identification d’un compte Administrateur. La commande stocke les informations d’identification dans la variable $Credential.
La troisième commande crée un profil hôte nommé HostProfile01 à l’aide du disque dur virtuel stocké dans $VHD et des informations d’identification stockées dans $Credential.
La dernière commande affiche des informations sur le profil hôte nouvellement créé à l’utilisateur.
Exemple 2 : Cloner un profil hôte existant
PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfileLa première commande obtient l’objet de profil hôte nommé HostProfile01 et stocke l’objet dans la variable $OrigHostProfile.
La deuxième commande copie le profil hôte stocké dans $OrigHostProfile, lui donne le nom spécifié et stocke le nouvel objet de profil dans la variable $NewHostProfile.
Exemple 3 : Créer un profil hôte qui inclut un profil de carte réseau hôte
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 $HostNetAdapterProfLa première commande obtient l’objet de disque dur virtuel nommé VHDX01.vhdx et stocke l’objet dans la variable $VHDX.
La deuxième commande obtient l’objet de compte d’identification nommé DomainJoinRAA et stocke l’objet dans la variable $DomainJoinCreds.
La troisième commande invite l’utilisateur à entrer les informations d’identification de l’administrateur local et stocke les informations d’identification fournies dans la variable $LocalAdminCreds.
La quatrième commande obtient l’objet de profil de carte réseau hôte avec l’ID 259f47c7-c5a9-429d-a421-d232f9b34991 et stocke l’objet dans la variable $HostNetAdapterProf.
La dernière commande crée un profil hôte nommé Host Profile 03 à l’aide de VHDX01 et du profil de carte réseau hôte stocké dans $HostNetAdapterProf.
Paramètres
-AnswerFile
Spécifie un objet de script stocké dans la bibliothèque Virtual Machine Manager (VMM) à utiliser comme fichier de réponses. Le nom du script de fichier de réponses dépend du système d’exploitation que vous souhaitez installer sur une machine virtuelle :
- Sysprep.inf. Windows XP, Windows Server 2000 ou Windows Server 2003
- Unattend.xml. Windows Vista, Windows 7 ou Windows Server 2008
| Type: | Script |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Baseline
Spécifie un tableau d’objets base de référence
| Type: | Baseline[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BypassVHDConversion
Indique si un disque dur virtuel dynamique attaché à un profil hôte n’est pas converti en type fixe pendant le déploiement.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-CodeIntegrityPolicy
Spécifie une stratégie d’intégrité du code.
| Type: | CodeIntegrityPolicy |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ComputerAccessRunAsAccount
Spécifie le compte d’identification d’accès de l’ordinateur à utiliser pour déployer l’ordinateur. Ce compte d’identification est ajouté à l’ordinateur en tant qu’administrateur local et utilisé pour gérer l’ordinateur.
| Type: | RunAsAccount |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Description
Spécifie une description du profil hôte.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DiskConfiguration
Spécifie la configuration du disque et de la partition de l’ordinateur physique à déployer avec Windows Hyper-V.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Domain
Spécifie un nom de domaine complet (FQDN) pour un domaine Active Directory.
Exemple de format : -Domain "Domain01.Corp.Contoso.com"
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DomainJoinRunAsAccount
Spécifie un compte d’identification qui a l’autorisation de joindre le domaine spécifié.
| Type: | RunAsAccount |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DriverMatchingTag
Spécifie les balises personnalisées à mettre en correspondance avec les propriétés du pilote pendant le déploiement. Lorsque des balises sont spécifiées, le processus de déploiement correspond aux balises spécifiées dans le profil hôte avec les balises dans les pilotes afin de télécharger les pilotes correspondants et de les installer dans l’image cible.
| Type: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-FullName
Spécifie le nom de la personne dans laquelle le nom d’une machine virtuelle est inscrit.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-GuiRunOnceCommands
Spécifie un tableau de commandes à ajouter à l'[GuiRunOnce] section d’un fichier de réponses sans assistance. Utilisez des guillemets simples autour de chaque chaîne entre guillemets doubles.
Exemple de format : -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'
Pour plus d’informations sur la façon dont Windows PowerShell utilise des guillemets, tapez Get-Help about_Quoting_Rules.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-IsGuarded
Indique que l’hôte doit être un hôte protégé.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobGroup
Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobVariable
Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JoinWorkgroup
Indique que cette opération joint un groupe de travail.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-LocalAdministratorCredential
Spécifie le nom d’utilisateur et le mot de passe du compte Administrateur local (ou compte racine Linux dans le cas d’un profil de système d’exploitation invité compatible Linux).
La spécification d’informations d’identification sur un modèle nouveau ou existant, sur un profil de système d’exploitation invité ou sur une nouvelle machine virtuelle remplace tout mot de passe Administrateur existant.
| Type: | VMMCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom d’un objet VMM.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-OrganizationName
Spécifie le nom de l’organisation pour la personne dans laquelle un nom de machine virtuelle est inscrit.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Owner
Spécifie le propriétaire d’un objet VMM sous la forme d’un compte d’utilisateur de domaine valide.
- Exemple de format :
-Owner "Contoso\PattiFuller" - Exemple de format :
-Owner "PattiFuller@Contoso"
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ProductKey
Spécifie une clé de produit. La clé de produit est un numéro à 25 chiffres qui identifie la licence du produit. Une clé de produit peut être utilisée pour inscrire VMM ou un système d’exploitation à installer sur une machine virtuelle ou un hôte.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PROTipID
Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunAsynchronously
Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TimeZone
Spécifie un nombre (index) qui identifie une région géographique qui partage le même temps standard.
Pour obtenir la liste des index de fuseau horaire, consultez valeurs d’index de fuseau horaire Microsoft à http://go.microsoft.com/fwlink/?LinkId=120935.
Si aucun fuseau horaire n’est spécifié, le fuseau horaire par défaut utilisé pour une machine virtuelle est le même paramètre de fuseau horaire sur l’hôte de la machine virtuelle.
Exemple de format pour spécifier le fuseau horaire GMT Standard : -TimeZone 085
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VirtualHardDisk
Spécifie un objet de disque dur virtuel.
| Type: | VirtualHardDisk |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VMHostNetworkAdapterProfile
Spécifie un objet de profil de carte réseau hôte.
| Type: | PhysicalComputerNetworkAdapterProfile[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VMHostProfile
Spécifie un objet de profil hôte de machine virtuelle.
| Type: | PhysicalComputerProfile |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-VMPaths
Spécifie un ensemble de chemins d’accès par défaut (sous forme de chaînes séparées par l’opérateur de pipeline) sur un hôte où les fichiers de machine virtuelle peuvent être stockés.
Exemple de format : -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Sorties
HostProfile
Cette applet de commande retourne un objet HostProfile.