Test-MgmtSvcSqlHostingServer

Verifies a SQL Server hosting server can be created.

Syntax

Test-MgmtSvcSqlHostingServer [-AdminUri] <Uri> [-Token] <String> [[-HostingServer] <SqlHostingServer>]
 [-ServerGroupId] <String> [-DisableCertificateValidation] [<CommonParameters>]
Test-MgmtSvcSqlHostingServer [-AdminUri] <Uri> [-Token] <String> [-Name] <String> [-TotalSpaceMB] <Int32>
 [-SqlUser] <PSCredential> [-ServerGroupId] <String> [-DisableCertificateValidation]
 [-MaximumResourcePools <Int32>] [-NumberOfCpuCores <Int32>] [-SupportedIopsPerVolume <Int32>]
 [-TotalMemoryGB <Int32>] [<CommonParameters>]

Description

The Test-MgmtSvcSqlHostingServer cmdlet verifies that a SQL Server hosting server can be created, and that the specified login credentials are correct.
This cmdlet verifies that no server with the same name is already registered.

Examples

Example 1: Verify a SQL Server hosting server

PS C:\> $Creds = Get-Credential
PS C:\> Test-MgmtSvcSqlHostingServer -AdminUri "https://Computer01:30004" -Token $Token -Name "SQLServer01.Contoso.com" -TotalSpaceMB 2048 -User $Creds -ServerGroupId "g5sho0"
NOTE: This example assumes that you have created a token by using **Get-MgmtSvcToken** and have stored it in a variable named $Token. The first command prompts the user for credentials and stores the provided user name and password in the $Credential variable. The second command tests the SQL Server hosting server named SQLServer01.Contoso.com, using the credentials provided in the first command.

Parameters

-AdminUri

Specifies the URI of the Windows Azure Pack administrator API.
Use the following format: https://<computer>:<port>, where <computer> is the computer on which the administrator API is installed.

Type:Uri
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-DisableCertificateValidation

Disables certificate validation for the Windows Azure Pack installation.
If you specify this parameter, you can use self-signed certificates.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-HostingServer

Specifies a SQL Server hosting server object.

Type:SqlHostingServer
Required:False
Position:2
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

-MaximumResourcePools

Specifies the number of resource pools for the server.

Type:Int32
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-Name

Specifies the name of a SQL Server.

Type:String
Required:True
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-NumberOfCpuCores

Specifies the number of CPU cores for the server.

Type:Int32
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-ServerGroupId

Specifies the ID for a SQL Server group.

Type:String
Required:True
Position:5
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-SqlUser

Specifies a user account and password as a PSCredential object.
To create a PSCredential object, use the Get-Credential cmdlet.

Type:PSCredential
Required:True
Position:4
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-SupportedIopsPerVolume

Specifies the supported I/O operations per second (IOPS) for the server.

Type:Int32
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-Token

Specifies an identity token.
To create a token, use the Get-MgmtSvcToken cmdlet.

Type:String
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-TotalMemoryGB

Specifies the total amount of memory, in gigabytes, for the server.

Type:Int32
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

-TotalSpaceMB

Specifies the size, in megabytes (MB) of the hosting server.

Type:Int32
Required:True
Position:3
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Inputs

SqlHostingServer

You can pipe a **SqlHostingServer** object to this cmdlet.

Outputs

SqlHostingServer

This cmdlet emits a **SqlHostingServer** object.