Remove-MgmtSvcSqlHostingServer

Removes a hosting server from Windows Azure Pack.

Syntax

Remove-MgmtSvcSqlHostingServer [-AdminUri] <Uri> [-Token] <String> [-HostingServerId] <String> [-Confirm]
 [-DisableCertificateValidation] [-WhatIf] [<CommonParameters>]

Description

The Remove-MgmtSvcSqlHostingServer cmdlet removes a SQL Server hosting server from Windows Azure Pack for Windows Server.

Examples

Example 1: Remove a SQL hosting server

PS C:\> Remove-MgmtSvcSqlHostingServer -AdminUri "https://Computer01:30004" -Token $Token -HostingServerId "u37k25"
NOTE: This example assumes that you have created a token by using **Get-MgmtSvcToken** and have stored it in a variable named $Token. This command removes the SQL Server hosting server with the ID of u37k25.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:None
Accept pipeline input:False
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

-HostingServerId

Specifies the ID of a SQL Server hosting server.

Type:String
Required:True
Position:2
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

-WhatIf

Shows what would happen if the cmdlet runs.
The cmdlet is not run.

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

Inputs

HostingServerId

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

Outputs

Boolean

This cmdlet emits a **Boolean** object that indicates success or failure.