Add-MgmtSvcAddOn

Adds a service add-on to Windows Azure Pack.

Syntax

Parameter Set: ByProperties
Add-MgmtSvcAddOn [-AdminUri] <Uri> [-Token] <String> [-DisplayName] <String> [[-State] {Private | Public | Decommissioned} ] [[-MaxOccurrencesPerPlan] <Int32> ] [-DisableCertificateValidation] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByObject
Add-MgmtSvcAddOn [-AdminUri] <Uri> [-Token] <String> [[-AddOn] <PlanAddOn> ] [-DisableCertificateValidation] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Add-MgmtSvcAddOn cmdlet adds a service add-on to Windows Azure Pack for Windows Server. To configure an add-on, use the Set-MgmtSvcAddOn cmdlet.

Parameters

-AddOn<PlanAddOn>

Specifies an add-on object.

Aliases	none
Required?	false
Position?	3
Default Value	none
Accept Pipeline Input?	True (ByValue)
Accept Wildcard Characters?	false

-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 specifiy 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

-DisplayName<String>

Specifies a display name for an add-on.

Aliases	none
Required?	true
Position?	3
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-MaxOccurrencesPerPlan<Int32>

Specifies the maximum number of occurrences an add-on can exist for a plan.

Aliases	none
Required?	false
Position?	5
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-State<PlanState>

Specifies the state of an add-on. Valid values are:

-- Private

-- Public

-- Decommissioned

The acceptable values for this parameter are:

Private
Public
Decommissioned

Aliases	none
Required?	false
Position?	4
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

-Confirm

Prompts you for confirmation before executing the command.

Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Examples

Example 1: Add a plan add-on

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 adds a public ad-on named Add-On 01.

PS C:\> Add-MgmtSvcAddOn -AdminUri "https://Computer01:30004" -Token $Token -DisplayName "Add-On 01" -State "Public" -MaxOccurrencesPerPlan 2

Add-MgmtSvcAddOn