Get-SupervisionListEntry

[This is pre-release documentation and subject to change in future releases. This topic's current status is: Writing.]

Applies to: Exchange Server 2010 Beta* *Topic Last Modified: 2008-12-11

Use the Get-SupervisionListEntry cmdlet to retrieve the entries with a specific tag from the supervision list of a mailbox.

Syntax

Get-SupervisionListEntry -Identity <RecipientIdParameter> [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Tag <String>]

Parameters

Parameter	Required	Type	Description
Identity	Required	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter	The Identity parameter specifies the mailbox whose supervision list will be queried. You can use one of the following values: GUID Distinguished name (DN) Domain\Account User principal name (UPN) LegacyExchangeDN SmtpAddress Alias
Credential	Optional	System.Management.Automation.PSCredential	The Credential parameter is used to specify the logon credentials used to access the supervision list entry.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory.
ReadFromDomainController	Optional	System.Management.Automation.SwitchParameter	The ReadFromDomainController parameter specifies that the user information is read from a domain controller in the user's domain. If you set the recipient scope to include all recipients in the forest and don't use this parameter, it's possible that the user information is read from a global catalog with outdated information. If you use this parameter, multiple reads might be necessary to get the information. Note: By default, the recipient scope is set to the domain that hosts your servers that run Exchange.
ResultSize	Optional	Microsoft.Exchange.Data.Unlimited	The ResultSize parameter specifies the maximum number of results to return.
Tag	Optional	System.String	The Tag parameter specifies the name of the tag for the supervision list entries. The command will return only those entries from the mailbox's supervision list whose tag matches the value of this parameter.

Detailed Description

To run this cmdlet, you must be assigned, either directly or using a universal security group, one of the following management roles:

• Organization Management 
• Organization Management - Tenant 

While all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they are not included in the management roles assigned to you. For more information, see Permissions Information for Cmdlet Help and Procedural Topics.

Examples

EXAMPLE 1

The following example returns the list of e-mail senders in the supervision list of the mailbox Dan Park that are tagged "Reject".

Get-SupervisionListEntry "Dan Park" -Tag "Reject"

EXAMPLE 2

The following example returns all the supervision list entries for the mailbox Dan Park and displays the result in a tabular format, showing the e-mail addresses of the supervision list entries and the associated tags.

Get-SupervisionListEntry "Dan Park" | Format-Table EntryName,Tag