Get-DPMRole

Gets a DPM role to view or edit.

Syntax

Get-DPMRole [[-DPMServerName] <String>] [[-Name] <String>] [-Editable] [<CommonParameters>]

Description

The Get-DPMRole cmdlet gets a System Center 2016 - Data Protection Manager (DPM) role for you to view or edit. You can use this cmdlet to display the properties of a DPM role, or all the DPM roles for a DPM server. DPM roles let Microsoft SQL Server database owners to recover databases without assistance from a DPM administrator.

To open a role for editing, use the Editable parameter. After you make changes to a DPM role, use the Set-DPMRole cmdlet to save those changes.

Examples

Example 1: Get a role

PS C:\>Get-DpmRole -Name "OpsMgrSQL"

This command gets a DPM role named OpsMgrSQL. If you intend to make changes to the role, specify the Editable parameter.

Parameters

-DPMServerName

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

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

Indicates that you can edit the DPM role.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specify the name of a protection group.

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