Import-HpcNodeTemplate

Import-HpcNodeTemplate

Imports one or more node template XML files, and then creates new node templates or overwrites existing node templates based on the information in the node template XML files.

Syntax

Parameter Set: Default
Import-HpcNodeTemplate [-Path] <String[]> [-Force] [-Scheduler <String> ] [-Upgrade] [ <CommonParameters>]

Detailed Description

Imports one or more node template XML files, and then creates new node templates or overwrites existing node templates based on the information in the node template XML files. The names of the node template XML files without the file extensions serve as the names of the node templates.

Parameters

-Force

Replaces the existing node template that has a name that is the same as the name of the node template XML file without the file name extension, without prompting the user.

Aliases

none

Required?

false

Position?

named

Default Value

not applicable

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Path<String[]>

Specifies a list of the names of one or more XML files from which to import the node templates, including the relative or full paths if the files are not in the current directory. The file names and paths must be valid.

Aliases

none

Required?

true

Position?

1

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Scheduler<String>

Specifies the host name or IP address of the head node for the cluster to which you want to import the node templates. The value must be a valid computer name or IP address. If you do not specify the Scheduler parameter, this cmdlet uses the scheduler on the head node that the CCP_SCHEDULER environment variable specifies. To set this environment variable, run the following cmdlet:

Set-Content Env:CCP_SCHEDULER <head_node_name>

Aliases

none

Required?

false

Position?

named

Default Value

%CCP_SCHEDULER%

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Upgrade

Upgrades node templates that were created with the Create Node Template Wizard with a previous version of HPC Pack and then exported. The cmdlet imports the upgraded template to an HPC cluster.

This parameter was introduced in HPC Pack 2008 R2. It is not supported in previous versions.

When you specify the Upgrade parameter, the cmdlet fixes the task that installs HPC Pack so that the correct version of the .NET Framework is also installed.

This cmdlet cannot upgrade a customized node template that was not created with the Create Node Template Wizard.

Aliases

none

Required?

false

Position?

named

Default Value

not applicable

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

Outputs

The output type is the type of the objects that the cmdlet emits.

  • None

Notes

  • You must be a cluster administrator to run this cmdlet successfully.

Examples

EXAMPLE 1

Imports the node template XML file located at C:\MyNodeTemplate\Template1.xml, and creates a node template named Template1 if a node template with that name does not exist already.

PS C:\>Import-HpcNodeTemplate -Path C:\MyNodeTemplate\Template1.xml

EXAMPLE 2

Imports the node template XML files located at C:\MyNodeTemplate\Template2.xml and C:\MyNodeTemplate\Template3.xml, and creates node templates named Template2 and Template3. If node templates with either of these names already exists, the Import-HpcNodeTemplate cmdlet overwrites the existing templates that have these names.

PS C:\>Import-HpcNodeTemplate -Force -Path C:\MyNodeTemplate\Template2.xml,C:\MyNodeTemplate\Template3.xml

EXAMPLE 3

Imports the node template XML file located at C:\TemplatesForUpgrade\Template4.xml and creates a node template named Template4. If the file at C:\TemplatesForUpgrade\Template4.xml was created by using the Create Node Template Wizard in HPC Pack 2008 and then exported, this example also upgrades the node template for use in HPC Pack 2008 R2 before importing it to an HPC cluster.

PS C:\>Import-HpcNodeTemplate -Path C:\TemplatesForUpgrade\Template4.xml -Upgrade

Export-HpcNodeTemplate

New-HpcNodeTemplate

Remove-HpcNodeTemplate