New-MgmtSvcResourceProviderConfiguration
Creates a resource provider.
Syntax
New-MgmtSvcResourceProviderConfiguration
[[-Name] <String>]
[[-InstanceId] <String>]
[-DisplayName <String>]
[-InstanceDisplayName <String>]
[-Type <ResourceProviderType>]
[-AllowAnonymousAccess]
[-AllowMultipleInstances]
[-AdminForwardingAddress <String>]
[-AdminAuthenticationMode <AuthenticationMode>]
[-AdminAuthenticationUserName <String>]
[-AdminAuthenticationPassword <String>]
[-TenantForwardingAddress <String>]
[-TenantAuthenticationMode <AuthenticationMode>]
[-TenantAuthenticationUserName <String>]
[-TenantAuthenticationPassword <String>]
[-TenantSourceUriTemplate <String>]
[-TenantTargetUriTemplate <String>]
[-UsageForwardingAddress <String>]
[-UsageAuthenticationMode <AuthenticationMode>]
[-UsageAuthenticationUserName <String>]
[-UsageAuthenticationPassword <String>]
[-NotificationForwardingAddress <String>]
[-NotificationAuthenticationMode <AuthenticationMode>]
[-NotificationAuthenticationUserName <String>]
[-NotificationAuthenticationPassword <String>]
[-Input <String>]
[-From <String>]
[-ResourceProvider <ResourceProvider>]
[-As <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:\> $RPThe 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 |
| Accepted values: | None, Basic, Windows |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdminAuthenticationPassword
Specifies an administrator password to connect to a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdminAuthenticationUserName
Specifies an administrator user name to connect to a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdminForwardingAddress
Specifies an administrator forwarding address for a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowAnonymousAccess
Indicates that anonymous access is allowed to a resource provider.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowMultipleInstances
Indicates that the cmdlet allows multiple instances of a resource provider.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-As
Specifies an output format.
| Type: | String |
| Accepted values: | Xml, XDocument, XmlString |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Specifies the display name of a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-From
Specifies the sender address.
| Type: | String |
| Accepted values: | Registry |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Input
Specifies input to a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceDisplayName
Specifies a display name for an instance of a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InstanceId
Specifies an ID for an instance of a resource provider.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifies the name of a resource provider.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| 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 |
| Accepted values: | None, Basic, Windows |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NotificationAuthenticationPassword
Specifies a notification password to connect to a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NotificationAuthenticationUserName
Specifies a notification user name to connect to a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NotificationForwardingAddress
Specifies the notification forwarding address of a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceProvider
Specifies a resource provider.
| Type: | ResourceProvider |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| 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 |
| Accepted values: | None, Basic, Windows |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantAuthenticationPassword
Specifies the tenant password to connect to a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantAuthenticationUserName
Specifies the tenant user name to connect to a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantForwardingAddress
Specifies the tenant forwarding address of a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantSourceUriTemplate
Specifies the tenant source URI template of a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantTargetUriTemplate
Specifies the tenant target URI template of a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Type
Specifies the type of the resource provider.
| Type: | ResourceProviderType |
| Accepted values: | Standard, UsageProvider, CloudServiceProvider |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Accepted values: | None, Basic, Windows |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsageAuthenticationPassword
Specifies the usage password to connect to a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsageAuthenticationUserName
Specifies the usage user name to connect to a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsageForwardingAddress
Specifies the notification forwarding address of a resource provider.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |