New-MgmtSvcResourceProviderConfiguration

Creates a resource provider.

Syntax

Parameter Set: Default
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>]

Detailed Description

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

Parameters

-AdminAuthenticationMode<AuthenticationMode>

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

-- None

-- Basic

-- Windows

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

-AdminAuthenticationPassword<String>

Specifies an administrator password to connect to a resource provider.

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

-AdminAuthenticationUserName<String>

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

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

-AdminForwardingAddress<String>

Specifies an administrator forwarding address for a resource provider.

Aliases	none
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.

Aliases	none
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.

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

-As<String>

Specifies an output format.

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

-DisplayName<String>

Specifies the display name of a resource provider.

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

-From<String>

Specifies the sender address.

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

-Input<String>

Specifies input to a resource provider.

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

-InstanceDisplayName<String>

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

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

-InstanceId<String>

Specifies an ID for an instance of a resource provider.

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

-Name<String>

Specifies the name of a resource provider

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

-NotificationAuthenticationMode<AuthenticationMode>

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

-- None

-- Basic

-- Windows

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

-NotificationAuthenticationPassword<String>

Specifies a notification password to connect to a resource provider.

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

-NotificationAuthenticationUserName<String>

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

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

-NotificationForwardingAddress<String>

Specifies the notification forwarding address of a resource provider.

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?	false
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByValue)
Accept Wildcard Characters?	false

-TenantAuthenticationMode<AuthenticationMode>

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

-- None

-- Basic

-- Windows

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

-TenantAuthenticationPassword<String>

Specifies the tenant password to connect to a resource provider.

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

-TenantAuthenticationUserName<String>

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

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

-TenantForwardingAddress<String>

Specifies the tenant forwarding address of a resource provider.

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

-TenantSourceUriTemplate<String>

Specifies the tenant source URI template of a resource provider.

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

-TenantTargetUriTemplate<String>

Specifies the tenant target URI template of a resource provider.

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

-Type<ResourceProviderType>

Specifies the type of the resource provider.

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

-UsageAuthenticationMode<AuthenticationMode>

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

-- None

-- Basic

-- Windows

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

-UsageAuthenticationPassword<String>

Specifies the usage password to connect to a resource provider.

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

-UsageAuthenticationUserName<String>

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

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

-UsageForwardingAddress<String>

Specifies the notification forwarding address of a resource provider.

Aliases	none
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: Create a resource provider

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.

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

New-MgmtSvcResourceProviderConfiguration