New-SCGuestOSProfile

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

-AutoLogonCount

-AutoLogonCredential

-ComputerName

-DeploymentTypeNano

-Description

-DisableAutoLogon

-Domain

-DomainJoinCredential

-DomainJoinOrganizationalUnit

-FullName

-GuestOSProfile

-GuiRunOnceCommands

-JobVariable

-LinuxAdministratorSSHKey

-LinuxAdministratorSSHKeyString

-LinuxDomainName

-LocalAdministratorCredential

-MergeAnswerFile

-Name

-OperatingSystem

-OrganizationName

-Owner

-ProductKey

-PROTipID

-RemoveDomainJoinOrganizationalUnit

-RemoveServerFeatures

-RunAsynchronously

-Shielded

-TimeZone

-UnattendSettings

-UserRole

-VMMServer

-Workgroup

Sorties

GuestOSProfile

Cette applet de commande retourne un objet GuestOSProfile .

Liens associés

• Get-SCGuestOSProfile
• Get-SCOperatingSystem
• Get-SCRunAsAccount
• Remove-SCGuestOSProfile
• Set-SCGuestOSProfile