jobtemplate grant

 

Applies To: Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2

Sets permissions that are granted to a specified user for a specified job template.

For examples of how to use this command, see Examples.

Syntax

jobtemplate grant <job_template_name> <domain>\<user_name>
/perm:{F|M|S} [/replace[:{true|false}]] [/scheduler:<name>]

jobtemplate grant {/? | /help}

Parameters

Parameter

Description

<job_template_name>

Specifies the name of the job template for which you want to set permissions.

<domain>\<user_name>

Specifies the domain and user name for the account for which you want to grant permissions for the job template. The account can be for an individual or a group.

/perm:{F|M|S}

Specifies the level of permission to grant. Specify F to grant full control, M to grant permission to modify the job template, or S to grant permission to submit jobs to which the job template is assigned.

/replace[:{true|false}]

Specifies whether to replace the existing permissions that the specified user has for the job template with the permissions that the /perm parameter specifies.

A value of True indicates that the existing permissions that the specified user has for the job template should be replaced.

A value of False indicates that the existing permissions should be combined with permission that the /perm parameter specifies.

When you specify the /replace parameter without a value, the jobtemplate grant command behaves as if you specified a value of True. If you do not specify the /replace parameter, the jobtemplate grant command behaves as if you specified a value of False.

/scheduler:<name>

Specifies the host name or IP address of the head node for the cluster that contains the job template. The value must be a valid computer name or IP address. If you do not specify the /scheduler parameter, this command uses the scheduler on the head node that the CCP_SCHEDULER environment variable specifies.

/?

Displays Help at the command prompt.

/help

Displays Help at the command prompt.

Remarks

Only users who have Modify permissions on the job template can set permissions on the template.

Examples

To grant job submission permissions to the user with a user name of someone in the CONTOSO domain for the job template named MyJobTemplate, use the following command:

jobtemplate grant MyJobTemplate CONTOSO\someone /perm:S

To grant permission to submit jobs to the users in the Engineering group in the CONTOSO domain for the job template named JobTemplate8, use the following command:

jobtemplate grant JobTemplate8 CONTOSO\Engineering /perm:S

To grant full control to the user with a user name of user6 in the CONTOSO domain for the job template named JobTemplate5, and then replace the existing permissions for that user for that job template, use the following command:

jobtemplate grant JobTemplate5 CONTOSO\user6 /perm:F /replace:true

Additional references