Partager via

New-SCExternalJob

  • Référence
Module:
VirtualMachineManager

Crée un travail externe dans VMM.

Syntax

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 à l’affichage travaux dans la console VMM. Ces travaux sont généralement utilisés pour permettre à d’autres applications d’intégrer VMM à des 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 terminé 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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResultObject

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

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

Sorties

Task

Cette applet de commande retourne un objet Task .