Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Export-HpcNodeXml

Exports information about the specified compute nodes to an XML file.

Syntax

Export-HpcNodeXML [-Force] [-Scheduler <string>] -Path <string> [-Name] <string[]> [<CommonParameters>]

Export-HpcNodeXML [-Force] [-Scheduler <string>] -Node <HPCNode[]> -Path <string> [<CommonParameters>]

Detailed Description

Exports information about the specified compute nodes to an XML file. You can specify the compute nodes by name or by using HpcNode objects that you retrieve with the Get-HpcNode cmdlet.

Parameters

-Force

Replaces the node XML file if it already exists, without prompting.

 

Required?

false

Position?

named

Default Value

not applicable

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name <string[]>

Specifies a list of the names of one or more compute nodes that you want to export. You cannot specify both the Name and Node parameters.

 

Required?

true

Position?

1

Default Value

no default

Accept Pipeline Input?

false

Accept Wildcard Characters?

true

-Node <HPCNode[]>

Specifies a list of one or more HpcNode objects for the compute nodes that you want to export. Use the Get-HpcNode cmdlet to get the HpcNode objects for the nodes. You cannot specify both the Node and Name parameters.

 

Required?

true

Position?

named

Default Value

no default

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Path <string>

Specifies a name for the XML file to which you want to export the nodes, including the full or relative path to the file if the Export-HpcNodeXML cmdlet should not save the file in the current directory.

This cmdlet creates any directories that do not already exist in that path. If the file already exists and you do not specify the Force parameter, the cmdlet prompts you to confirm whether or not you want to replace the file.

 

Required?

true

Position?

named

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 that includes the compute nodes. 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

One or more HpcNode objects.

Return Type

None.

Notes

You cannot export a head node. You can import the node XML file later to add compute nodes to a cluster by using the Import-HpcNodeXML cmdlet. For example, if you export the information about the nodes to a node XML file with the Export-HpcNodeXML cmdlet, then remove those nodes from the cluster with the Remove-HpcNode cmdlet to upgrade them or perform maintenance on them, you can add the nodes back to the cluster by importing the node xml file.

Example 1

C:\PS>Export-HpcNodeXML -Name ComputeNode1 -Path C:\MyNodeXMLFiles\ComputeNode1.xml

Exports information about the compute node named ComputeNode1 to the XML file located at C:\MyNodeXMLFiles\ComputeNode1.xml.

Example 2

C:\PS>Get-HpcNode -Group NodeGroupA | Export-HpcNodeXML -Path C:\MyNodeXMLFiles\NodeGroupA.xml -Force

Gets the HpcNode objects for the nodes in the NodeGroupA node group, then exports information about those nodes to the XML file located at C:\MyNodeXMLFiles\NodeGroupA.xml. If this XML file already exists, the Export-HpcNodeXML cmdlet overwrites it without prompting.

See Also

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.