Add-MgmtSvcResourceProviderConfiguration

Add-MgmtSvcResourceProviderConfiguration

Adds a resource provider to Windows Azure Pack.

Syntax

Parameter Set: Default
Add-MgmtSvcResourceProviderConfiguration [-ResourceProvider] <ResourceProvider> [-As <String> ] [-ConnectionString <String> ] [-EncryptionAlgorithm <String> ] [-EncryptionKey <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]


 

Detailed Description

The Add-MgmtSvcResourceProviderConfiguration cmdlet adds a resource provider to Windows Azure Pack for Windows Server. You can run this cmdlet from any computer in the deployment. If you run this cmdlet on the computer on which the Admin API service is installed and the Web.config file contains values for ConnectionString, EncryptionKey, and EncryptionAlgorithm, then those values are used.

Parameters

-As<String>

Specifies an output format.

 

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

 

-ConnectionString<String>

Specifies an SQL connection string.

 

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

 

-EncryptionAlgorithm<String>

Specifies an encryption algorithm.

 

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

 

-EncryptionKey<String>

Specifies an encryption key, as a hexadecimal string.

 

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

 

-Force

Updates an existing resource provider when one is found with the same name and instance ID of the one provied with this cmdlet. If there is no existing resource provider with the provided name and instance ID, then the resource provider is added, and this parameter is ignored.

 

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

 

-ResourceProvider<ResourceProvider>

Specifies a resource provider.

 

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

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 resource provider

The first five commands set variables to use when creating a new resource provider.

The sixth command creates a resource provider and stores the resulting resource provider object in the $RP variable. For information about creating a resource provider, see the New-MgmtSvcResourceProviderConfiguration cmdlet.

The last command adds the resource provider stored in $RP.

PS C:\> $ConnectionString = ""
 PS C:\> $EncryptionKey ="D576FCB3740049D44183C8BD6AB7979FB68DF253A1AFAB1BEDD987907358397D"
 PS C:\> $EncryptionAlgorithm = "AES"
 PS C:\> $UserName = "PattiFuller"
 PS C:\> $Password = "passw0rd"
 PS C:\> $RP = New-MgmtSvcResourceProviderConfiguration -Name 'RP01' `
 -DisplayName 'Resource Provider 01' `
 -AdminForwardingAddress "https://$Env:ComputerName`:30010/" `
 -AdminAuthenticationMode 'Basic' `
 -AdminAuthenticationUserName $UserName `
 -AdminAuthenticationPassword $Password `
 -TenantForwardingAddress "https://$Env:ComputerName`:30010/subscriptions" `
 -TenantAuthenticationMode 'Basic' `
 -TenantAuthenticationUserName $UserName `
 -TenantAuthenticationPassword $Password `
 -TenantSourceUriTemplate '{subid}/services/sqlservers/{*path}' `
 -TenantTargetUriTemplate '{subid}/{*path}' `
 -UsageForwardingAddress "https://$Env:ComputerName`:30010/" `
 -UsageAuthenticationMode 'Basic' `
 -UsageAuthenticationUserName $UserName `
 -UsageAuthenticationPassword $Password `
 -NotificationForwardingAddress "https://$Env:ComputerName`:30010/" `
 -NotificationAuthenticationMode 'Basic' `
 -NotificationAuthenticationUserName $UserName `
 -NotificationAuthenticationPassword $Password
 PS C:\> Add-MgmtSvcResourceProviderConfiguration -ResourceProvider $RP

 

Related topics

New-MgmtSvcResourceProviderConfiguration

Get-MgmtSvcResourceProviderConfiguration

Remove-MgmtSvcResourceProviderConfiguration