Import-HpcMetric

Import-HpcMetric

Imports metrics from the specified XML file to create new metrics or overwrite existing metrics that HPC Cluster Manager uses in the heat maps for the nodes and the monitoring charts.

Syntax

Parameter Set: Default
Import-HpcMetric [-Path] <String> [-ClusterConnectionString <String[]> ] [-Reset] [-Scheduler <String[]> ] [ <CommonParameters>]




Detailed Description

The Import-HpcMetric cmdlet imports metrics from the specified XML file to create new metrics or overwrite existing metrics that HPC Cluster Manager uses in the heat maps for the nodes and the monitoring charts.

Parameters

-ClusterConnectionString<String[]>

Specifies an array of cluster connection strings for the cluster to which you want to add the device drivers. The value format is host1,host2,host3. If you do not specify the ClusterConnectionString parameter, this cmdlet uses the connection string on the head node that the CCP_CONNECTIONSTRING environment variable specifies. To set this environment variable, run the following cmdlet: Set-Content Env: CCP_CONNECTIONSTRING <head_node_name>.

This parameter was introduced in HPC Pack 2016.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Path<String>

Specifies the file name of the XML file that contains the information about the metrics that you want to import, including the full or relative path to the file if the file is not in the current directory.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Reset

Indicates the Import-HpcMetric cmdlet replaces the entire set of existing metrics with the metrics in the XML file from which you want to import metrics. After you import metrics by using the Reset parameter, the HPC cluster will have exactly the same set of metrics that the XML file defines. If you do not use the Reset parameter, the Import-HpcMetric cmdlet adds the new metrics in the XML file to the metrics that already exist for the HPC cluster, and updates the definition of any existing metrics that the XML file also contains.


Aliases

none

Required?

false

Position?

named

Default Value

none

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 metrics. 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

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. 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

  • For information about the schema for the metrics XML file, see Windows HPC Server 2008: Operations (http://go.microsoft.com/fwlink/?LinkId=120726) in the TechNet Library.

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

Examples

Example 1: Import metrics

This command imports metrics from the XML file located at C:\MyMetrics\MyCustomMetrics.xml and adds those metrics to the existing set of metrics for the HPC cluster. If the MyCustomMetrics.xml file contains any metrics that already exist, the Import-HpcMetric cmdlet updates those metrics based on the setting in the XML file.


PS C:\> Import-HpcMetric -Path "C:\MyMetrics\MyCustomMetrics.xml"

Example 2: Import metrics to replace all current metrics

Imports metrics from the XML file located at C:\MyMetrics\MyCustomMetricsSet.xml and replaces the entire existing set of metrics for the HPC cluster with the new set of metrics that the XML file contains.


PS C:\> Import-HpcMetric -Path "C:\MyMetrics\MyCustomMetricsSet.xml" -Reset

Related topics

Community Additions

ADD
Show: