Share via

New-DPMRole

  • Reference
Module:
DataProtectionManager

Creates a DPM role.

Syntax

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

Description

The New-DPMRole cmdlet creates a System Center - 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
Position:3
Default value:None
Required:False
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
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies a name for the DPM role.

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