Set-SCGuestOSProfile
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
Prudence
Cet article fait référence à CentOS, une distribution Linux qui a atteint l’état de fin de vie (EOL). Tenez compte de votre utilisation et de votre planification en conséquence. Pour plus d’informations, consultez les conseils sur la fin de vie 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 $SshkeyLa 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
.