View Role Scopes

 

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

Management role scopes determine what objects are made available to a user so that the objects can be changed using the cmdlets and parameters assigned to them. You can view scopes to determine what scopes have been added to your organization, the configuration of a specific scope, or what scopes are orphans.

For more information about management role scopes in Microsoft Exchange Server 2010, see Understanding Management Role Scopes.

You must use the Shell to view scopes; you can't use the EMC to view role scopes.

Looking for other management tasks related to role scopes? Check out Managing Advanced Permissions.

Prerequisites

This topic makes use of pipelining and the Format-List cmdlet. For more information about these concepts, see the following topics:

View a specific scope

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Management scopes" entry in the Role Management Permissions topic.

You can view the details of a scope by piping the output of the Get-ManagementScope cmdlet to the Format-List cmdlet.

To view the details of a specific scope, use the following syntax.

Get-ManagementScope <scope name> | Format-List

This example retrieves the details of the Seattle Servers scope.

Get-ManagementScope "Seattle Servers" | Format-List

For detailed syntax and parameter information, see Get-ManagementScope.

List all scopes

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Management scopes" entry in the Role Management Permissions topic.

This example retrieves a list of scopes in your organization.

Get-ManagementScope

This cmdlet retrieves both exclusive and regular scopes. If you only want to return exclusive scopes or regular scopes, see "List all exclusive or regular scopes only" later in this topic.

For detailed syntax and parameter information, see Get-ManagementScope.

List all orphaned scopes

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Management scopes" entry in the Role Management Permissions topic.

Orphaned scopes are scopes that haven't been associated with any management role assignments.

This examples retrieves a list of orphaned scopes.

Get-ManagementScope -Orphan

For detailed syntax and parameter information, see Get-ManagementScope.

List all exclusive or regular scopes only

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Management scopes" entry in the Role Management Permissions topic.

By default, the Get-ManagementScope cmdlet returns a list of scopes that contains both exclusive and regular scopes. If you want to return only exclusive scopes or only regular scopes use the following syntax.

Get-ManagementScope -Exclusive < $true | $false >

This example returns only exclusive scopes.

Get-ManagementScope -Exclusive $true

This example returns a list of regular scopes only.

Get-ManagementScope -Exclusive $false

For detailed syntax and parameter information, see Get-ManagementScope.

 © 2010 Microsoft Corporation. All rights reserved.