Partager via

New-SCExternalJob

  • Référence
Module:
VirtualMachineManager

Crée un travail externe dans VMM.

Syntaxe

New-SCExternalJob
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-ResultObject <ClientObject>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande New-SCExternalJob crée des travaux externes dans Virtual Machine Manager (VMM).

Les travaux externes ajoutent des travaux non-VMM à la vue travaux dans la console VMM. Ces travaux sont généralement utilisés pour permettre à d’autres applications qui s’intègrent à VMM de traiter les mises à jour d’état dans la console afin que les utilisateurs de la console puissent voir les mises à jour. Par exemple, si vous créez un complément, vous pouvez utiliser des travaux externes pour fournir l’état du travail effectué sur un autre système.

Exemples

Exemple 1 : Créer un travail externe

PS C:\> $VMMObject = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCExternalJob -Name "ExternalJob01" -ResultObject $VMMObject

La première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VMMObject. L’objet de cette commande peut être n’importe quel objet VMM pour lequel vous créez un travail.

La deuxième commande crée un travail externe nommé ExternalJob01 et associe le travail à VM01 qui est stocké dans la variable $VMMObject.

Paramètres

-Name

Spécifie le nom d’un objet VMM.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
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

-ResultObject

Spécifie l’objet auquel un nouveau travail externe est associé.

Type:ClientObject
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

Task

Cette applet de commande retourne un objet Task.