Partager via


Set-SCVMHostProfile

Modifie les propriétés d’un profil hôte.

Syntaxe

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>]

Description

La cmdlet Set-SCVMHostProfile modifie les propriétés d’un profil hôte.

Pour plus d’informations sur la création d’un profil hôte, tapez Get-Help New-SCVMHostProfile -Detailed.

Exemples

Exemple 1 : Définir la valeur du fuseau horaire pour un profil hôte spécifié

PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035

Cette commande obtient l’objet de profil hôte nommé HostProfile01 et définit sa valeur de fuseau horaire sur le fuseau horaire américain (035).

Exemple 2 : Ajouter un profil de carte réseau hôte à un profil hôte

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

La première commande obtient l’objet de profil hôte nommé HostProfile01 et stocke l’objet dans la variable $VMHostProfile.

La deuxiè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 ajoute le profil de carte réseau hôte stocké dans $HostNetAdapterProf à HostProfile01.

Paramètres

-AnswerFile

Spécifie un objet de script stocké dans la bibliothèque 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:False
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:False
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 ID pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même ID 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

-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:False
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:False
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

-RemoveAnswerFile

Indique que cette opération supprime le fichier de réponses du profil hôte.

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

-RemoveGuiRunOnceCommands

Indetes que cette opération supprime la propriété Run Once Commands de l’interface utilisateur utilisateur d’un profil hôte.

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

-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:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMHostNetworkAdapterProfile

Spécifie un tableau d’objets 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 ou plusieurs objets HostProfile.