Set-SCGuestOSProfile

Module:

VirtualMachineManager

Modifie les propriétés d’un profil de système d’exploitation invité utilisé dans VMM.

Syntaxe

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   -Domain <String>
   [-DeploymentTypeNano <Boolean>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Workgroup <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

La Set-SCGuestOSProfile applet de commande modifie une ou plusieurs propriétés d’un profil de système d’exploitation invité utilisé dans un environnement VMM (Virtual Machine Manager). Les modifications apportées à un profil de système d’exploitation invité affectent uniquement le profil du système d’exploitation invité lui-même. Les modifications n’affectent pas les machines virtuelles existantes qui ont été créées précédemment à l’aide de ce profil.

Exemples

Exemple 1 : Spécifier un nom d’organisation pour un profil de système d’exploitation invité existant

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -OrgName "Contoso"

La première commande obtient l’objet de profil du système d’exploitation invité nommé NewOSProfile01 et stocke l’objet dans la variable $OSProfile.

La deuxième commande définit Contoso comme nom d’organisation pour le profil du système d’exploitation invité stocké dans $OSProfile.

Exemple 2 : Spécifier une clé SSH pour un profil de système d’exploitation invité Linux existant

Attention

Cet article fait référence à CentOS, une distribution Linux qui a atteint l’état EOL (fin du service). Veuillez considérer votre utilisation et votre planification en conséquence. Pour plus d’informations, consultez l’aide relative à la fin de vie de CentOS.

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "My CentOS Profile"
PS C:\> $Sshkey = Get-SCSSHKey -Name "My.Sshkey"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -LinuxAdministratorSSHKey $Sshkey

La première commande obtient l’objet de profil du système d’exploitation invité nommé MyCentOSProfile et stocke l’objet dans la variable $OSProfile.

La deuxième commande obtient l’objet SSHKey nommé My.Sshkey et stocke l’objet dans la variable $Sshkey.

La dernière commande définit l’objet My.sshkey sur le profil du système d’exploitation invité stocké dans $OSProfile.

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
Alias:	SysPrepFile
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-AutoLogonCount

Spécifie le nombre de fois où Windows doit enregistrer automatiquement l’administrateur spécifié dans le fichier de réponses sur la session de console.

Type:	UInt32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AutoLogonCredential

Spécifie le compte d’identification contenu dans le fichier de réponses que Windows utilise pour se connecter à la session de console lorsque l’ouverture de session d’administrateur automatique est activée.

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

-ComputerName

Spécifie le nom d’un ordinateur que VMM peut identifier de manière unique sur votre réseau. Les valeurs acceptables pour ce paramètre sont les suivantes :

• FQDN
• Adresse IPv4 ou IPv6
• Nom NetBIOS

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

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

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

-Description

Spécifie une description du profil du système d’exploitation invité.

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

-DisableAutoLogon

Désactive l’ouverture de session d’administrateur automatique.

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

-Domain

Spécifie un nom de domaine complet (FQDN) pour un domaine Active Directory.

Exemple de format : -Domain "Domain01.Corp.Contoso.com"

Type:	String
Alias:	JoinDomain
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DomainJoinCredential

Spécifie le nom d’utilisateur et le mot de passe d’un compte autorisé à joindre un ordinateur au domaine. Nous vous recommandons d’utiliser un compte de droits limité qui joint des ordinateurs au domaine. Cela inclut les ordinateurs virtuels et physiques.

Vous pouvez utiliser le paramètre actuel pour spécifier des informations d’identification sur un VMHostProfile pour joindre un ordinateur hôte physique au domaine, ou pour spécifier 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, pour joindre une machine virtuelle au domaine.

Type:	VMMCredential
Alias:	JoinDomainCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DomainJoinOrganizationalUnit

Spécifie l’unité d’organisation à laquelle l’ordinateur est joint pendant une mini-installation sans assistance.

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

-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

-GuestOSProfile

Spécifie un objet de profil de système d’exploitation invité.

Type:	GuestOSProfile
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
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

-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

-LinuxAdministratorSSHKey

Spécifie le fichier de clé publique pour une clé SSH Linux.

Type:	SSHKey
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-LinuxAdministratorSSHKeyString

Spécifie une clé SSH d’administrateur Linux sous forme de chaîne.

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

-LinuxDomainName

Spécifie un nom de domaine complet (FQDN) à utiliser conjointement avec la spécialisation du système d’exploitation Linux.

Exemple de format : -LinuxDomainName "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

-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
Alias:	AdminPasswordCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-MergeAnswerFile

Indique si cette applet de commande fusionne le fichier de réponses avec les paramètres du système d’exploitation invité. La valeur par défaut est $True. La console VMM utilise ce paramètre. Ne spécifiez pas ce paramètre.

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

-Name

Spécifie le nom d’un objet VMM.

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

-OperatingSystem

Spécifie le type de système d’exploitation d’une machine virtuelle.

Pour obtenir les noms de tous les systèmes d’exploitation disponibles dans VMM, tapez Get-SCOperatingSystem.

Type:	OperatingSystem
Position:	Named
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
Alias:	OrgName
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

-RemoveDomainJoinOrganizationalUnit

Indique que cette applet de commande supprime l’unité organisationnelle jointe à l’ordinateur lors de l’installation.

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

-RemoveServerFeatures

Indique que cette applet de commande supprime tous les rôles et fonctionnalités serveur d’un modèle.

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

-Shielded

Indique si l’objet est 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

-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

-UnattendSettings

Spécifie une paire clé/valeur composée de String , String.

Type:	System.Collections.Generic.Dictionary`2[System.String,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

-UserRole

Spécifie un objet de rôle d’utilisateur.

Type:	UserRole
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Workgroup

Spécifie sur un modèle nouveau ou existant, sur un profil de système d’exploitation invité ou sur une nouvelle machine virtuelle le nom du groupe de travail auquel vous souhaitez joindre une machine virtuelle. Vous pouvez utiliser ce paramètre pour remplacer la valeur existante sur un modèle ou sur un profil de système d’exploitation invité.

Type:	String
Alias:	JoinWorkgroup
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

GuestOSProfile

Cette applet de commande retourne un objet GuestOSProfile.

Notes

• Nécessite un objet de profil de système d’exploitation invité VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCGuestOSProfile .

Liens associés

• Get-SCGuestOSProfile
• New-SCGuestOSProfile
• Remove-SCGuestOSProfile