Partager via


New-SCService

Déploie une nouvelle instance de service dans VMM.

Syntaxe

New-SCService
   [-PersistServiceConfiguration]
   [-Owner <String>]
   [-VMMServer <ServerConnection>]
   -ServiceConfiguration <ServiceConfiguration>
   [-UserRole <UserRole>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande New-SCService déploie une nouvelle instance de service dans l’environnement Virtual Machine Manager (VMM). Vous pouvez créer un service directement à partir d’un modèle de service si aucune configuration d’instance de service n’est nécessaire ou à partir d’une configuration de service.

Exemples

Exemple 1 : Déployer un modèle de service à l’aide d’une configuration de service stockée dans la bibliothèque

PS C:\> $SvcConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> Update-SCServiceConfiguration -ServiceConfiguration $SvcConfig
PS C:\> $NewService = New-SCService -ServiceConfiguration $SvcConfig 
PS C:\> $NewService

La première commande obtient l’objet de configuration de service nommé Contoso Service Configuration 01 et stocke l’objet dans la variable $SvcConfig.

La deuxième commande exécute le placement pour mettre à jour la configuration du service stockée dans $SvcConfig.

La troisième commande déploie le nouveau service à l’aide de la configuration du service stockée dans $SvcConfig.

La dernière commande affiche les propriétés du service nouvellement déployé sur l’utilisateur.

Paramètres

-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

-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

-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

-PersistServiceConfiguration

Indique que la configuration du déploiement de service est stockée dans la bibliothèque VMM une fois le service déployé.

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

-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

-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

-ServiceConfiguration

Spécifie un objet de configuration de service.

Type:ServiceConfiguration
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

-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

Service

Cette applet de commande retourne un objet Service.