Share via

New-DPMRole

Module:
DataProtectionManager Module

Creates a DPM role.

Syntax

Default (Default) 

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:3
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DPMServerName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies a name for the DPM role.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.