Set-SCVMHostProfile
Modifie les propriétés d’un profil hôte.
Syntax
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
L’applet de commande 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 035Cette 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 $HostNetAdapterProfLa 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 de 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 script stocké dans la bibliothèque VMM à utiliser en tant que fichier de réponses. Le nom du script de fichier de réponses dépend du système d’exploitation que vous voulez installer sur un ordinateur virtuel :
- 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Baseline
Spécifie un tableau d’objets De base .
| Type: | Baseline[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CodeIntegrityPolicy
Spécifie une stratégie d’intégrité du code.
| Type: | CodeIntegrityPolicy |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerAccessRunAsAccount
Spécifie le compte d’identification d’accès à 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Spécifie une description du profil hôte.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskConfiguration
Spécifie la configuration du disque et de la partition pour l’ordinateur physique à déployer avec Windows Hyper-V.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainJoinRunAsAccount
Spécifie un compte d’identification qui a l’autorisation de joindre le domaine spécifié.
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FullName
Spécifie le nom de la personne sous lequel un ordinateur virtuel est enregistré.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GuiRunOnceCommands
Spécifie un tableau de commandes à ajouter à la section [GuiRunOnce] d’un fichier de réponse sans assistance. Utilisez des guillemets simples autour de chaque chaîne placée 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsGuarded
Indique que l’hôte doit être un hôte protégé.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LocalAdministratorCredential
Spécifie le nom d’utilisateur et le mot de passe du compte administrateur local (ou du compte racine Linux dans le cas d’un profil de système d’exploitation invité compatible Linux).
La spécification des 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Spécifie le nom d’un objet VMM.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OrganizationName
Spécifie le nom de l’organisation de la personne dans laquelle un nom de machine virtuelle est inscrit.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveAnswerFile
Indique que cette opération supprime le fichier de réponse du profil hôte.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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, voir Valeurs d’index de fuseau horaire Microsoft à l’adresse 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 qui se trouve 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDisk
Spécifie un objet disque dur virtuel.
| Type: | VirtualHardDisk |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostNetworkAdapterProfile
Spécifie un tableau d’objets de profil de carte réseau hôte.
| Type: | PhysicalComputerNetworkAdapterProfile[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostProfile
Spécifie un objet de profil hôte de machine virtuelle.
| Type: | PhysicalComputerProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMPaths
Spécifie un ensemble de chemins d’accès par défaut (sous la forme de chaînes séparées par l’opérateur de pipeline) sur un ordinateur hôte où les fichiers de l’ordinateur virtuel peuvent être stockés.
Exemple de 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 |
Sorties
HostProfile[]
Cette applet de commande retourne un ou plusieurs objets HostProfile .