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.


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

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.

Dd297977.note(en-us,EXCHG.140).gifNote:
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.

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.

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
Show: