Import-HpcNodeTemplate
Imports one or more node template XML files, and creates new node templates or overwrites existing node templates based on the information in the node template XML files.
Syntax
Import-HpcNodeTemplate [-Force] [-Scheduler <string>] [-Path] <string[]> [<CommonParameters>]
Detailed Description
Imports one or more node template XML files, and 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.
|
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.
|
Required? |
true |
|
Position? |
1 |
|
Default Value |
no default |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
true |
-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>
|
Required? |
false |
|
Position? |
named |
|
Default Value |
%CCP_SCHEDULER% |
|
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.
Input and Return Types
The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.
|
Input Type |
None. |
|
Return Type |
None. |
Example 1
C:\PS>Import-HpcNodeTemplate -Path C:\MyNodeTemplate\Template1.xml
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.
Example 2
C:\PS>Import-HpcNodeTemplate -Force -Path C:\MyNodeTemplate\Template2.xml,C:\MyNodeTemplate\Template3.xml
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 a node template with either of those names already exists, the Import-HpcNodeTemplate cmdlet overwrites them.