New-DPMRole

Creates a DPM role.

Syntax

New-DPMRole [[-DPMServerName] <String>] [-Name] <String> [[-Description] <String>] [<CommonParameters>]

Description

The New-DPMRole cmdlet creates a System Center 2016 - Data Protection Manager (DPM) role.
DPM roles let Microsoft SQL Server database owners to recover databases without assistance from a DPM administrator.

After you create a DPM role, use the Add-DPMSecurityGroup cmdlet to add the role to appropriate security groups.
Use the Add-DPMRecoveryItem cmdlet to specify instances of SQL Server and SQL Server databases that DPM protects.
Use the Add-DPMRecoveryTarget cmdlet to specify target computers that SQL Server.
After you make any changes to a DPM role, use the Set-DPMRole cmdlet to save those changes.

Examples

Example 1: Create a role

PS C:\>New-DPMRole -DPMServerName "DPMServer07" -Name "OpsMgrSQL" -Description "Operations Manager SQL"
This command creates a DPM role named OpsMgrSQL on the server named DPMServer07. The command includes a description for the role.

Parameters

-Description

Specifies a description for the DPM role.

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

-DPMServerName

Specifies the name of a DPM server on which this cmdlet creates a role.

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

-Name

Specifies a name for the DPM role.

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