< Back
New-AcmTest
Post
NAME New-AcmTest
SYNOPSIS
Add an Azure cluster of VMs/VM scale sets to ACM and perform MPI Pingpong test on it.
SYNTAX
New-AcmTest [-ResourceGroup] <String> [-AcmResourceGroup] <String> [-SubscriptionId] <String> [[-SetupTimeout]
<Int32>] [[-TestTimeout] <Int32>] [-NoSetup] [[-LinuxExtensionUrl] <String>] [[-WindowsExtensionUrl] <String>]
[<CommonParameters>]
DESCRIPTION
PARAMETERS
-ResourceGroup <String>
The name of an Azure resource group containing the VMs/VM scale sets to test.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AcmResourceGroup <String>
The name of an Azure resource group containing the ACM service.
Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SubscriptionId <String>
The ID of an Azure subscription containing both the ResourceGroup and AcmResourceGroup.
Required? true
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SetupTimeout <Int32>
The timeout value for adding cluster to Acm. By default, an estimated value will be set based on the number of
VMs/VM scale sets in a cluster. A value shorter than necesssary will fail the setup procedure. You could
specify a larger value to ensure the success of setup.
Required? false
Position? 4
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-TestTimeout <Int32>
The timeout value for performing test on cluster. By default, an estimated value will be set based on the
number of nodes in a cluster. A value shorter than necesssary will cause no test result, since the test can't
complete without enough time. You could specify a larger value to ensure the test to complete.
Required? false
Position? 5
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-NoSetup [<SwitchParameter>]
Do not add cluster to ACM but only do test on it. This is for repeated test on a cluster that already has been
added to ACM.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-LinuxExtensionUrl <String>
URL for the Linux VM Extension. The file name in the URL must match pattern "^.+\\-\\d+\\.\\d+\\.\\d+\\.\\d+\\.zip$".
This option is internal for development.
Required? false
Position? 6
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WindowsExtensionUrl <String>
URL for the Windows VM Extension. The file name in the URL must match pattern "^.+\\-\\d+\\.\\d+\\.\\d+\\.\\d+\\.zip$".
This option is internal for development.
Required? false
Position? 7
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
The command will log a lot to screen. So it's better to redirect them to files. Do it like
New-AcmTest ... 2>err_log 6>info_log
It writes errors to file err_log and other information to file info_log.
-------------------------- EXAMPLE 1 --------------------------
New-AcmTest -SubscriptionId a486e243-747b-42de-8c4c-379f8295a746 -ResourceGroup 'my-cluster-1' -AcmResourceGroup
'my-acm-cluster' 2>err_log 6>info_log
Perform test on a cluster of VMs/VM scale sets that has not been added to ACM before. It also writes logs to files.
-------------------------- EXAMPLE 2 --------------------------
New-AcmTest -SubscriptionId a486e243-747b-42de-8c4c-379f8295a746 -ResourceGroup 'my-cluster-1' -AcmResourceGroup
'my-acm-cluster' -NoSetup 2>err_log 6>info_log
Perform test on a cluster of VMs/VM scale sets that has been added to ACM already.
RELATED LINKS
SYNOPSIS
Add an Azure cluster of VMs/VM scale sets to ACM and perform MPI Pingpong test on it.
SYNTAX
New-AcmTest [-ResourceGroup] <String> [-AcmResourceGroup] <String> [-SubscriptionId] <String> [[-SetupTimeout]
<Int32>] [[-TestTimeout] <Int32>] [-NoSetup] [[-LinuxExtensionUrl] <String>] [[-WindowsExtensionUrl] <String>]
[<CommonParameters>]
DESCRIPTION
PARAMETERS
-ResourceGroup <String>
The name of an Azure resource group containing the VMs/VM scale sets to test.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-AcmResourceGroup <String>
The name of an Azure resource group containing the ACM service.
Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SubscriptionId <String>
The ID of an Azure subscription containing both the ResourceGroup and AcmResourceGroup.
Required? true
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SetupTimeout <Int32>
The timeout value for adding cluster to Acm. By default, an estimated value will be set based on the number of
VMs/VM scale sets in a cluster. A value shorter than necesssary will fail the setup procedure. You could
specify a larger value to ensure the success of setup.
Required? false
Position? 4
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-TestTimeout <Int32>
The timeout value for performing test on cluster. By default, an estimated value will be set based on the
number of nodes in a cluster. A value shorter than necesssary will cause no test result, since the test can't
complete without enough time. You could specify a larger value to ensure the test to complete.
Required? false
Position? 5
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-NoSetup [<SwitchParameter>]
Do not add cluster to ACM but only do test on it. This is for repeated test on a cluster that already has been
added to ACM.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-LinuxExtensionUrl <String>
URL for the Linux VM Extension. The file name in the URL must match pattern "^.+\\-\\d+\\.\\d+\\.\\d+\\.\\d+\\.zip$".
This option is internal for development.
Required? false
Position? 6
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WindowsExtensionUrl <String>
URL for the Windows VM Extension. The file name in the URL must match pattern "^.+\\-\\d+\\.\\d+\\.\\d+\\.\\d+\\.zip$".
This option is internal for development.
Required? false
Position? 7
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
The command will log a lot to screen. So it's better to redirect them to files. Do it like
New-AcmTest ... 2>err_log 6>info_log
It writes errors to file err_log and other information to file info_log.
-------------------------- EXAMPLE 1 --------------------------
New-AcmTest -SubscriptionId a486e243-747b-42de-8c4c-379f8295a746 -ResourceGroup 'my-cluster-1' -AcmResourceGroup
'my-acm-cluster' 2>err_log 6>info_log
Perform test on a cluster of VMs/VM scale sets that has not been added to ACM before. It also writes logs to files.
-------------------------- EXAMPLE 2 --------------------------
New-AcmTest -SubscriptionId a486e243-747b-42de-8c4c-379f8295a746 -ResourceGroup 'my-cluster-1' -AcmResourceGroup
'my-acm-cluster' -NoSetup 2>err_log 6>info_log
Perform test on a cluster of VMs/VM scale sets that has been added to ACM already.
RELATED LINKS