Partager via

Get-SCVMTemplate

  • Référence
Module:
VirtualMachineManager

Obtient des objets de modèle de machine virtuelle à partir de la bibliothèque VMM.

Syntaxe

Get-SCVMTemplate
   [-VMMServer <ServerConnection>]
   [-ComputerTierTemplate <ComputerTierTemplate>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVMTemplate
   [-VMMServer <ServerConnection>]
   [-ComputerTierTemplate <ComputerTierTemplate>]
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVMTemplate
   [-VMMServer <ServerConnection>]
   [-ComputerTierTemplate <ComputerTierTemplate>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande get-SCVMTemplate obtient des objets de modèle de machine virtuelle à partir de la bibliothèque Virtual Machine Manager (VMM).

Pour plus d’informations sur la façon dont les modèles de machine virtuelle sont utilisés pour créer de nouvelles machines virtuelles, tapez Get-Help New-Template -Detailed.

Exemples

Exemple 1 : Obtenir tous les modèles stockés dans la bibliothèque

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com"

Cette commande obtient tous les objets de modèle de la bibliothèque VMM sur VMMServer01, puis affiche des informations sur ces modèles.

Exemple 2 : Obtenir tous les modèles stockés dans la bibliothèque qui ont un nom similaire

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -like "Windows Server 2008*" }

Cette commande obtient tous les objets de modèle de la bibliothèque VMM sur VMMServer01 dont le nom commence par « Windows Server 2008 », puis affiche des informations sur ces modèles.

Paramètres

-All

Indique que cette applet de commande obtient tous les objets subordonnés indépendamment de l’objet parent. Par exemple, la commande Get-SCVirtualDiskDrive -All obtient tous les objets de lecteur de disque virtuel, quel que soit l’objet de machine virtuelle ou l’objet de modèle auquel chaque objet de lecteur de disque virtuel est associé.

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

-ComputerTierTemplate

Spécifie un objet de modèle de niveau ordinateur.

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

-ID

Spécifie l’identificateur numérique en tant qu’identificateur global unique, ou GUID, pour un objet spécifique.

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

-Name

Spécifie le nom d’un objet VMM.

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

-OnBehalfOfUser

Spécifie un nom d’utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet Get-SCUserRole. Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

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

-VMMServer

Spécifie un objet serveur VMM.

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

Sorties

Template

Cette applet de commande retourne un objet Template.