Start-HpcAzureNode
Starts Azure nodes.
Syntax
Start-HpcAzureNode
[-Async <Boolean>]
[-Name] <String[]>
[-Scheduler <String[]>]
[<CommonParameters>]
Start-HpcAzureNode
[-Async <Boolean>]
-Node <HpcNode[]>
[-Scheduler <String[]>]
[<CommonParameters>]
Description
The Start-HpcAzureNode cmdlet starts one or more Azure nodes. Starting the nodes provisions the corresponding role instances in Azure.
Examples
Example 1: Start an Azure node by name
PS C:\>Start-HpcAzureNode -Name "AzureCN-0114" -Async $True
This command starts the Azure node named AzureCN-0114 and returns without waiting for the node to start.
Example 2: Get Azure nodes by state and start them
PS C:\>Get-HpcNode -GroupName "AzureNodes" -State Not-Deployed | Start-HpcAzureNode
This command gets an HpcNode object for the Azure nodes that are in the Not-Deployed state, and then starts those Azure nodes.
Parameters
-Async
Indicates whether the cmdlet should return immediately without waiting for the nodes to start.
A nonzero or $True value specifies that the cmdlet should return immediately without waiting for the nodes to start. A 0 or $False value specifies that the cmdlet should wait for the nodes to start before returning.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specifies an array of names, separated by commas, of the nodes that you want to start. You cannot specify both the Name and Node parameters.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Node
Specifies an array of HpcNode objects, separated by commas, for the nodes that you want to start. You cannot specify both the Node and Name parameters.
Type: | HpcNode[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Scheduler
Specifies the host name or IP address of the head node for the cluster that includes the Azure nodes that you want to start. 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\>
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
HpcNode[]
Outputs
None
Notes
- Azure nodes that are stopped automatically by an availability policy that is configured in the node template cannot be started by this cmdlet.
- If a problem exists with your Internet connection, the process of starting the nodes can fail.
- You must be a cluster administrator to run this cmdlet successfully.
- This cmdlet was introduced in HPC Pack 2012 R2 Update 1. It is not supported in previous versions.
Related Links
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for