New-MgmtSvcResourceProviderConfiguration

Creates a resource provider.

Syntax

New-MgmtSvcResourceProviderConfiguration [[-InstanceId] <String>] [[-Name] <String>]
 [-AdminAuthenticationMode <AuthenticationMode>] [-AdminAuthenticationPassword <String>]
 [-AdminAuthenticationUserName <String>] [-AdminForwardingAddress <String>] [-AllowAnonymousAccess]
 [-AllowMultipleInstances] [-As <String>] [-DisplayName <String>] [-From <String>] [-Input <String>]
 [-InstanceDisplayName <String>] [-NotificationAuthenticationMode <AuthenticationMode>]
 [-NotificationAuthenticationPassword <String>] [-NotificationAuthenticationUserName <String>]
 [-NotificationForwardingAddress <String>] [-ResourceProvider <ResourceProvider>]
 [-TenantAuthenticationMode <AuthenticationMode>] [-TenantAuthenticationPassword <String>]
 [-TenantAuthenticationUserName <String>] [-TenantForwardingAddress <String>]
 [-TenantSourceUriTemplate <String>] [-TenantTargetUriTemplate <String>] [-Type <ResourceProviderType>]
 [-UsageAuthenticationMode <AuthenticationMode>] [-UsageAuthenticationPassword <String>]
 [-UsageAuthenticationUserName <String>] [-UsageForwardingAddress <String>] [<CommonParameters>]

Description

The New-MgmtSvcResourceProviderConfiguration cmdlet creates a resource provider in memory.
To add the resource provider, use the Add-MgmtSvcResourceProviderConfiguration cmdlet.

Examples

Example 1: Create a resource provider

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:\> $RP
The first command stores a connection string in the $ConnectionString variable. The second command stores an encryption key in the $EncryptionKey variable. The third command specifies the encryption algorithm AES and stores the value in the $EncryptionAlgorighm variable. The fourth command stores a user name in the $UserName variable. The fifth command stores a password in the $Password variable. The sixth command uses the provided information to create a resource provider for SQL servers, and stores the resource provider object in the $RP variable. The last command displays information about the new resource provider to the user. You can also use this variable to pass the resource provider object to other cmdlets, such as **Add-MgmtSvcResourceProviderConfiguration**.

Parameters

-AdminAuthenticationMode

Specifies the administrative authentication mode of a resource provider.
Valid values for this parameter are:

- None
- Basic
- Windows

Type:AuthenticationMode
Parameter Sets:None, Basic, Windows
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AdminAuthenticationPassword

Specifies an administrator password to connect to a resource provider.

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

-AdminAuthenticationUserName

Specifies an administrator user name to connect to a resource provider.

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

-AdminForwardingAddress

Specifies an administrator forwarding address for a resource provider.

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

-AllowAnonymousAccess

Indicates that anonymous access is allowed to a resource provider.

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

-AllowMultipleInstances

Indicates that the cmdlet allows multiple instances of a resource provider.

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

-As

Specifies an output format.

Type:String
Parameter Sets:Xml, XDocument, XmlString
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Specifies the display name of a resource provider.

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

-From

Specifies the sender address.

Type:String
Parameter Sets:Registry
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Input

Specifies input to a resource provider.

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

-InstanceDisplayName

Specifies a display name for an instance of a resource provider.

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

-InstanceId

Specifies an ID for an instance of a resource provider.

Type:String
Required:False
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of a resource provider.

Type:String
Required:False
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NotificationAuthenticationMode

Specifies the notification authentication mode for a resource provider.
Valid values for this parameter are:

- None
- Basic
- Windows

Type:AuthenticationMode
Parameter Sets:None, Basic, Windows
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NotificationAuthenticationPassword

Specifies a notification password to connect to a resource provider.

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

-NotificationAuthenticationUserName

Specifies a notification user name to connect to a resource provider.

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

-NotificationForwardingAddress

Specifies the notification forwarding address of a resource provider.

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

-ResourceProvider

Specifies a resource provider.

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

-TenantAuthenticationMode

Specifies the tenant authentication mode of a resource provider.
Valid values for this parameter are:

- None
- Basic
- Windows

Type:AuthenticationMode
Parameter Sets:None, Basic, Windows
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TenantAuthenticationPassword

Specifies the tenant password to connect to a resource provider.

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

-TenantAuthenticationUserName

Specifies the tenant user name to connect to a resource provider.

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

-TenantForwardingAddress

Specifies the tenant forwarding address of a resource provider.

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

-TenantSourceUriTemplate

Specifies the tenant source URI template of a resource provider.

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

-TenantTargetUriTemplate

Specifies the tenant target URI template of a resource provider.

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

-Type

Specifies the type of the resource provider.

Type:ResourceProviderType
Parameter Sets:Standard, UsageProvider, CloudServiceProvider
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UsageAuthenticationMode

Specifies the usage authentication mode of a resource provider.
Valid values for this parameter are:

- None
- Basic
- Windows

Type:AuthenticationMode
Parameter Sets:None, Basic, Windows
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UsageAuthenticationPassword

Specifies the usage password to connect to a resource provider.

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

-UsageAuthenticationUserName

Specifies the usage user name to connect to a resource provider.

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

-UsageForwardingAddress

Specifies the notification forwarding address of a resource provider.

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