Add-MgmtSvcSqlHostingServer
Add-MgmtSvcSqlHostingServer
Adds a SQL Server hosting server to Windows Azure Pack.
Syntax
Parameter Set: ByProperties
Add-MgmtSvcSqlHostingServer [-AdminUri] <Uri> [-Token] <String> [-Name] <String> [-TotalSpaceMB] <Int32> [-SqlUser] <System.Management.Automation.PSCredential> [-ServerGroupId] <String> [-DisableCertificateValidation] [-MaximumResourcePools <System.Int32> ] [-NumberOfCpuCores <System.Int32> ] [-SupportedIopsPerVolume <System.Int32> ] [-TotalMemoryGB <System.Int32> ] [ <CommonParameters>]
Parameter Set: ByObject
Add-MgmtSvcSqlHostingServer [-AdminUri] <Uri> [-Token] <String> [[-HostingServer] <SqlHostingServer> ] [-ServerGroupId] <String> [-DisableCertificateValidation] [ <CommonParameters>]
Detailed Description
The Add-MgmtSvcSqlHostingServer adds a SQL Server hosting server to Windows Azure Pack for Windows Server.
Parameters
-AdminUri<Uri>
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.
Aliases |
none |
Required? |
true |
Position? |
1 |
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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-HostingServer<SqlHostingServer>
Specifies a SQL Server hosting server object.
Aliases |
none |
Required? |
false |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-MaximumResourcePools<System.Int32>
Specifies the number of resource pools for the server.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies the name of a SQL Server.
If you want your application databases to be publically accessible, ensure that you use a publically-accessible IP address or FQDN.
Aliases |
none |
Required? |
true |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-NumberOfCpuCores<System.Int32>
Specifies the number of CPU cores for the server.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-ServerGroupId<String>
Specifies the ID for a SQL Server group.
Aliases |
none |
Required? |
true |
Position? |
6 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SqlUser<System.Management.Automation.PSCredential>
Specifies a user account and password as a PSCredential object. To create a PSCredential object, use the Get-Credential cmdlet.
Aliases |
none |
Required? |
true |
Position? |
5 |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-SupportedIopsPerVolume<System.Int32>
Specifies the supported I/O operations per second (IOPS) for the server.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Token<String>
Specifies an identity token. To create a token, use the Get-MgmtSvcToken cmdlet.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-TotalMemoryGB<System.Int32>
Specifies the total amount of memory, in gigabytes, for the server.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-TotalSpaceMB<Int32>
Specifies the size, in megabytes (MB) of the hosting server.
Aliases |
none |
Required? |
true |
Position? |
4 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
SqlHostingServer
You can pipe a SqlHostingServer object to this cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
SqlHostingServer
This cmdlet emits a SqlHostingServer object.
Examples
Example 1: Add a SQL hosting server
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 which are stored in the $Creds variable.
The second command uses the credentials provided in the first command to add the SQL Server named SQLServer01.Contoso.com to the SQL Server group with the ID of g5sho0.
PS C:\> $Creds = Get-Credential
PS C:\> Add-MgmtSvcSqlHostingServer -AdminUri "https://Computer01:30004" -Token $Token -Name "SQLServer01.Contoso.com" -TotalSpaceMB 2048 -ServerGroupId "g5sho0" -User $Creds