Set-SCGuestOSProfile

Module:

VirtualMachineManager

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

Syntax

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

L’applet de commande Set-SCGuestOSProfile modifie une ou plusieurs propriétés d’un profil de système d’exploitation invité utilisé dans un environnement Virtual Machine Manager (VMM). Les modifications apportées à un profil de système d’exploitation invité affectent uniquement le profil de système d’exploitation invité 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 de 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 de système d’exploitation invité stocké dans $OSProfile.

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

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 de système d’exploitation invité stocké dans $OSProfile.

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
Aliases:	SysPrepFile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 administrateur automatique est activée.

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

-ComputerName

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

• FQDN
• Adresse IPv4 ou IPv6
• Nom NetBIOS

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

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

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

-Description

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

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

-DisableAutoLogon

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

Type:	SwitchParameter
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
Aliases:	JoinDomain
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 à droits limités joignant 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
Aliases:	JoinDomainCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainJoinOrganizationalUnit

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

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

-GuestOSProfile

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

Type:	GuestOSProfile
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-GuiRunOnceCommands

Spécifie un tableau de commandes à ajouter à la section [GuiRunOnce] d’un fichier de réponses 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

-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

-LinuxAdministratorSSHKey

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

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

-LinuxAdministratorSSHKeyString

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

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

-OperatingSystem

Spécifie le type de système d’exploitation d’un ordinateur virtuel.

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

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

-OrganizationName

Spécifie le nom de l’organisation pour la personne dont le nom d’une machine virtuelle est inscrit.

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

-RemoveDomainJoinOrganizationalUnit

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

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

-Shielded

Indique si l’objet est protégé.

Type:	Boolean
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, consultez 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

-UnattendSettings

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

Type:	System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserRole

Spécifie un objet rôle d'utilisateur.

Type:	UserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 dans un modèle ou dans un profil de système d’exploitation invité.

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