Partager via


New-SCGuestOSProfile

Crée un profil de système d’exploitation invité à utiliser dans VMM.

Syntax

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

Description

L’applet de commande New-SCGuestOSProfile crée un profil de système d’exploitation invité à utiliser dans Virtual Machine Manager (VMM). Un système d’exploitation invité est le système d’exploitation sur une machine virtuelle, contrairement à un système d’exploitation hôte qui se trouve sur l’ordinateur hôte physique sur lequel une ou plusieurs machines virtuelles sont déployées.

Un profil de système d’exploitation invité stocke les informations de configuration du système d’exploitation. Un profil se compose d’un ensemble de propriétés contenant les paramètres les plus courants spécifiés dans un fichier de réponses sans assistance (tel qu’un fichier Sysprep.inf ou un fichier Unattend.xml).

Vous pouvez créer un profil de système d’exploitation invité autonome ou personnaliser un modèle ou une machine virtuelle pour inclure les paramètres de profil du système d’exploitation invité. L’applet de commande New-SCGuestOSProfile stocke le nouvel objet de profil de système d’exploitation invité dans la bibliothèque VMM.

Vous pouvez créer un profil de système d’exploitation invité en fonction des paramètres par défaut, en fonction d’un profil de système d’exploitation invité existant, ou vous pouvez personnaliser les paramètres lors de la création du profil. Si vous ne spécifiez aucun paramètre à l’exception du paramètre Name, l’applet de commande New-SCGuestOSProfile crée un objet de profil de système d’exploitation invité par défaut.

Exemples

Exemple 1 : Créer un profil de système d’exploitation invité par défaut

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"}
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile01" -OperatingSystem $OS

La première commande obtient l’objet du système d’exploitation nommé « édition 64 bits de Windows Server 2008 R2 Entreprise » à partir de VMMServer01 et stocke l’objet dans la variable $OS.

La deuxième commande crée un profil de système d’exploitation invité par défaut nommé NewProfile01 et spécifie le nom du système d’exploitation.

Exemple 2 : Créer un profil de système d’exploitation invité à utiliser pour joindre une machine virtuelle à un domaine

PS C:\> $DomainCredential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile02" -JoinDomain "Contoso.com" -DomainJoinCredential $DomainCredential -OperatingSystem $OS

La première commande obtient l’objet de compte d’identification nommé RunAsAccount01 et stocke l’objet dans la variable $DomainCredential.

La deuxième commande obtient l’objet du système d’exploitation nommé édition 64 bits de Windows Server 2008 R2 Entreprise à partir de VMMServer01 et stocke l’objet dans la variable $OS.

La dernière commande crée un profil de système d’exploitation invité appelé NewOSProfile02 et spécifie le nom du système d’exploitation. Lorsque vous utilisez NewOSProfile02 pour créer une machine virtuelle, le profil utilise le compte d’identification spécifié pour joindre la machine virtuelle au domaine Contoso.com.

Remarque : si vous fournissez un objet PSCredential au lieu d’un compte d’identification pour le paramètre DomainJoinCredential , il est recommandé d’utiliser uniquement un compte avec des droits limités pour joindre automatiquement une machine virtuelle à un domaine, car le nom et le mot de passe du compte de domaine apparaissent brièvement en texte brut sur le serveur hôte.

Exemple 3 : Cloner un profil de système d’exploitation invité existant

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile02"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Datacenter"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile03" -GuestOSProfile $OSProfile -ComputerName "Contoso03" -OperatingSystem $OS

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

La deuxième commande obtient l’objet du système d’exploitation nommé édition 64 bits de Windows Server 2008 R2 Datacenter et stocke l’objet dans la variable $OS.

La dernière commande crée un profil de système d’exploitation invité nommé NewOSProfile03, qui est basé sur NewOSProfile02, mais modifie le nom de l’ordinateur et spécifie un autre nom pour le système d’exploitation. Tous les autres paramètres de NewOSProfile03 sont identiques à ceux de NewOSProfile02.

Exemple 4 : Créer un profil de système d’exploitation invité Linux et définir le nom de domaine DNS Linux

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "CentOS Linux 6 (64 bit)"} 
PS C:\> New-SCGuestOSProfile -Name "My CentOS Profile" -LinuxDomainName "contoso.com" -OperatingSystem $os

La première commande obtient l’objet du système d’exploitation nommé CentOS Linux 6 (64 bits) à partir de VMMServer01 et stocke l’objet dans la variable $OS.

La deuxième commande crée un profil de système d’exploitation invité nommé My CentOS Profile et spécifie le nom du système d’exploitation et le nom de domaine DNS Linux. Lorsque vous utilisez le profil My CentOS pour créer une machine virtuelle, le profil utilise le nom de domaine DNS Linux spécifié.

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

Indique que cette applet de commande 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:Named
Default value:None
Required:False
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:0
Default value:None
Required:True
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

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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 .