Docstoc

Office365_PowerShell_Cmdlets_Beta

Document Sample
Office365_PowerShell_Cmdlets_Beta Powered By Docstoc
					Add-DistributionGroupMember
Add-MailboxFolderPermission
Add-MailboxPermission
Add-ManagementRoleEntry
Add-RecipientPermission
Add-RoleGroupMember
Add-SupervisionListEntry
Clear-ActiveSyncDevice
Clear-Host
Clear-TextMessagingAccount
Compare-TextMessagingVerificationCode
Complete-Migration
Disable-InboxRule
Disable-JournalRule
Disable-Mailbox
Disable-OutlookProtectionRule
Disable-PSRemoting
Disable-TransportRule
Disable-UMAutoAttendant
Disable-UMIPGateway
Disable-UMMailbox
Enable-InboxRule
Enable-JournalRule
Enable-Mailbox
Enable-OutlookProtectionRule
Enable-TransportRule
Enable-UMAutoAttendant
Enable-UMIPGateway
Enable-UMMailbox
Export-MigrationReport
Export-UMCallDataRecord
Export-UMPrompt
Get-AcceptedDomain
Get-ActiveSyncDevice
Get-ActiveSyncDeviceAccessRule
Get-ActiveSyncDeviceClass
Get-ActiveSyncDeviceStatistics
Get-ActiveSyncMailboxPolicy
Get-ActiveSyncOrganizationSettings
Get-AdminAuditLogConfig
Get-CalendarNotification
Get-CalendarProcessing
Get-CASMailbox
Get-CASMailboxPlan
Get-Contact
Get-DistributionGroup
Get-DistributionGroupMember
Get-DynamicDistributionGroup
Get-FailedContentIndexDocuments
Get-FederatedDomainProof
Get-FederatedOrganizationIdentifier
Get-FederationInformation
Get-FederationTrust
Get-Group
Get-HotmailSubscription
Get-ImapSubscription
Get-InboxRule
Get-IRMConfiguration
Get-JournalRule
Get-LinkedUser
Get-LogonStatistics
Get-Mailbox
Get-MailboxAuditBypassAssociation
Get-MailboxAutoReplyConfiguration
Get-MailboxCalendarConfiguration
Get-MailboxCalendarFolder
Get-MailboxFolder
Get-MailboxFolderPermission
Get-MailboxFolderStatistics
Get-MailboxJunkEmailConfiguration
Get-MailboxMessageConfiguration
Get-MailboxPermission
Get-MailboxPlan
Get-MailboxRegionalConfiguration
Get-MailboxSpellingConfiguration
Get-MailboxStatistics
Get-MailContact
Get-MailUser
Get-ManagementRole
Get-ManagementRoleAssignment
Get-ManagementRoleEntry
Get-ManagementScope
Get-MessageCategory
Get-MessageClassification
Get-MessageTrackingReport
Get-MigrationBatch
Get-MigrationStatus
Get-MoveRequest
Get-MoveRequestStatistics
Get-OrganizationalUnit
Get-OrganizationRelationship
Get-OutlookProtectionRule
Get-OwaMailboxPolicy
Get-PerimeterConfig
Get-PopSubscription
Get-ProvisioningRequest
Get-Recipient
Get-RecipientPermission
Get-RecipientStatisticsReport
Get-RemoteDomain
Get-RemovedMailbox
Get-RetentionPolicy
Get-RetentionPolicyTag
Get-RMSTemplate
Get-RMSTrustedPublishingDomain
Get-RoleAssignmentPolicy
Get-RoleGroup
Get-RoleGroupMember
Get-SecurityPrincipal
Get-SendAddress
Get-ServiceStatus
Get-SharingPolicy
Get-Subscription
Get-SupervisionListEntry
Get-SupervisionPolicy
Get-SyncConfig
Get-TextMessagingAccount
Get-ThrottlingPolicy
Get-ThrottlingPolicyAssociation
Get-ToolInformation
Get-TransportConfig
Get-TransportRule
Get-TransportRuleAction
Get-TransportRulePredicate
Get-UMAutoAttendant
Get-UMCallDataRecord
Get-UMCallSummaryReport
Get-UMDialPlan
Get-UMHuntGroup
Get-UMIPGateway
Get-UMMailbox
Get-UMMailboxPIN
Get-UMMailboxPlan
Get-UMMailboxPolicy
Get-User
Import-ContactList
Import-RMSTrustedPublishingDomain
Import-UMPrompt
New-ActiveSyncDeviceAccessRule
New-ActiveSyncMailboxPolicy
New-AdminAuditLogSearch
New-DistributionGroup
New-DynamicDistributionGroup
New-HotmailSubscription
New-ImapSubscription
New-InboxRule
New-JournalRule
New-Mailbox
New-MailboxAuditLogSearch
New-MailboxFolder
New-MailContact
New-MailMessage
New-MailUser
New-ManagementRole
New-ManagementRoleAssignment
New-ManagementScope
New-MessageClassification
New-MigrationBatch
New-MoveRequest
New-OrganizationRelationship
New-OutlookProtectionRule
New-OwaMailboxPolicy
New-PopSubscription
New-ProvisioningRequest
New-RemoteDomain
New-RetentionPolicy
New-RetentionPolicyTag
New-RoleAssignmentPolicy
New-RoleGroup
New-SharingPolicy
New-Subscription
New-TransportRule
New-UMAutoAttendant
New-UMDialPlan
New-UMHuntGroup
New-UMIPGateway
New-UMMailboxPolicy
Remove-ActiveSyncDevice
Remove-ActiveSyncDeviceAccessRule
Remove-ActiveSyncMailboxPolicy
Remove-DistributionGroup
Remove-DistributionGroupMember
Remove-DynamicDistributionGroup
Remove-InboxRule
Remove-JournalRule
Remove-Mailbox
Remove-MailboxFolderPermission
Remove-MailboxPermission
Remove-MailContact
Remove-MailUser
Remove-ManagementRole
Remove-ManagementRoleAssignment
Remove-ManagementRoleEntry
Remove-ManagementScope
Remove-MessageClassification
Remove-MoveRequest
Remove-OrganizationRelationship
Remove-OutlookProtectionRule
Remove-OwaMailboxPolicy
Remove-ProvisioningRequest
Remove-RecipientPermission
Remove-RemoteDomain
Remove-RetentionPolicy
Remove-RetentionPolicyTag
Remove-RMSTrustedPublishingDomain
Remove-RoleAssignmentPolicy
Remove-RoleGroup
Remove-RoleGroupMember
Remove-SharingPolicy
Remove-Subscription
Remove-SupervisionListEntry
Remove-TransportRule
Remove-UMAutoAttendant
Remove-UMDialPlan
Remove-UMHuntGroup
Remove-UMIPGateway
Remove-UMMailboxPolicy
Resume-MoveRequest
Search-AdminAuditLog
Search-MailboxAuditLog
Search-MessageTrackingReport
Send-TextMessagingVerificationCode
Set-AcceptedDomain
Set-ActiveSyncDeviceAccessRule
Set-ActiveSyncMailboxPolicy
Set-ActiveSyncOrganizationSettings
Set-CalendarNotification
Set-CalendarProcessing
Set-CASMailbox
Set-Contact
Set-DistributionGroup
Set-DynamicDistributionGroup
Set-FederatedOrganizationIdentifier
Set-Group
Set-HotmailSubscription
Set-ImapSubscription
Set-InboxRule
Set-IRMConfiguration
Set-JournalRule
Set-LinkedUser
Set-Mailbox
Set-MailboxAuditBypassAssociation
Set-MailboxAutoReplyConfiguration
Set-MailboxCalendarConfiguration
Set-MailboxCalendarFolder
Set-MailboxFolderPermission
Set-MailboxJunkEmailConfiguration
Set-MailboxMessageConfiguration
Set-MailboxPlan
Set-MailboxRegionalConfiguration
Set-MailboxSpellingConfiguration
Set-MailContact
Set-MailUser
Set-ManagementRoleAssignment
Set-ManagementRoleEntry
Set-ManagementScope
Set-MessageClassification
Set-MoveRequest
Set-OrganizationConfig
Set-OrganizationRelationship
Set-OutlookProtectionRule
Set-OwaMailboxPolicy
Set-PerimeterConfig
Set-PopSubscription
Set-RemoteDomain
Set-RetentionPolicy
Set-RetentionPolicyTag
Set-RMSTemplate
Set-RMSTrustedPublishingDomain
Set-RoleAssignmentPolicy
Set-RoleGroup
Set-SharingPolicy
Set-SupervisionPolicy
Set-TextMessagingAccount
Set-TransportConfig
Set-TransportRule
Set-UMAutoAttendant
Set-UMDialPlan
Set-UMIPGateway
Set-UMMailbox
Set-UMMailboxPIN
Set-UMMailboxPolicy
Set-User
Start-ManagedFolderAssistant
Start-MigrationBatch
Start-ProvisioningRequest
Start-RetentionAutoTagLearning
Stop-MigrationBatch
Suspend-MoveRequest
Test-FederationTrustCertificate
Test-IRMConfiguration
Test-MAPIConnectivity
Test-MigrationServerAvailability
Test-OrganizationRelationship
Update-DistributionGroupMember
Update-RoleGroupMember
Write-AdminAuditLog
NAME
       Add-DistributionGroupMember

SYNOPSIS
    Use the Add-DistributionGroupMember cmdlet to add a recipient to a
distribution group.

SYNTAX
    Add-DistributionGroupMember -Identity <DistributionGroupIdParameter>
[-BypassSecurityGroupManagerCheck <SwitchParameter>] [-Confirm [<SwitchPa
    rameter>]] [-DomainController <Fqdn>] [-Member
<RecipientIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Dist
    ribution groups" entry in the Mailbox Permissions topic.


PARAMETERS
    -Identity <DistributionGroupIdParameter>
        The Identity parameter specifies the identity of the distribution
group. You can use one of the following values:
        * GUID
        * Distinguished name (DN)
        * User principal name (UPN)
        * LegacyExchangeDN
        * Domain\Account Name
        * Alias

          Required?                     true
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -BypassSecurityGroupManagerCheck <SwitchParameter>
        The BypassSecurityGroupManagerCheck parameter specifies whether
to bypass security checks and moderation for the member being added, if
th
        e specified distribution group is a moderated distribution group.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false
    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Member <RecipientIdParameter>
        The Member parameter specifies the recipient to add to the
distribution group. You can use one of the following values:
        * GUID
        * DN
        * UPN
        * LegacyExchangeDN
        * Domain\Account Name
        * SMTP address

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
          This cmdlet supports the common parameters: Verbose, Debug,
          ErrorAction, ErrorVariable, WarningAction, WarningVariable,
          OutBuffer and OutVariable. For more information, type,
          "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example adds John Evans to the distribution group Staff.

    Add-DistributionGroupMember      -Identity "Staff"   -Member
"JohnEvans@contoso.com"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b586ea3a-
8243-460a-a400-9ab5823ba782(EXCHG.141).aspx

NAME
       Add-MailboxFolderPermission

SYNOPSIS
    Use the Add-MailboxFolderPermission cmdlet to manage folder-level
permissions for all folders within a user's mailbox.

SYNTAX
    Add-MailboxFolderPermission -Identity <MailboxFolderIdParameter> -
AccessRights <MailboxFolderAccessRight[]> -User
<MailboxFolderUserIdParamete
    r> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mail
    box folder" entry in the Mailbox Permissions topic.


PARAMETERS
    -AccessRights <MailboxFolderAccessRight[]>
        The AccessRights parameter specifies the permissions for the user
with the following access rights:
        * ReadItems    The user has the right to read items within the
specified folder.
        * CreateItems    The user has the right to create items within the
specified folder.
        * EditOwnedItems    The user has the right to edit the items that
the user owns in the specified folder.
        * DeleteOwnedItems    The user has the right to delete items that
the user owns in the specified folder.
        * EditAllItems    The user has the right to edit all items in the
specified folder.
        * DeleteAllItems    The user has the right to delete all items in
the specified folder.
        * CreateSubfolders    The user has the right to create subfolders
in the specified folder.
        * FolderOwner    The user is the owner of the specified folder.
The user has the right to view and move the folder and create subfolders.
T
           he user can't read items, edit items, delete items, or create
items.
        * FolderContact    The user is the contact for the specified
public folder.
        * FolderVisible    The user can view the specified folder, but
can't read or edit items within the specified public folder.
        The AccessRights parameter also specifies the permissions for the
user with the following roles, which are a combination of the rights lis
        ted previously:
        * None    FolderVisible
        * Owner    CreateItems, ReadItems, CreateSubfolders, FolderOwner,
FolderContact, FolderVisible, EditOwnedItems, EditAllItems, DeleteOwnedIt
           ems, DeleteAllItems
        * PublishingEditor    CreateItems, ReadItems, CreateSubfolders,
FolderVisible, EditOwnedItems, EditAllItems, DeleteOwnedItems,
DeleteAllIte
           ms
         * Editor   CreateItems, ReadItems, FolderVisible, EditOwnedItems,
EditAllItems, DeleteOwnedItems, DeleteAllItems
         * PublishingAuthor    CreateItems, ReadItems, CreateSubfolders,
FolderVisible, EditOwnedItems, DeleteOwnedItems
         * Author   CreateItems, ReadItems, FolderVisible, EditOwnedItems,
DeleteOwnedItems
         * NonEditingAuthor    CreateItems, ReadItems, FolderVisible
         * Reviewer    ReadItems, FolderVisible
         * Contributor    CreateItems, FolderVisible
         The following roles apply specifically to calendar folders:
         * AvailabilityOnly    View only availability data
         * LimitedDetails    View availability data with subject and
location

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxFolderIdParameter>
        The Identity parameter specifies the recipient and folder that
you want to change the permissions for. This parameter takes the
following
        format: <SMTP Address or Alias of Recipient>:<Folder path>. The
following is an example: john@contoso.com:\Calendar

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -User <MailboxFolderUserIdParameter>
        The User parameter specifies who's granted permission to view or
modify the folder contents of the user specified in the Identity paramete
        r. The following values are acceptable:
        * Alias
        * SMTP address

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example assigns permissions for Ed to access Ayla's Marketing
mailbox folder and applies the Owner role to his access of that folder.
    Add-MailboxFolderPermission -Identity ayla@contoso.com:\Marketing -
User Ed@contoso.com -AccessRights Owner




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/73f4e8e8-
1673-4f58-8353-2f7a597a0a23(EXCHG.141).aspx

NAME
       Add-MailboxPermission

SYNOPSIS
    Use the Add-MailboxPermission cmdlet to add permissions to a mailbox.

SYNTAX
    Add-MailboxPermission -Identity <MailboxIdParameter> -AccessRights
<MailboxRights[]> -User <SecurityPrincipalIdParameter> [-Confirm
[<SwitchPa
    rameter>]] [-Deny <SwitchParameter>] [-DomainController <Fqdn>] [-
IgnoreDefaultScope <SwitchParameter>] [-InheritanceType <None | All |
Descen
    dents | SelfAndChildren | Children>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    Add-MailboxPermission -Identity <MailboxIdParameter> -Owner
<SecurityPrincipalIdParameter> [-Confirm [<SwitchParameter>]] [-
DomainController <
    Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]

    Add-MailboxPermission [-Identity <MailboxIdParameter>] -Instance
<MailboxAcePresentationObject> [-AccessRights <MailboxRights[]>] [-
Confirm [<
    SwitchParameter>]] [-Deny <SwitchParameter>] [-DomainController
<Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-InheritanceType <None |
All
    | Descendents | SelfAndChildren | Children>] [-User
<SecurityPrincipalIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Perm
    issions and delegation" entry in the Mailbox Permissions topic.
PARAMETERS
    -AccessRights <MailboxRights[]>
        The AccessRights parameter specifies the rights needed to perform
the operation. Valid values include:
        * FullAccess
        * SendAs
        * ExternalAccount
        * DeleteItem
        * ReadPermission
        * ChangePermission
        * ChangeOwner

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxIdParameter>
        The Identity parameter specifies the identity of the mailbox
that's getting permissions added. You can use the following values:
        * Alias
        * Display name
        * Domain\Account
        * SMTP address
        * Distinguished name (DN)
        * Object GUID
        * User principal name (UPN)
        * LegacyExchangeDN

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Instance <MailboxAcePresentationObject>
        The Instance parameter is no longer used and will be deprecated.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Owner <SecurityPrincipalIdParameter>
        The Owner parameter specifies the owner of the mailbox object.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -User <SecurityPrincipalIdParameter>
        The User parameter specifies the user mailbox that the
permissions are being granted to on the other mailbox.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch can be used to suppress the confirmation
prompt that appears by default when this cmdlet is run. To suppress the
confir
        mation prompt, use the syntax -Confirm:$False. You must include a
colon ( : ) in the syntax.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Deny <SwitchParameter>
        The Deny switch specifies whether to deny permissions to the user
on the mailbox.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -InheritanceType <None | All | Descendents | SelfAndChildren |
Children>
        The InheritanceType parameter specifies whether permissions are
inherited by folders within the mailbox.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example grants Kevin Kelly full access to Ellen Adam's mailbox.
    The Identity parameter requires the full name of the user to be
enclosed in quotation marks (").

    Add-MailboxPermission -Identity "Ellen Adams" -User KevinKelly -
AccessRights FullAccess -InheritanceType All




    -------------------------- EXAMPLE 2 --------------------------




    This example grants Ayla Kol read permission to Tony Smith's mailbox.

    Add-MailboxPermission -Identity "Tony Smith" -User "Ayla Kol" -
AccessRights ReadPermission




    -------------------------- EXAMPLE 3 --------------------------




    This example sets Tony Smith as the owner of the resource mailbox
Room 222.

    Add-MailboxPermission -Identity "Room 222" -Owner "Tony Smith"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/a9aacbf5-
5e6c-47ef-95d6-e24547e95d01(EXCHG.141).aspx

NAME
       Add-ManagementRoleEntry

SYNOPSIS
    Use the Add-ManagementRoleEntry cmdlet to add management role entries
to an existing management role.

SYNTAX
    Add-ManagementRoleEntry -Identity <RoleEntryIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-Force
<SwitchParameter>]
    [-Overwrite <SwitchParameter>] [-Parameters <String[]>] [-
PSSnapinName <String>] [-Type <Cmdlet | Script | ApplicationPermission |
All>] [-UnS
    copedTopLevel <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    Add-ManagementRoleEntry -ParentRoleEntry <RoleEntryIdParameter> -Role
<RoleIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqd
    n>] [-Force <SwitchParameter>] [-Overwrite <SwitchParameter>] [-
WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The cmdlet and its parameters that you add to a role entry must exist
in the parent role. You can't add role entries to built-in roles.
    You can only add a role entry to a management role if the role entry
exists in the role's parent role. For example, if you try to add the Sear
    ch-Mailbox role entry to a role that's a child of the Mail Recipients
role, you'll receive an error. This error occurs because the Search-Mail
    box role entry doesn't exist in the Mail Recipients role. To add the
Search-Mailbox role entry to a role, you need to create a new role that's
     a child of the Mailbox Import Export role, which does contain the
Search-Mailbox role entry. Then you can use the Add-ManagementRoleEntry
cmd
    let to add the Search-Mailbox role entry to the new child role.
    For more information about management role entries, see Understanding
Management Roles.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mana
    gement role entries" entry in the Role Management Permissions topic.


PARAMETERS
    -Identity <RoleEntryIdParameter>
        The Identity parameter specifies the role entry to add. You must
specify the value of the Identity parameter in the format: <management ro
        le>\<role entry name>, for example, ExampleRole\Set-Mailbox.
        For more information about how management role entries work, see
Understanding Management Roles.
        The role entry you want to add must exist in the parent role. If
the role entry name contains spaces, you must enclose the name in quotati
        on marks (").

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -ParentRoleEntry <RoleEntryIdParameter>
        The ParentRoleEntry parameter specifies the role entry in the
parent role to add to the role specified with the Role parameter. This
param
        eter generally isn't used directly, but exists to enable the
piping of role entries from the Get-ManagementRoleEntry cmdlet. If you
use th
        e ParentRoleEntry parameter, you can't use the UnScopedTopLevel
switch.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Role <RoleIdParameter>
        The Role parameter specifies the role to which the new role
entry, specified by the ParentRoleEntry parameter, is added.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Force <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Overwrite <SwitchParameter>
        The Overwrite parameter causes existing role entries to be
overwritten by the role entries being added.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Parameters <String[]>
        The Parameters parameter specifies the parameters to be included
in the role being added. The parameters specified must exist on the cmdle
        t associated with the role entry. You can specify multiple
parameters, separated with commas.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -PSSnapinName <String>
        The PSSnapinName parameter specifies the Windows PowerShell snap-
in that contains the cmdlet associated with the role being added. Use the
         Get-PSSnapin cmdlet to retrieve a list of available Windows
PowerShell snap-ins.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Type <Cmdlet | Script | ApplicationPermission | All>
        The Type parameter specifies the type of role entry being added.
The valid values are Cmdlet, Script, and ApplicationPermission.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -UnScopedTopLevel <SwitchParameter>
        The UnScopedTopLevel switch specifies that you're adding a custom
script or non-Exchange cmdlet to an unscoped top-level management role.
        You can only use the UnScopedTopLevel switch when you add a role
entry to an unscoped top-level role. If you use the UnScopedTopLevel swit
        ch, you can't use the ParentRoleEntry parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
    This example adds a new role entry for the Get-Mailbox cmdlet to the
Recipient Administrators management role. The role entry for the Get-Mail
    box cmdlet is added exactly as it's configured in the Recipient
Administrators parent role.

    Add-ManagementRoleEntry "Recipient Administrators\Get-Mailbox"




    -------------------------- EXAMPLE 2 --------------------------




    This example adds a new role entry for the Get-Mailbox cmdlet to the
Recipient Administrators role. Only the Identity, Anr, Server, and Filter
     parameters are added to the new role entry.

    Add-ManagementRoleEntry "Recipient Administrators\Get-Mailbox" -
Parameters Identity, Anr, Server, Filter




    -------------------------- EXAMPLE 3 --------------------------




    This example uses the Get-ManagementRoleEntry cmdlet to retrieve a
list of all the role entries that exist on the Mail Recipients management
r
    ole that contain the string "Mailbox" in the cmdlet name, and then
adds them to the Mailbox Administrators role using the Add-
ManagementRoleEn
    try cmdlet. The role entries are added to the child role exactly as
they're configured on the parent role.

    Get-ManagementRoleEntry "Mail Recipients\*Mailbox*" | Add-
ManagementRoleEntry -Role "Mailbox Administrators"




    -------------------------- EXAMPLE 4 --------------------------
    This example adds the MailboxAudit script with the Department and
Location parameters to the IT Scripts unscoped top-level role.

    Add-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters
Department, Location -UnScopedTopLevel




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/ece406f2-
a6d6-4b5d-94f0-2819a7672088(EXCHG.141).aspx

NAME
       Add-RecipientPermission

SYNOPSIS
    Content specific to Exchange 2010 will be available at a later date.

SYNTAX
    Add-RecipientPermission -Identity <RecipientIdParameter> -
AccessRights <MultiValuedProperty> -Trustee
<SecurityPrincipalIdParameter> [-Confirm
     [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"<Fea
    ture>" entry in the <topic link> topic.


PARAMETERS
    -Identity <RecipientIdParameter>


          Required?                     true
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -AccessRights <MultiValuedProperty>


          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -Trustee <SecurityPrincipalIdParameter>


          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]


          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>


          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -WhatIf [<SwitchParameter>]


          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )
       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       Insert descriptive text for example 1.

       Insert example commands for example 1.




       -------------------------- EXAMPLE 2 --------------------------




       Insert descriptive text for example 2.

       Insert example commands for example 2.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/0740023b-
47df-4f36-bcb9-ce3b0707a6d4(EXCHG.141).aspx

NAME
       Add-RoleGroupMember

SYNOPSIS
    Use the Add-RoleGroupMember cmdlet to add members to a management
role group.

SYNTAX
    Add-RoleGroupMember -Identity <RoleGroupIdParameter> -Member
<SecurityPrincipalIdParameter> [-BypassSecurityGroupManagerCheck
<SwitchParameter
    >] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    When you add a member to a role group, that mailbox, universal
security group (USG), or computer is given the effective permissions
provided b
    y the management roles assigned to the role group.
    If the ManagedBy property has been populated with role group
managers, the user adding a role group member must be a role group
manager. Alter
    nately, if the user is a member of the Organization Management role
group or is directly or indirectly assigned the Role Management role, the
    BypassSecurityGroupManagerCheck switch can be used to override the
security group management check.
    If the role group is a linked role group, you can't use the Add-
RoleGroupMember cmdlet to add members to the role group. Instead, you
need to
    add members to the foreign USG that's linked to the linked role
group. To find the foreign USG that's linked to a role group, use the
Get-Role
    Group cmdlet.
    For more information about role groups, see Understanding Management
Role Groups.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Role
     groups" entry in the Role Management Permissions topic.


PARAMETERS
    -Identity <RoleGroupIdParameter>
        The Identity parameter specifies the role group to add a member
to. If the role group name contains spaces, enclose the name in quotation
        marks (").

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

     -Member <SecurityPrincipalIdParameter>
         The Member parameter specifies the mailbox, USG, or computer to
add to a role group. You can only specify one member at a time. If the
mem
         ber name contains spaces, enclose the name in quotation marks
(").

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -BypassSecurityGroupManagerCheck <SwitchParameter>
        The BypassSecurityGroupManagerCheck switch enables a user who
hasn't been added to the ManagedBy property to add a member to a role
group.
         The user must be a member of the Organization Management role
group or be assigned, either directly or indirectly, the Role Management
ro
        le.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".
INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example adds the user David to the role group Recipient
Management.

    Add-RoleGroupMember "Recipient Management" -Member David




    -------------------------- EXAMPLE 2 --------------------------




    This example finds all the mailboxes that are part of the Sales
department and adds them to the Sales and Marketing Group role group.

    Get-User -Filter { Department -Eq "Sales" -And -RecipientType -Eq
"UserMailbox" } | Get-Mailbox | Add-RoleGroupMember "Sales and Marketing
Gro
    up"

    If you want to verify that the correct members will be added before
committing changes, use the WhatIf parameter.

    Get-User -Filter { Department -Eq "Sales" -And -RecipientType -Eq
"UserMailbox" } | Get-Mailbox | Add-RoleGroupMember "Sales and Marketing
Gro
    up" -WhatIf

    For more information about filtering recipients, pipelining, and the
WhatIf parameter, see the following topics:

    Filterable Properties for the -Filter Parameter
    Pipelining
    WhatIf, Confirm, and ValidateOnly Switches
       -------------------------- EXAMPLE 3 --------------------------




    This example adds the Training Assistants USG to the Training
Administrators role group. Because the user running the command wasn't
added to
    the ManagedBy property of the role group, the
BypassSecurityGroupManagerCheck switch must be used. The user is assigned
the Role Management ro
    le, which enables the user to bypass the security group manager
check.

    Add-RoleGroupMember "Training Administrators" -Member "Training
Assistants" -BypassSecurityGroupManagerCheck




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/ed53e269-
a855-4066-88a7-1ba36086bd72(EXCHG.141).aspx

NAME
       Add-SupervisionListEntry

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Add-SupervisionListEntry cmdlet to add an entry to a cloud-
based user's supervision list. Each user has a personalized list of
entries
    .

SYNTAX
    Add-SupervisionListEntry -Identity <RecipientIdParameter> -Entry
<RecipientIdParameter> -Tag <String> [-Confirm [<SwitchParameter>]] [-
DomainC
    ontroller <Fqdn>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    Supervision list entries that are configured in a mailbox perform the
following functions:
    * They specify individual exceptions for the user in the closed
campus supervision policy.
    * They identify the user as a victim in the anti-bullying policy.
This prevents the specified recipients from sending messages to the user.
PARAMETERS
    -Entry <RecipientIdParameter>
        The Entry parameter specifies the mailbox, mail user, mail
contact, distribution group, or external sender that will be blocked or
allowed
         by this supervision list entry. For internal senders, you can
use any value that uniquely identifies the sender.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address
        For external senders that aren't in the address book, you specify
their e-mail address.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <RecipientIdParameter>
        The Identity parameter specifies the mailbox that will contain
the supervision list entry. You can use any value that uniquely
identifies
        the mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Tag <String>
        The Tag parameter specifies the supervision tag. Acceptable
values are Allow or Reject. The value Allow specifies individual
exceptions to
         the closed campus supervision policies. The value Reject
identifies the person specified by the Entry parameter as a bully in the
anti-bu
        llying supervision policy.
          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )
       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example uses the anti-bullying supervision policy to prevent a
user named "Jeff Price" from sending messages to a user named "Karen
Berg"
    . In this example, Jeff is the suspected bully, and Karen is the
alleged victim.

    Add-SupervisionListEntry "Karen Berg" -Entry "Jeff Price" -Tag
"Reject"




       -------------------------- EXAMPLE 2 --------------------------




    This example specifies an individual exception to the closed campus
supervision policies for a user named "Kim Akers" so Kim can communicate
w
    ith the external recipient "laura@contoso.com". Entries on a user's
Allow list bypass both inbound and outbound closed campus restrictions.

    Add-SupervisionListEntry "Kim Akers" -Entry laura@contoso.com -Tag
Allow




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/a415deb7-
be7b-41b4-ac07-57674c71e819(EXCHG.141).aspx

B:

C:

cd..

cd\

NAME
    Clear-ActiveSyncDevice

SYNOPSIS
    Use the Clear-ActiveSyncDevice cmdlet to delete all data from a
mobile phone.

SYNTAX
    Clear-ActiveSyncDevice -Identity <ActiveSyncDeviceIdParameter> [-
Cancel <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-
DomainController <
    Fqdn>] [-NotificationEmailAddresses <MultiValuedProperty>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Clear-ActiveSyncDevice cmdlet deletes all user data from a mobile
phone the next time that the device receives data from the server runnin
    g Microsoft Exchange Server 2010. This cmdlet sets the
DeviceWipeStatus parameter to $true. The mobile phone acknowledges the
cmdlet and recor
    ds the time stamp in the DeviceWipeAckTime parameter.
    After you run this cmdlet, you receive a warning that states: "This
command will force all the data on the device to be permanently deleted.
D
    o you want to continue?" You must respond to the warning for the
cmdlet to run on the mobile phone.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Exch
    ange ActiveSync user settings" entry in the Client Access Permissions
topic.


PARAMETERS
    -Identity <ActiveSyncDeviceIdParameter>
        The Identity parameter specifies the identity of the device that
you want to reset.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Cancel <SwitchParameter>
         The Cancel parameter specifies whether the command should be
canceled. If you use the Cancel parameter, a cancellation request is
issued f
         or the remote device wipe.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -NotificationEmailAddresses <MultiValuedProperty>
        The NotificationEmailAddresses parameter specifies the
notification e-mail address for the remote device wipe confirmation.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
         OutBuffer and OutVariable. For more information, type,
         "get-help about_commonparameters".

INPUTS

OUTPUTS
    @{Text=DeviceWipeSetTime}
        System.DateTime


TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example clears all data from the mobile phone with the Identity
WM_JeffHay.

    Clear-ActiveSyncDevice -Identity WM_JeffHay




    -------------------------- EXAMPLE 2 --------------------------




    This example clears all data from the mobile phone for Tony Smith and
sends a confirmation e-mail message to tony@contoso.com.

    Clear-ActiveSyncDevice -Identity WM_TonySmith -
NotificationEmailAddresses "tony@contoso.com"
       -------------------------- EXAMPLE 3 --------------------------




    This example cancels a previously sent Clear-ActiveSyncDevice command
request for Tony Smith's mobile phone.

       Clear-ActiveSyncDevice -Identity WM_TonySmith -Cancel $true




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/016768f2-
98b3-4f71-b15a-830285a6feac(EXCHG.141).aspx

Clear-Host

NAME
       Clear-TextMessagingAccount

SYNOPSIS
    Use the Clear-TextMessagingAccount cmdlet to remove the text
messaging settings from a user's account.

SYNTAX
    Clear-TextMessagingAccount -Identity <MailboxIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope
<Swit
    chParameter>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Clear-TextMessagingAccount cmdlet clears all of a user's text
messaging settings, including communication and notification settings.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Text
     messaging settings" entry in the Client Access Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the target mailbox. You can use
one of the following values:
        * CommonName
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
         what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example clears the text messaging account settings and
notification settings from Tony Smith's mailbox.

    Clear-TextMessagingAccount -Identity "TonySmith"




    -------------------------- EXAMPLE 2 --------------------------




    This example clears the text messaging account settings and
notification settings from Tony Smith's mailbox and displays a
confirmation messag
    e.

    Clear-TextMessagingAccount -Identity "Contoso\TonySmith" -Confirm
$true
       -------------------------- EXAMPLE 3 --------------------------




    This example clears the text messaging account settings and
notification settings from Tony Smith's mailbox.

       Clear-TextMessagingAccount -Identity "tony@contoso.com"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/ebc17689-
0c30-4d0b-9a53-d81a909458d3(EXCHG.141).aspx

NAME
       Compare-TextMessagingVerificationCode

SYNOPSIS
    Use the Compare-TextMessagingVerificationCode cmdlet to verify the
text messaging verification code that the user specified.

SYNTAX
    Compare-TextMessagingVerificationCode [-Identity
<MailboxIdParameter>] -VerificationCode <String> [-Confirm
[<SwitchParameter>]] [-DomainContr
    oller <Fqdn>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Compare-TextMessagingVerificationCode cmdlet returns true if the
code matches the stored code generated by the Send-TextMessagingVerificat
    ionCode cmdlet.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Text
     messaging settings" entry in the Client Access Permissions topic.


PARAMETERS
    -VerificationCode <String>
        The VerificationCode parameter contains the verification code
that the user specified.
        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxIdParameter>
        The Identity parameter specifies the mailbox ID for the user.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
          ErrorAction, ErrorVariable, WarningAction, WarningVariable,
          OutBuffer and OutVariable. For more information, type,
          "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example compares the verification code 111555 to the code sent
to Tony Smith's mobile phone.

    Compare-TextMessagingVerificationCode -Identity TonySmith -
VerificationCode 111555




    -------------------------- EXAMPLE 2 --------------------------




    This example compares the verification code 123456 to the code sent
to Tony Smith's mobile phone.

    Compare-TextMessagingVerificationCode -Identity tony@contoso.com -
VerificationCode 123456




    -------------------------- EXAMPLE 3 --------------------------




    This example compares the verification code 111555 to the code sent
to Tony Smith's mobile phone after confirmation is given.
    Compare-TextMessagingVerificationCode -Identity TonySmith -
VerificationCode 111555 -Confirm $true




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/aef03828-
bd6b-4bd4-9aaf-56d4fc5872d5(EXCHG.141).aspx

NAME
       Complete-Migration

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Complete-Migration cmdlet to finalize all successfully
completed migration batches. Run this cmdlet after you configure your MX
record
     to point to the cloud-based messaging system.

SYNTAX
    Complete-Migration [-Identity <MigrationBatchIdParameter>] [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-Hotmail <SwitchParamete
    r>] [-NotificationEmails <MultiValuedProperty>] [-Organization
<OrganizationIdParameter>] [-SuppressErrors <SwitchParameter>] [-WhatIf
[<Switc
    hParameter>]] [<CommonParameters>]


DESCRIPTION
    The Complete-Migration finalizes all completed migration batches by
doing the following:
    * Performs a final synchronization for all subscriptions. This means
a final synchronization of each user's on-premises and cloud-based accoun
      ts.
    * Deletes each subscription after the final synchronization.
    * Sends a final status report after all subscriptions are deleted and
the migration is marked as complete.


PARAMETERS
    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false
       -DomainController <Fqdn>
           This parameter is reserved for internal Microsoft use.

          Required?                        false
          Position?                        Named
          Default value
          Accept pipeline input?           False
          Accept wildcard characters?      false

    -Identity <MigrationBatchIdParameter>
        The value of the Identity parameter is assigned by the migration
service running on Microsoft Exchange.

          Required?                        false
          Position?                        1
          Default value
          Accept pipeline input?           True
          Accept wildcard characters?      false

       -Hotmail <SwitchParameter>
           This parameter is reserved for internal Microsoft use.

          Required?                        false
          Position?                        Named
          Default value
          Accept pipeline input?           False
          Accept wildcard characters?      false

    -NotificationEmails <MultiValuedProperty>
        The NotificationEmails parameter specifies one or more e-mail
addresses that migration status reports are sent to. Specify the value as
a
        string array and separate multiple e-mail addresses with commas.
        If you don't use this parameter, the final status report is sent
to the administrator who runs the Complete-Migration cmdlet.

          Required?                        false
          Position?                        Named
          Default value
          Accept pipeline input?           False
          Accept wildcard characters?      false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                        false
          Position?                        Named
          Default value
          Accept pipeline input?           False
          Accept wildcard characters?      false

       -SuppressErrors <SwitchParameter>
        The SupressErrors parameter will ignore any errors that may occur
during the finalization process.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE --------------------------




    This example completes all migration batches and sends a final
migration status report to the administrator and helpdesk accounts at
Contoso U
    niversity.

    Complete-Migration -NotificationEmails
admin@contoso.edu,helpdesk@contoso.edu
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/fb367950-
e212-4aea-ae92-1e465f8307a4(EXCHG.141).aspx

D:

NAME
       Disable-InboxRule

SYNOPSIS
    Use the Disable-InboxRule cmdlet to disable an Inbox rule.

SYNTAX
    Disable-InboxRule -Identity <InboxRuleIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-Force
<SwitchParameter>] [-Mail
    box <MailboxIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]


DESCRIPTION
    When you create, modify, remove, enable, or disable an Inbox rule on
Microsoft Exchange Server 2010, any client-side rules created by Microsof
    t Office Outlook are removed.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Inbo
    x rules" entry in the Mailbox Permissions topic.


PARAMETERS
    -Identity <InboxRuleIdParameter>
        The Identity parameter specifies the identity of the Inbox rule
to be disabled.

          Required?                     true
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Force <SwitchParameter>
        The Force switch specifies whether to suppress the confirmation
prompt produced if rules created by Outlook exist on the mailbox. When
tak
        ing an action using Inbox rules on Exchange 2010, any client-side
rules are removed.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the identity of the mailbox to
which the Inbox rule belongs.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
          This cmdlet supports the common parameters: Verbose, Debug,
          ErrorAction, ErrorVariable, WarningAction, WarningVariable,
          OutBuffer and OutVariable. For more information, type,
          "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example disables the Inbox rule MoveAnnoncements in the mailbox
Joe@Contoso.com.

    Disable-InboxRule -Identity "MoveAnnouncements" -Mailbox
"Joe@Contoso.com"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/89ac946b-
575e-460c-8a9f-a775d22c87e9(EXCHG.141).aspx

NAME
       Disable-JournalRule

SYNOPSIS
    Use the Disable-JournalRule cmdlet to disable an existing journal
rule on a Hub Transport server.

SYNTAX
    disable-journalrule -Identity <RuleIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-LawfulInterception
<SwitchParamete
    r>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Disable-JournalRule cmdlet disables an existing rule used by the
Journaling agent.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Jour
    naling" entry in the Messaging Policy and Compliance Permissions
topic.


PARAMETERS
    -Identity <RuleIdParameter>
         The Identity parameter specifies the rule to be disabled. Enter
either the GUID or the name of the journal rule. You can omit the
paramete
         r label.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -LawfulInterception <SwitchParameter>
        The LawfulInterception parameter is reserved for internal
Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example disables the existing journal rule Brokerage
Communications.

    Disable-JournalRule "Brokerage Communications"
       -------------------------- EXAMPLE 2 --------------------------




    This example disables all journal rules. The Get-JournalRule cmdlet
is used to add all journal rules to the pipeline. The results are piped
to
     the Disable-JournalRule cmdlet.

       Get-JournalRule | Disable-JournalRule




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/0324144b-
2818-4e7f-a483-d6d6a19f8276(EXCHG.141).aspx

NAME
       Disable-Mailbox

SYNOPSIS
    Use the Disable-Mailbox cmdlet to disable the mailbox of an existing
user or InetOrgPerson object and remove that object's Exchange attributes
     from Active Directory. The user account associated with the mailbox
remains in Active Directory but is no longer associated with a mailbox.

SYNTAX
    disable-Mailbox -Identity <MailboxIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope
<SwitchParameter
    >] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

    disable-Mailbox -Identity <MailboxIdParameter> [-Archive
<SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController
<Fqdn>] [-Ignore
    DefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    disable-Mailbox -Identity <MailboxIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope
<SwitchParameter
    >] [-RemoteArchive <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    disable-Mailbox -Identity <MailboxIdParameter> [-Arbitration
<SwitchParameter>] [-Confirm [<SwitchParameter>]] [-
DisableLastArbitrationMailbox
    Allowed <SwitchParameter>] [-DomainController <Fqdn>] [-
IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters
    >]


DESCRIPTION
     The Disable-Mailbox cmdlet removes the mailbox's Exchange attributes
from Active Directory. The mailbox isn't deleted and can be reconnected t
     o its user at a later date by using the Connect-Mailbox cmdlet.
     The Disable-Mailbox cmdlet also performs the cleanup task on the
individual mailbox, so the mailbox is disconnected immediately after this
tas
     k completes. You don't have to wait for nightly maintenance or run
the Clean-MailboxDatabase cmdlet for the mailbox to be disconnected.
     Under normal circumstances, a mailbox is marked as disconnected
immediately after the Disable-Mailbox or Remove-Mailbox command
completes. How
     ever, if the mailbox was disabled or removed while the Microsoft
Exchange Information Store service was stopped, or if it was disabled or
remo
     ved by an external means other than Exchange management interfaces,
the status of the mailbox object in the Exchange mailbox database won't
be
      marked as disconnected. In this case, you can use the Clean-
MailboxDatabase cmdlet to scan Active Directory for disconnected
mailboxes that a
     ren't yet marked as disconnected in the Microsoft Exchange mailbox
database and update the status of those mailboxes in the Exchange mailbox
s
     tore. For more information about the Clean-MailboxDatabase cmdlet,
see Clean-MailboxDatabase.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
     pient Provisioning Permissions" section in the Mailbox Permissions
topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the mailbox you want to disable.
You can use one of the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                    true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Arbitration <SwitchParameter>
        The Arbitration parameter specifies that the mailbox for which
you are executing the command is an arbitration mailbox. Arbitration
mailbo
        xes are used for managing approval workflow. For example, an
arbitration mailbox is used for handling moderated recipients and
distributio
        n group membership approval.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Archive <SwitchParameter>
        The Archive switch specifies whether to disconnect the archive
mailbox from the associated mailbox user.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch can be used to suppress the confirmation
prompt that appears by default when this cmdlet is run. To suppress the
confir
        mation prompt, use the syntax -Confirm:$False. You must include a
colon ( : ) in the syntax.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DisableLastArbitrationMailboxAllowed <SwitchParameter>
        The DisableLastArbitrationMailboxAllowed switch specifies whether
to disable the specified mailbox if it's the last arbitration mailbox in
         the organization. You don't have to specify a value with this
parameter. If you disable the last arbitration mailbox in the
organization,
         you can't have user-created distribution groups or moderated
recipient functionality.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -RemoteArchive <SwitchParameter>
         The RemoteArchive parameter specifies whether to disconnect the
remote archive for this mailbox. A remote archive exists in a cloud-based
         service. When you use this parameter, the RemoteRecipientType
property for the mailbox is reset to specify that this mailbox doesn't
have
         a remote archive.
         You don't need to specify a value with this parameter.
         When you use this parameter, you can't use the Archive parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -WhatIf [<SwitchParameter>]
        The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
         what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example disables the mailbox of user John Woods, whose alias is
john, and removes all the mailbox attributes from Active Directory.

    Disable-Mailbox john@contoso.com




    -------------------------- EXAMPLE 2 --------------------------




    This example disables the remote archive for the mailbox of user John
Woods, whose alias is john.

    Disable-Mailbox -Identity john@contoso.com -RemoteArchive
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/33be55a3-
1880-437d-a631-c1cca1736421(EXCHG.141).aspx

NAME
       Disable-OutlookProtectionRule

SYNOPSIS
    Use the Disable-OutlookProtectionRule cmdlet to disable an existing
Microsoft Outlook protection rule.

SYNTAX
    Disable-OutlookProtectionRule -Identity <RuleIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchParameter
    >]] [<CommonParameters>]


DESCRIPTION
    Outlook protection rules are administrator-created rules applied
before a user sends a message using Outlook. Outlook protection rules are
use
    d to automatically rights-protect e-mail messages using a Rights
Management Services (RMS) template before the message is sent. However,
Outlo
    ok protection rules don't inspect message content. To rights-protect
messages based on message content, use transport protection rules.
    For more information, see Understanding Outlook Protection Rules.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Righ
    ts protection" entry in the Messaging Policy and Compliance
Permissions topic.


PARAMETERS
    -Identity <RuleIdParameter>
        The Identity parameter specifies the name of the rule being
disabled.

          Required?                     true
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:
       -------------------------- EXAMPLE 1 --------------------------




       This example disables the Outlook protection rule Project Contoso.

       Disable-OutlookProtectionRule -Identity "Project Contoso"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/f6be04e8-
bd1c-41ee-b410-e832de66048f(EXCHG.141).aspx

NAME
       Disable-PSRemoting

SYNOPSIS

SYNTAX
    Disable-PSRemoting [-force] [-WhatIf] [-Confirm] [<CommonParameters>]


DESCRIPTION


PARAMETERS
    -force [<SwitchParameter>]

           Required?                     false
           Position?                     named
           Default value
           Accept pipeline input?        false
           Accept wildcard characters?

       -WhatIf [<SwitchParameter>]

           Required?                     false
           Position?                     named
           Default value
           Accept pipeline input?        false
           Accept wildcard characters?

       -Confirm [<SwitchParameter>]

           Required?                     false
           Position?                     named
           Default value
           Accept pipeline input?        false
           Accept wildcard characters?
       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS


RELATED LINKS

NAME
       Disable-TransportRule

SYNOPSIS
    Use the Disable-TransportRule cmdlet to instruct the Transport Rules
agent to disable the processing of a specific transport rule for all e-ma
    il messages that pass through a Hub Transport or Edge Transport
server.

SYNTAX
    Disable-TransportRule -Identity <RuleIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchParameter>]] [<Co
    mmonParameters>]


DESCRIPTION
    For information about how to enable the processing of transport rules
against e-mail messages in a Microsoft Exchange Server 2010 organization
    , see Enable-TransportRule. For information about the Transport Rules
agent, see Overview of Transport Rules.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Tran
    sport rules" entry in the Messaging Policy and Compliance Permissions
topic.


PARAMETERS
    -Identity <RuleIdParameter>
        The Identity parameter specifies the rule to be disabled. Enter
either the GUID or the name of the rule.
        You can omit the parameter label.

          Required?                    true
          Position?                    1
          Default value
          Accept pipeline input?       True
          Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
         ange to Active Directory. The DomainController parameter isn't
supported on the Edge Transport server role. The Edge Transport server
role
          writes only to the Active Directory Lightweight Directory
Services (AD LDS) instance.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
       (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example disables the Sales-Disclaimer rule.

       Disable-TransportRule "Sales-Disclaimer"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/f1b5c2d6-
cfcd-4180-89f5-13723d87a1b4(EXCHG.141).aspx

NAME
       Disable-UMAutoAttendant

SYNOPSIS
    Use the Disable-UMAutoAttendant cmdlet to disable an existing Unified
Messaging (UM) auto attendant that's enabled.

SYNTAX
    Disable-UMAutoAttendant -Identity <UMAutoAttendantIdParameter> [-
Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchPara
    meter>]] [<CommonParameters>]


DESCRIPTION
    The Disable-UMAutoAttendant cmdlet disables an existing UM auto
attendant that's currently enabled. The Disable-UMAutoAttendant cmdlet
disable
    s the UM auto attendant by modifying its status variable. The
Disable-UMAutoAttendant cmdlet can't disable the UM auto attendant if
it's linke
    d or associated to the UM hunt group associated with the default UM
dial plan.
    After this task is completed, the UM auto attendant is disabled and
won't accept incoming calls.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM a
    uto attendants" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -Identity <UMAutoAttendantIdParameter>
        The Identity parameter specifies the identifier for the UM auto
attendant that's being disabled.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.
           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example disables a UM auto attendant named MyUMAutoAttendant.

       Disable-UMAutoAttendant -Identity MyUMAutoAttendant




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/3da890b5-
8985-48a0-a5eb-2667394fe788(EXCHG.141).aspx

NAME
       Disable-UMIPGateway

SYNOPSIS
    Use the Disable-UMIPGateway cmdlet to disable a Unified Messaging
(UM) IP gateway.

SYNTAX
    Disable-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-Immediate <$true |
$false>]
     [-WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The status variable for a UM IP gateway can be used to enable or
disable call answering that's destined for the IP gateway. The Disable-
UMIPGa
    teway cmdlet disables a UM IP gateway in Active Directory by
modifying its status variable. After this task is completed, the UM IP
gateway no
     longer answers incoming calls or makes outgoing calls.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM I
    P gateways" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -Identity <UMIPGatewayIdParameter>
        The Identity parameter specifies the identifier for the UM IP
gateway that's being disabled. This is the directory object ID for the UM
IP
         gateway.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Immediate <$true | $false>
        The Immediate parameter specifies whether the UM server drops
calls associated with this UM IP gateway immediately or waits for the
curren
        t calls to finish processing.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:
NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example disables a UM IP gateway named MyUMIPGateway and stops
it from accepting incoming calls from the IP gateway.

       Disable-UMIPGateway -Identity MyUMIPGateway




       -------------------------- EXAMPLE 2 --------------------------




    This example disables a UM IP gateway named MyUMIPGateway and
disconnects all current calls immediately.

       Disable-UMIPGateway -Identity MyUMIPGateway -Immediate $true




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b6e0627a-
0063-4e1d-bff0-0b35e8d146a2(EXCHG.141).aspx

NAME
       Disable-UMMailbox

SYNOPSIS
    Use the Disable-UMMailbox cmdlet to disable Unified Messaging (UM)
for a UM-enabled recipient.

SYNTAX
    Disable-UMMailbox -Identity <MailboxIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope
<SwitchParamet
    er>] [-KeepProperties <$true | $false>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]
DESCRIPTION
    The Disable-UMMailbox cmdlet disables Unified Messaging for a
Microsoft Exchange Server 2010 recipient who's currently UM-enabled.
After the t
    ask finishes running, Unified Messaging servers no longer handle
calls for the extension number associated with the mailbox. You can
continue
    to use the Exchange mailbox for all other operations unrelated to
Unified Messaging.
    After this task is completed, the user is disabled for Unified
Messaging and can't use the voice mail features found in Unified
Messaging any
    longer.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM m
    ailbox" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the user to disable for Unified
Messaging. The variables for this parameter include the following:
        * ADObjectID
        * GUID
        * DN
        * Domain\Account
        * UPN
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the distinguished name for the Identity
parameter. Other forms of identification, such as alias or GUID, aren't
accepte
          d.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -KeepProperties <$true | $false>
        The KeepProperties parameter specifies whether the mailbox and
directory resident properties should be retained. If this parameter isn't
i
        ncluded, the user's UM properties are retained.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS
    @{Text=}



OUTPUTS
    @{Text=}



NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example disables Unified Messaging on the mailbox for
tonysmith@contoso.com.

       Disable-UMMailbox -Identity tonysmith@contoso.com




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/369cdc8d-
468d-4aed-99ec-1a8ab624f072(EXCHG.141).aspx

E:

NAME
       Enable-InboxRule

SYNOPSIS
    Use the Enable-InboxRule cmdlet to enable an Inbox rule. Inbox rules
are used to process messages in the Inbox based on conditions specified a
    nd take actions such as moving a message to a specified folder or
deleting a message.

SYNTAX
    Enable-InboxRule -Identity <InboxRuleIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-Force
<SwitchParameter>] [-Mailb
    ox <MailboxIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]


DESCRIPTION
    When you create, modify, remove, enable, or disable an Inbox rule on
Microsoft Exchange Server 2010, any client-side rules created by Microsof
    t Outlook are removed.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Inbo
    x rules" entry in the Mailbox Permissions topic.


PARAMETERS
    -Identity <InboxRuleIdParameter>
        The Identity parameter specifies the display name or GUID of the
Inbox rule.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Force <SwitchParameter>
        The Force switch specifies whether to suppress the confirmation
prompt produced if rules created by Outlook exist on the mailbox. When
tak
        ing an action using Inbox rules on Exchange 2010, any client-side
rules are removed.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the identity of the mailbox where
the Inbox rule is located. You can use one of the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".
INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example enables the Inbox rule MoveToJunkMail for User1. Enclose
parameter values, such as Mailbox or InboxRule names that contain spaces
    , in quotation marks (").

       Enable-InboxRule "MoveToJunkMail" -Mailbox "User1"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/e5c09ede-
71eb-42d1-9767-c572d6839c47(EXCHG.141).aspx

NAME
       Enable-JournalRule

SYNOPSIS
    Use the Enable-JournalRule cmdlet to enable an existing journal rule
on a Hub Transport server.

SYNTAX
    enable-journalrule -Identity <RuleIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-LawfulInterception
<SwitchParameter
    >] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Enable-JournalRule cmdlet enables an existing journal rule to be
used by the Journaling agent.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Jour
    naling" entry in the Messaging Policy and Compliance Permissions
topic.


PARAMETERS
    -Identity <RuleIdParameter>
         The Identity parameter specifies the rule to be enabled. Enter
either the GUID or the name of the journal rule. You can omit the
Identity
         parameter label.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -LawfulInterception <SwitchParameter>
        The LawfulInterception switch is used for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -WhatIf [<SwitchParameter>]
        The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
         what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example enables the existing journal rule Brokerage
Communications.

    Enable-JournalRule "Brokerage Communications"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/9a4b01b9-
27d4-41e6-9573-86e27e82de2d(EXCHG.141).aspx

NAME
       Enable-Mailbox

SYNOPSIS
    Use the Enable-Mailbox cmdlet to mailbox-enable an existing user or
Active Directory InetOrgPerson object.

SYNTAX
    enable-Mailbox -Identity <UserIdParameter> [-AccountDisabled <$true |
$false>] [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <
    String>] [-BypassModerationCheck <SwitchParameter>] [-Confirm
[<SwitchParameter>]] [-Database <DatabaseIdParameter>] [-DisplayName
<String>] [
    -DomainController <Fqdn>] [-Force <SwitchParameter>] [-MailboxPlan
<MailboxPlanIdParameter>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdPara
    meter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-
PrimarySmtpAddress <SmtpAddress>] [-RetentionPolicy
<MailboxPolicyIdParameter
    >] [-RoleAssignmentPolicy <MailboxPolicyIdParameter>] [-SKUAssigned
<$true | $false>] [-SKUCapability <None | BPOS_S_Deskless |
BPOS_S_Standar
    d | BPOS_S_Archive | BPOS_L_Standard | BPOS_B_Standard | TOU_Signed |
FederatedUser | Partner_Managed | MasteredOnPremise | ResourceMailbox |
    ExcludedFromBackSync | UMFeatureRestricted>] [-UsageLocation
<CountryInfo>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

    enable-Mailbox -Identity <UserIdParameter> [-AccountDisabled <$true |
$false>] [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <
    String>] [-BypassModerationCheck <SwitchParameter>] [-Confirm
[<SwitchParameter>]] [-Database <DatabaseIdParameter>] [-DisplayName
<String>] [
    -DomainController <Fqdn>] [-Force <SwitchParameter>] [-MailboxPlan
<MailboxPlanIdParameter>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdPara
    meter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-
PrimarySmtpAddress <SmtpAddress>] [-RetentionPolicy
<MailboxPolicyIdParameter
    >] [-RoleAssignmentPolicy <MailboxPolicyIdParameter>] [-SKUAssigned
<$true | $false>] [-SKUCapability <None | BPOS_S_Deskless |
BPOS_S_Standar
    d | BPOS_S_Archive | BPOS_L_Standard | BPOS_B_Standard | TOU_Signed |
FederatedUser | Partner_Managed | MasteredOnPremise | ResourceMailbox |
    ExcludedFromBackSync | UMFeatureRestricted>] [-UsageLocation
<CountryInfo>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

    enable-Mailbox -Identity <UserIdParameter> -Shared <SwitchParameter>
[-AccountDisabled <$true | $false>] [-ActiveSyncMailboxPolicy <MailboxPol
    icyIdParameter>] [-Alias <String>] [-BypassModerationCheck
<SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Database
<DatabaseIdParameter>]
     [-DisplayName <String>] [-DomainController <Fqdn>] [-Force
<SwitchParameter>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdParameter>] [-Mana
    gedFolderMailboxPolicyAllowed <SwitchParameter>] [-PrimarySmtpAddress
<SmtpAddress>] [-RetentionPolicy <MailboxPolicyIdParameter>] [-RoleAssig
    nmentPolicy <MailboxPolicyIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

     enable-Mailbox -Identity <UserIdParameter> -LinkedDomainController
<String> -LinkedMasterAccount <UserIdParameter> [-ActiveSyncMailboxPolicy
<
     MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm
[<SwitchParameter>]] [-Database <DatabaseIdParameter>] [-DisplayName
<String>] [-Domain
     Controller <Fqdn>] [-Force <SwitchParameter>] [-LinkedCredential
<PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
[-Ma
     nagedFolderMailboxPolicyAllowed <SwitchParameter>] [-
PrimarySmtpAddress <SmtpAddress>] [-RetentionPolicy
<MailboxPolicyIdParameter>] [-RoleAss
     ignmentPolicy <MailboxPolicyIdParameter>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]

    enable-Mailbox -Identity <UserIdParameter> -Room <SwitchParameter> [-
AccountDisabled <$true | $false>] [-ActiveSyncMailboxPolicy <MailboxPolic
    yIdParameter>] [-Alias <String>] [-BypassModerationCheck
<SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Database
<DatabaseIdParameter>] [
    -DisplayName <String>] [-DomainController <Fqdn>] [-Force
<SwitchParameter>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdParameter>] [-Manage
    dFolderMailboxPolicyAllowed <SwitchParameter>] [-PrimarySmtpAddress
<SmtpAddress>] [-RetentionPolicy <MailboxPolicyIdParameter>] [-
RoleAssignm
    entPolicy <MailboxPolicyIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

     enable-Mailbox -Identity <UserIdParameter> -Arbitration
<SwitchParameter> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
[-Alias <Strin
     g>] [-Confirm [<SwitchParameter>]] [-Database <DatabaseIdParameter>]
[-DisplayName <String>] [-DomainController <Fqdn>] [-Force <SwitchParamet
     er>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-
ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-PrimarySmtpAddress
<Smt
     pAddress>] [-RetentionPolicy <MailboxPolicyIdParameter>] [-
RoleAssignmentPolicy <MailboxPolicyIdParameter>] [-WhatIf
[<SwitchParameter>]] [<Co
     mmonParameters>]

    enable-Mailbox -Identity <UserIdParameter> -Equipment
<SwitchParameter> [-AccountDisabled <$true | $false>] [-
ActiveSyncMailboxPolicy <Mailbox
    PolicyIdParameter>] [-Alias <String>] [-BypassModerationCheck
<SwitchParameter>] [-Confirm [<SwitchParameter>]] [-Database
<DatabaseIdParamete
    r>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Force
<SwitchParameter>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdParameter>] [-M
    anagedFolderMailboxPolicyAllowed <SwitchParameter>] [-
PrimarySmtpAddress <SmtpAddress>] [-RetentionPolicy
<MailboxPolicyIdParameter>] [-RoleAs
    signmentPolicy <MailboxPolicyIdParameter>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]

    enable-Mailbox -Identity <UserIdParameter> -Discovery
<SwitchParameter> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
[-Alias <String>
    ] [-Confirm [<SwitchParameter>]] [-Database <DatabaseIdParameter>] [-
DisplayName <String>] [-DomainController <Fqdn>] [-Force <SwitchParameter
    >] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-
ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-PrimarySmtpAddress
<SmtpA
    ddress>] [-RetentionPolicy <MailboxPolicyIdParameter>] [-
RoleAssignmentPolicy <MailboxPolicyIdParameter>] [-WhatIf
[<SwitchParameter>]] [<Comm
    onParameters>]

    enable-Mailbox -Identity <UserIdParameter> [-ActiveSyncMailboxPolicy
<MailboxPolicyIdParameter>] [-Alias <String>] [-Archive <SwitchParameter>
    ] [-ArchiveDatabase <DatabaseIdParameter>] [-ArchiveGuid <Guid>] [-
ArchiveName <MultiValuedProperty>] [-BypassModerationCheck
<SwitchParameter
    >] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-
DomainController <Fqdn>] [-Force <SwitchParameter>] [-
IgnoreExistingArchive <Switc
    hParameter>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
[-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-PrimarySmtpAddr
    ess <SmtpAddress>] [-RetentionPolicy <MailboxPolicyIdParameter>] [-
RoleAssignmentPolicy <MailboxPolicyIdParameter>] [-WhatIf
[<SwitchParameter
    >]] [<CommonParameters>]

    enable-Mailbox -Identity <UserIdParameter> -ArchiveDomain
<SmtpDomain> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-
Alias <String>]
     [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-
DomainController <Fqdn>] [-Force <SwitchParameter>] [-
IgnoreExistingArchive <SwitchP
    arameter>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
[-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-
PrimarySmtpAddres
    s <SmtpAddress>] [-RemoteArchive <SwitchParameter>] [-RetentionPolicy
<MailboxPolicyIdParameter>] [-RoleAssignmentPolicy <MailboxPolicyIdParam
    eter>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
DESCRIPTION
    Mailbox-enabling an existing user or InetOrgPerson object creates
additional mailbox attributes on the user object in Active Directory.
When t
    he user logs on to the mailbox or receives e-mail messages, a mailbox
object in the Exchange database is created.
    Use the Identity parameter to specify the user or InetOrgPerson
object for whom the mailbox is enabled. Use the Database parameter to
specify
    the Exchange database that contains the mailbox.
    When mailbox-enabling an existing user, if an alias isn't specified,
Exchange uses the name and converts all non-ASCII characters to question
    mark (?) characters. In some languages that use nonstandard character
sets, the user account may have a non-ASCII value for the name. In this
    case, when you mailbox-enable the user, the alias is changed to all
question mark characters. To avoid this, confirm that the user account
has
     an ASCII name before you create the new mailbox, or make sure you
specify a value for the alias.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
    pient Provisioning Permissions" section in the Mailbox Permissions
topic.


PARAMETERS
    -Arbitration <SwitchParameter>
        The Arbitration parameter specifies that the mailbox for which
you are executing the command is an arbitration mailbox. Arbitration
mailbo
        xes are used for managing approval workflow. For example, an
arbitration mailbox is used for handling moderated recipients and
distributio
        n group membership approval.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ArchiveDomain <SmtpDomain>
         The ArchiveDomain parameter specifies the cloud-based domain on
which the archive associated with this mailbox exists. For example, if
the
          SMTP e-mail address of the user is tony@contoso.com, the SMTP
domain could be archive.contoso.com.
         Only use this parameter if the archive is hosted in a cloud-based
service.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Discovery <SwitchParameter>
        The Discovery parameter specifies that this mailbox is a
Discovery mailbox. Discovery mailboxes are created as target mailboxes
for Discov
        ery searches. You don't have to include a value with this
parameter.
        After being created or enabled, a Discovery mailbox can't be
converted to another type of mailbox.
        For more information, see Understanding Multi-Mailbox Search.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Equipment <SwitchParameter>
        The Equipment parameter specifies that the type of resource is
equipment, if this mailbox is a resource mailbox. This parameter is
require
        d only if you're enabling a resource mailbox.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <UserIdParameter>
        The Identity parameter specifies the user or InetOrgPerson object
that you want to mailbox-enable. You can use one of the following values
        :
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -LinkedDomainController <String>
        The LinkedDomainController parameter specifies the domain
controller in the forest where the user account resides. The domain
controller i
        n this forest is used to get security information for the account
specified by the LinkedMasterAccount parameter. This parameter is requir
        ed only if you're creating a linked mailbox. Use the fully
qualified domain name (FQDN) of the domain controller you want to use as
the va
        lue for this parameter.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -LinkedMasterAccount <UserIdParameter>
        The LinkedMasterAccount parameter specifies the master account in
the forest where the user account resides. The master account is the acc
        ount to link the mailbox to. The master account grants access to
the mailbox. This parameter is required only if you're creating a linked
        mailbox. You can use one of the following values:
        * GUID
        * DN
        * Domain\Account
        * UPN
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Room <SwitchParameter>
        The Room parameter specifies that the type of resource is a room,
if this mailbox is a resource mailbox. This parameter is required only i
        f you're enabling a resource mailbox.
        You don't have to specify a value with this parameter.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Shared <SwitchParameter>
         The Shared parameter specifies that you're creating a shared
mailbox. A shared mailbox is a mailbox to which multiple users can log
on. Th
         is mailbox isn't associated with any of the users that can log
on. It's associated with a disabled user account.
         This parameter is required only if you're creating a shared
mailbox.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AccountDisabled <$true | $false>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>
        The ActiveSyncMailboxPolicy parameter specifies the mailbox
policy to enable for the mailbox that you create. If you don't specify
this pa
        rameter, the default mailbox policy is used.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Alias <String>
        The Alias parameter specifies the e-mail alias of the mailbox
that you're enabling.
        The alias can be a combination of characters separated by a
period with no intervening spaces. Don't use special characters in the
alias.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Archive <SwitchParameter>
        The Archive parameter specifies that when this mailbox is
enabled, an archive will be created.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ArchiveDatabase <DatabaseIdParameter>
         The ArchiveDatabase parameter specifies the Exchange database
that contains the archive associated with this mailbox. You can use the
foll
         owing values:
         * GUID of the database
        * Database name

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ArchiveGuid <Guid>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ArchiveName <MultiValuedProperty>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -BypassModerationCheck <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Database <DatabaseIdParameter>
        The Database parameter specifies which Exchange database contains
the new mailbox. You can use one of the following values:
        * GUID of the database
        * Database name

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DisplayName <String>
        The DisplayName parameter specifies the display name for the
mailbox. The DisplayName is the name that appears in the Exchange
Management
        Console under Recipient Configuration.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Force <SwitchParameter>
        The Force parameter specifies whether to suppress warning or
confirmation messages. This parameter can be used when the task is run
progra
        mmatically and prompting for administrative input is
inappropriate. If the Force parameter isn't provided in the command,
administrative i
        nput is prompted. If the Force parameter is provided in the
command, but the value is omitted, its default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IgnoreExistingArchive <SwitchParameter>
        The IgnoreExistingArchive parameter specifies whether to have
Exchange ignore any archives that were previously associated with this
mailb
        ox when it gets enabled. If a user's mailbox and archive are
disabled and then re-enabled, Exchange automatically reconnects the
user's ar
        chive mailbox to the mailbox provided that the archive wasn't
deleted from the database. If you don't want to reconnect the user's
disable
        d archive, you should use this parameter.
        If you use this parameter and the disconnected archive is no
longer available on the database, a new archive is created and this
parameter
         is ignored.
        You don't need to specify a value with this parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -LinkedCredential <PSCredential>
         The LinkedCredential parameter specifies credentials to use to
access the domain controller specified by the LinkedDomainController
parame
         ter. This parameter is optional, even if you're enabling a linked
mailbox.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MailboxPlan <MailboxPlanIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>
        The ManagedFolderMailboxPolicy parameter specifies the managed
folder mailbox policy to enable for the mailbox that you create. If you
don
        't specify this parameter, the default managed folder mailbox
policy is used.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ManagedFolderMailboxPolicyAllowed <SwitchParameter>
        The ManagedFolderMailboxPolicyAllowed parameter specifies whether
to bypass the warning that messaging records management (MRM) features a
        ren't supported for e-mail clients using versions of Microsoft
Outlook earlier than Office Outlook 2007. When a managed folder mailbox
pol
        icy is assigned to a mailbox using the ManagedFolderMailboxPolicy
parameter, the warning appears by default unless the ManagedFolderMailbo
        xPolicyAllowed parameter is used.
        Outlook 2003 Service Pack 3 clients are supported but are
provided limited functionality for MRM.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -PrimarySmtpAddress <SmtpAddress>
        The PrimarySmtpAddress parameter specifies the primary SMTP
address for the mailbox. By default, the primary SMTP address is
generated bas
        ed on the default e-mail address policy. If you specify a primary
SMTP address by using this parameter, the command sets the EmailAddressP
        olicyEnabled attribute of the mailbox to $false, and the e-mail
addresses of this mailbox aren't automatically updated based on e-mail
add
        ress policies.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RemoteArchive <SwitchParameter>
        The RemoteArchive parameter specifies that when the mailbox is
enabled, a remote archive for this mailbox will be created. A remote
archiv
        e exists in a cloud-based service. You don't have to specify a
value with this parameter. You can't use the Archive parameter in
conjuncti
        on with this parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RetentionPolicy <MailboxPolicyIdParameter>
        The RetentionPolicy parameter specifies the name of a retention
policy that you want applied to this mailbox. Retention policies consist
o
        f tags that are applied to mailbox folders and mail items to
determine the period of time that the items should be retained.
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RoleAssignmentPolicy <MailboxPolicyIdParameter>
         The RoleAssignmentPolicy parameter specifies the management role
assignment policy to assign to the mailbox when it's created or enabled.
         If you don't include this parameter when you create or enable a
mailbox, the default assignment policy is used. If the assignment policy
n
         ame contains spaces, enclose the name in quotation marks ("). If
you don't want to assign an assignment policy when a mailbox is created o
         r enabled, specify a value of $null. For more information about
assignment policies, see Understanding Management Role Assignment
Policies
         .

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SKUAssigned <$true | $false>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SKUCapability <None | BPOS_S_Deskless | BPOS_S_Standard |
BPOS_S_Archive | BPOS_L_Standard | BPOS_B_Standard | TOU_Signed |
FederatedUser | P
    artner_Managed | MasteredOnPremise | ResourceMailbox |
ExcludedFromBackSync | UMFeatureRestricted>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -UsageLocation <CountryInfo>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example creates a mailbox for the existing user Ayla Kol. The
mailbox is created in Database01 on Exchange server Mail01.

    Enable-Mailbox -Identity Contoso\Ayla -Database Mail01\Database01




    -------------------------- EXAMPLE 2 --------------------------




    This example creates a remote archive for the existing user Ayla Kol.
The archive is created with the following settings:
    The archive database has the GUID 82025f12-8000-4d5e-8059-
c052f9355125.
    The archive domain is archive.contoso.com.

    Enable-Mailbox -Identity ayla@contoso.com -RemoteArchive -
ArchiveDatabase "82025f12-8000-4d5e-8059-c052f9355125" -ArchiveDomain
"archive.conto
    so.com"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/58de5b3c-
05c3-4a1f-84c6-f082d990f22b(EXCHG.141).aspx

NAME
       Enable-OutlookProtectionRule

SYNOPSIS
    The Enable-OutlookProtectionRule cmdlet enables an existing Microsoft
Outlook protection rule.

SYNTAX
    Enable-OutlookProtectionRule -Identity <RuleIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchParameter>
    ]] [<CommonParameters>]


DESCRIPTION
    Outlook protection rules are used to automatically rights-protect
messages using a Rights Management Services (RMS) template before the
messag
    e is sent. However, Outlook protection rules don't inspect message
content. To rights-protect messages based on message content, use
transport
     protection rules. For more information, see Understanding Outlook
Protection Rules.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Righ
    ts protection" entry in the Messaging Policy and Compliance
Permissions topic.


PARAMETERS
    -Identity <RuleIdParameter>
           The Identity parameter specifies the name of the rule being
enabled.

           Required?                     true
           Position?                     1
           Default value
           Accept pipeline input?        True
           Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS
OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example enables the Outlook protection rule Project Contoso.

       Enable-OutlookProtectionRule -Identity "Project Contoso"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/30344629-
5705-4827-b3d1-d56b036d0eac(EXCHG.141).aspx

NAME
       Enable-TransportRule

SYNOPSIS
     Use the Enable-TransportRule cmdlet to instruct the Transport Rules
agent to enable the processing of a specific transport rule for all e-
mail
      messages that pass through a Hub Transport server or an Edge
Transport server.

SYNTAX
    Enable-TransportRule -Identity <RuleIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchParameter>]] [<Com
    monParameters>]


DESCRIPTION
    For information about how to disable the processing of transport
rules in a Microsoft Exchange Server 2010 organization, see Disable-
Transport
    Rule. For information about the Transport Rules agent, see Overview
of Transport Rules.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Tran
    sport rules" entry in the Messaging Policy and Compliance Permissions
topic.


PARAMETERS
    -Identity <RuleIdParameter>
        The Identity parameter specifies the rule to be enabled. Enter
either the GUID or the name of the rule. You can omit the parameter
label.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
         ange to Active Directory. The DomainController parameter isn't
supported on the Edge Transport server role. The Edge Transport server
role
          writes only to the Active Directory Lightweight Directory
Services (AD LDS) instance.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.
           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example enables the transport rule Disclaimer-Finance.

       Enable-TransportRule "Disclaimer-Finance"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/203d2fa8-
83fe-4643-bbc2-db746ffd76a7(EXCHG.141).aspx

NAME
       Enable-UMAutoAttendant

SYNOPSIS
    Use the Enable-UMAutoAttendant cmdlet to enable an existing Unified
Messaging (UM) auto attendant that's disabled.

SYNTAX
    Enable-UMAutoAttendant -Identity <UMAutoAttendantIdParameter> [-
Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchParam
    eter>]] [<CommonParameters>]


DESCRIPTION
     The Enable-UMAutoAttendant cmdlet enables the UM auto attendant by
modifying its status variable. When you create a UM auto attendant, it
isn'
     t enabled by default. For the auto attendant to answer incoming
calls, you must first enable it. After this task is completed, the UM
auto att
     endant answers incoming calls.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM a
     uto attendants" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -Identity <UMAutoAttendantIdParameter>
        The Identity parameter specifies the identifier for the UM auto
attendant that's being enabled.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example enables a UM auto attendant named MyUMAutoAttendant.

    Enable-UMAutoAttendant -Identity MyUMAutoAttendant
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/4286a209-
077f-4413-a3aa-48c4a2af0aa5(EXCHG.141).aspx

NAME
       Enable-UMIPGateway

SYNOPSIS
    Use the Enable-UMIPGateway cmdlet to enable a Unified Messaging (UM)
IP gateway.

SYNTAX
    Enable-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchParameter>]]
    [<CommonParameters>]


DESCRIPTION
    The status variable for a UM IP gateway can be used to enable or
disable call answering destined for the IP gateway. The Enable-
UMIPGateway cm
    dlet enables a UM IP gateway in Active Directory by modifying its
status variable.
    After this task is completed, the UM IP gateway answers incoming
calls and makes outgoing calls through the IP gateway or IP Private
Branch eX
    change.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM I
    P gateways" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -Identity <UMIPGatewayIdParameter>
        The Identity parameter specifies the identifier for the UM IP
gateway being enabled. This parameter is the directory object ID for the
UM
        IP gateway.

          Required?                     true
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false
    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example enables a UM IP gateway named MyUMIPGateway.

       Enable-UMIPGateway -Identity MyUMIPGateway




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/4a94d6a0-
0eb3-4426-b263-58b3db0de7e2(EXCHG.141).aspx

NAME
       Enable-UMMailbox

SYNOPSIS
    Use the Enable-UMMailbox cmdlet to enable Unified Messaging (UM) for
an existing mail-enabled user.

SYNTAX
     Enable-UMMailbox -Identity <MailboxIdParameter> -UMMailboxPolicy
<MailboxPolicyIdParameter> [-AutomaticSpeechRecognitionEnabled <$true |
$fals
     e>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-
Extensions <MultiValuedProperty>] [-IgnoreDefaultScope <SwitchParameter>]
[-No
     tifyEmail <String>] [-PilotNumber <String>] [-Pin <String>] [-
PinExpired <$true | $false>] [-SIPResourceIdentifier <String>] [-
ValidateOnly <S
     witchParameter>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Enable-UMMailbox cmdlet   enables Unified Messaging for an existing
mail-enabled Microsoft Exchange   Server 2010 user. When the mail-enabled
    user is enabled for Unified   Messaging, the settings from a UM mailbox
policy are applied to the user.   After the user is enabled for Unified Me
    ssaging, the user can use the UM features included with Exchange
2010.
    After this task is completed, the user is enabled for Unified
Messaging and can use the voice mail features included with Exchange
2010.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM m
    ailbox" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the user to enable for Unified
Messaging. The values for this parameter include the following:
        * ADObjectID
        * GUID
        * DN
        * Domain\Account
        * UPN
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -UMMailboxPolicy <MailboxPolicyIdParameter>
        The UMMailboxPolicy parameter specifies the name of the UM
mailbox policy to be associated with the user.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AutomaticSpeechRecognitionEnabled <$true | $false>
        The AutomaticSpeechRecognitionEnabled parameter enables Automatic
Speech Recognition (ASR) to be used with the UM mailbox. ASR is only ava
        ilable if the user's specified language preference is installed.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Extensions <MultiValuedProperty>
        The Extensions parameter specifies the extension number for the
user. Either a single extension number or an array of telephone number
ext
        ensions can be specified. The user's extension must be unique to
the UM dial plan. If this parameter isn't included, a default telephone n
        umber value from Active Directory is used. If you're enabling a
user for Unified Messaging using a Session Initiation Protocol (SIP)
Unifo
        rm Resource Identifier (URI) or E.164 dial plan, you must also
specify the SIPResourceIdentifier parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the distinguished name for the Identity
parameter. Other forms of identification, such as alias or GUID, aren't
accepte
          d.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -NotifyEmail <String>
        The NotifyEmail parameter specifies the e-mail address to which
the server sends the e-mail message that contains the Unified Messaging
we
        lcome information. By default, the message is sent to the SMTP
address of the enabled user.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -PilotNumber <String>
        The PilotNumber parameter specifies the subscriber access number
users can dial to gain access to their mailboxes. The default value is th
        e subscriber access number specified on a dial plan object in
Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -PIN <String>
         The PIN parameter specifies the value for the initial PIN to be
used with the UM mailbox. The PIN is checked against the UM mailbox
policy
          rules. The PIN value must be from 4 through 24 numeric
characters. If no PIN is specified, a PIN generated by the system is sent
to the u
         ser. The PIN generated by the system contains six numeric
characters, which is the default.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -PINExpired <$true | $false>
        The PINExpired parameter specifies whether the PIN is treated as
expired. If this parameter is supplied and is set to $false, users aren't
         required to reset their PIN the next time they log on. If the
PIN isn't supplied, the PIN is treated as expired and users are prompted
to
         reset their PIN the next time they log on.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SIPResourceIdentifier <String>
        The SIPResourceIdentifier parameter specifies the SIP address or
E.164 address for the user. This property is compared to the URI type tha
        t is defined on the UM dial plan.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ValidateOnly <SwitchParameter>
        The ValidateOnly switch tells the cmdlet to evaluate the
conditions and requirements necessary to perform the operation and then
reports w
        hether the operation will succeed or fail. No changes are made
when the ValidateOnly switch is used.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".
INPUTS
    @{Text=}



OUTPUTS
    @{Text=}



NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example enables Unified Messaging on the mailbox for
tonysmith@contoso.com, sets the extension and PIN for the user, and then
assigns a U
    M mailbox policy named MyUMMailboxPolicy to the user's mailbox.

    Enable-UMMailbox -Identity tonysmith@contoso.com -UMMailboxPolicy
MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -NotifyEmail
administrator@
    contoso.com -PINExpired $true




    -------------------------- EXAMPLE 2 --------------------------




    This example enables Unified Messaging on a SIP-enabled mailbox for
tonysmith@contoso.com, associates a UM mailbox policy named
MyUMMailboxPol
    icy, and sets the extension number, SIP resource identifier, and PIN
for the user.

    Enable-UMMailbox -Identity tonysmith@contoso.com -UMMailboxPolicy
MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -NotifyEmail
administrator@
    contoso.com -SIPResourceIdentifier "yan@contoso.com" -PINExpired
$true
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/5391a63c-
ca60-498c-8358-5f0667140738(EXCHG.141).aspx

NAME
       Export-MigrationReport

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    The Export-MigrationReport is used by the Microsoft Exchange
migration process to allow a tenant administrator of a cloud-based
Exchange organ
    ization to download a CSV file that contains e-mail migration errors.
This cmdlet is not run by an administrator in Windows PowerShell.

SYNTAX
    Export-MigrationReport [-Confirm [<SwitchParameter>]] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-
WhatIf [<SwitchPa
    rameter>]] [<CommonParameters>]

    Export-MigrationReport -Identity <MigrationReportIdParameter> -
CsvStream <Stream> [-Confirm [<SwitchParameter>]] [-DomainController
<Fqdn>] [-
    Organization <OrganizationIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    Export-MigrationReport -Identity <MigrationReportIdParameter> -
RowCount <Int32> -StartingRowIndex <Int32> [-Confirm [<SwitchParameter>]]
[-Dom
    ainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-
WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Export-MigrationReport is used by the Microsoft Exchange
migration process to allow a tenant administrator of a cloud-based
Exchange organ
    ization to download a CSV file that contains e-mail migration errors.
This cmdlet is not run by an administrator in Windows PowerShell.


PARAMETERS
    -CsvStream <Stream>
        This parameter is reserved for internal Microsoft use.

          Required?                 true
          Position?                 Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Identity <MigrationReportIdParameter>
           This parameter is reserved for internal Microsoft use.

          Required?                     true
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -RowCount <Int32>
           This parameter is reserved for internal Microsoft use.

          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -StartingRowIndex <Int32>
           This parameter is reserved for internal Microsoft use.

          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -DomainController <Fqdn>
           This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:


RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/92d506ae-
3de5-4a52-b4f8-a79ef94da4c7(EXCHG.141).aspx

NAME
       Export-UMCallDataRecord

SYNOPSIS
     Use the Export-UMCallDataRecord cmdlet to export Unified Messaging
(UM) call data records for UM dial plans and UM IP gateways for a date
that
      you've specified.

SYNTAX
    Export-UMCallDataRecord -ClientStream <Stream> -Date <ExDateTime> [-
Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Organization
<Or
    ganizationIdParameter>] [-UMDialPlan <UMDialPlanIdParameter>] [-
UMIPGateway <UMIPGatewayIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonPa
    rameters>]


DESCRIPTION
     The Export-UMCallDataRecord cmdlet exports Unified Messaging call
data records for a specified date to a comma separated value (CSV). You
can
     filter call data records for a specific UM dial plans and/or UM IP
gateways, however, if you don't specify a UM IP gateway, all call data
reco
     rds for will be returned.
     After this task is completed, a report is generated that contains
Unified Messaging call data records.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM c
     all data and summary reports" entry in the Unified Messaging
Permissions topic.


PARAMETERS
    -ClientStream <Stream>
        The ClientStream parameter specifies the .NET stream to use to
output for the Unified Messaging call data records.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Date <ExDateTime>
        The Date parameter specifies the date of Unified Messaging call
data records to retrieve, in the last 90 days. If there are no call
record
        s for the date specified, the report will be empty.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -UMDialPlan <UMDialPlanIdParameter>
        The UMDialPlan parameter specifies the UM dial plan to export
statistics for. If you don't specify a UM dial plan, statistics include
all
        UM dial plans in the organization

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -UMIPGateway <UMIPGatewayIdParameter>
        The UMIPGateway parameter specifies the UM IP gateway to export
statistics for. If you don't specify a gateway, statistics include all UM
        IP gateways in the selected UM dial plan, or if a UM dial plan
isn't selected, statistics include all UM IP gateways in the
organization.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    "Organizations of UMDialPlan {0} and UMIPGateway {1} do not
match."(Category: )
        This error message appears when the organization identity of the
UMIPGateway and UMDialPlan parameters don't match.

    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns all Unified Messaging call data records and
exports them to a CSV file.

    Export-UMCallDataRecord -Date 02/01/10




    -------------------------- EXAMPLE 2 --------------------------
    This example exports all Unified Messaging call data records for
February 1, 2010 for the UM dial plan MyUMDialPlan.

       Export-UMCallDataRecord -Date 02/01/10 -UMDialPlan MyUMDialPlan




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/974bfc60-
6c9c-4452-877b-3a302f39dd95(EXCHG.141).aspx

NAME
       Export-UMPrompt

SYNOPSIS
    Use the Export-UMPrompt cmdlet to export an audio file being used as
a greeting prompt for Unified Messaging (UM) dial plans and auto attendan
    ts.

SYNTAX
    Export-UMPrompt -BusinessHoursWelcomeGreeting <SwitchParameter> -
UMAutoAttendant <UMAutoAttendantIdParameter> [-Confirm
[<SwitchParameter>]] [
    -DomainController <Fqdn>] [-TestBusinessName <String>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]

    Export-UMPrompt -BusinessLocation <SwitchParameter> -UMAutoAttendant
<UMAutoAttendantIdParameter> [-Confirm [<SwitchParameter>]] [-DomainContr
    oller <Fqdn>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

    Export-UMPrompt -AfterHoursWelcomeGreeting <SwitchParameter> -
UMAutoAttendant <UMAutoAttendantIdParameter> [-Confirm
[<SwitchParameter>]] [-Do
    mainController <Fqdn>] [-TestBusinessName <String>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]

    Export-UMPrompt -AfterHoursWelcomeGreetingAndMenu <SwitchParameter> -
UMAutoAttendant <UMAutoAttendantIdParameter> [-Confirm [<SwitchParameter>
    ]] [-DomainController <Fqdn>] [-TestMenuKeyMapping
<CustomMenuKeyMapping[]>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    Export-UMPrompt -BusinessHours <SwitchParameter> -UMAutoAttendant
<UMAutoAttendantIdParameter> [-Confirm [<SwitchParameter>]] [-
DomainControll
    er <Fqdn>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
    Export-UMPrompt -BusinessHoursWelcomeGreetingAndMenu
<SwitchParameter> -UMAutoAttendant <UMAutoAttendantIdParameter> [-Confirm
[<SwitchParamet
    er>]] [-DomainController <Fqdn>] [-TestMenuKeyMapping
<CustomMenuKeyMapping[]>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    Export-UMPrompt -PromptFileName <String> -UMAutoAttendant
<UMAutoAttendantIdParameter> [-Confirm [<SwitchParameter>]] [-
DomainController <Fqdn
    >] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

    Export-UMPrompt -PromptFileName <String> -UMDialPlan
<UMDialPlanIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController
<Fqdn>] [-WhatI
    f [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Export-UMPrompt cmdlet exports prompts that belong to existing UM
dial plan and UM auto attendant objects. After the Export-UMPrompt cmdle
    t exports a prompt, you can save a copy of the prompt to a local
drive as an audio file. You can then play the audio file using a media
player
    .
    After this task is completed, the UM prompts are displayed or saved.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM m
    ailbox" entry in the Unified Messaging Permissions topic.


PARAMETERS
    - <>
         Description

        Required?
        Position?                     named
        Default value
        Accept pipeline input?
        Accept wildcard characters?   false

    -AfterHoursWelcomeGreeting <SwitchParameter>
        The AfterHoursWelcomeGreeting parameter specifies the system
generated, after hours welcome greeting for the UM auto attendant
specified.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -AfterHoursWelcomeGreetingAndMenu <SwitchParameter>
        The AfterHoursWelcomeGreetingAndMenu parameter specifies the
system- generated after hours welcome greeting and menu prompts for the
UM au
        to attendant specified.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -BusinessHours <SwitchParameter>
        The BusinessHours parameter specifies that the prompt to be
returned is the business hours prompt of the auto attendant.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -BusinessHoursWelcomeGreeting <SwitchParameter>
        The BusinessHoursWelcomeGreeting parameter specifies the system-
generated business hours welcome greeting for the UM auto attendant
specif
        ied.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -BusinessHoursWelcomeGreetingAndMenu <SwitchParameter>
        The BusinessHoursWelcomeGreetingAndMenu parameter specifies the
system-generated business hours welcome greeting and menu prompts for the
        UM auto attendant specified.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -BusinessLocation <SwitchParameter>
        The BusinessLocation parameter specifies the business location
greeting played for callers when the caller calls into a UM auto
attendant
        and specifies the business location.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -PromptFileName <String>
        The PromptFileName parameter specifies the name of the custom
prompt to export.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -UMAutoAttendant <UMAutoAttendantIdParameter>
        The UMAutoAttendant parameter specifies the UM auto attendant ID.
This parameter specifies the directory object identifier for the UM auto
         attendant.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -UMDialPlan <UMDialPlanIdParameter>
        The UMDialPlan parameter specifies the UM dial plan ID. This
parameter specifies the directory object identifier for the UM dial plan.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch can be used to suppress the confirmation
prompt that appears by default when this cmdlet is run. To suppress the
confir
        mation prompt, use the syntax -Confirm:$False. You must include a
colon ( : ) in the syntax.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -TestBusinessName <String>
        The TestBusinessName parameter specifies whether the business
name configured on a UM auto attendant or the business name specified by
thi
        s parameter is used to generate the welcome greeting prompt.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -TestMenuKeyMapping <CustomMenuKeyMapping[]>
        The TestMenuKeyMapping parameter specifies whether the existing
key mappings configured on a UM auto attendant or the key mapping menu
spe
        cified by this parameter is used to generate the welcome greeting
and menu.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS
NON-TERMINATING ERRORS
    Error(Category: )
        Description

    Type:
    Target Object Type:
    Suggested Action:

    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- Example 1 --------------------------




    This example exports the welcome greeting for the UM dial plan
MyUMDialPlan and saves it as the file welcomegreeting.mp3.

    $prompt = Export-UMPrompt -PromptFileName "customgreeting.mp3" -
UMDialPlan MyUMDialPlan
    set-content -Path "d:\DialPlanPrompts\welcomegreeting.mp3" -Value
$prompt.AudioData -Encoding Byte




    -------------------------- Example 2 --------------------------




    This example exports the business hours welcome greeting used for the
UM auto attendant MYUMAutoAttendant and saves it as the file BusinessHou
    rsWelcomeGreeting.mp3.

    $prompt = Export-UMPrompt -BusinessHoursWelcomeGreeting -
UMAutoAttendant MyUMAutoAttendant
    set-content -Path "d:\UMPrompts\BusinessHoursWelcomeGreeting.mp3" -
Value $prompt.AudioData -Encoding Byte




    -------------------------- Example 3 --------------------------
    This example exports a custom greeting for the UM auto attendant
MyUMAutoAttendant and saves it to the file welcomegreetingbackup.mp3.

    Export-UMPrompt -PromptFileName "welcomegreeting.mp3" -
UMAutoAttendant MyUMAutoAttendant
    set-content -Path "e:\UMPromptsBackup\welcomegreetingbackup.mp3" -
Value $prompt.AudioData -Encoding Byte




       -------------------------- Example 4 --------------------------




    This example exports the after hours welcome greeting for the UM auto
attendant MyUMAutoAttendant, saves it as the file AfterHoursWelcomeGreet
    ing.mp3, and uses Northwind Traders as the test business name.

    Export-UMPrompt -AfterHoursWelcomeGreeting -UMAutoAttendant
MyUMAutoAttendant -TestBusinessName "Northwind Traders"
    set-content -Path "d:\ AfterHoursWelcomeGreeting.mp3" -Value
$prompt.AudioData -Encoding Byte




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/4bf35665-
1643-4fec-bdb5-3aa27ff9984f(EXCHG.141).aspx

F:

G:

NAME
       Get-AcceptedDomain

SYNOPSIS
    Use the Get-AcceptedDomain cmdlet to view the configuration
information for the accepted domains configured in your organization.

SYNTAX
    Get-AcceptedDomain [-Identity <AcceptedDomainIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>]
[<CommonParame
    ters>]
DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Acce
    pted domains" entry in the Transport Permissions topic.


PARAMETERS
     -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory. The DomainController parameter isn't supported on the
Edge Transport server role. The Edge Transport server role reads only
from
          the Active Directory Lightweight Directory Services (AD LDS)
instance.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <AcceptedDomainIdParameter>
        The Identity parameter specifies a string value for the accepted
domain. Enter either the GUID or the name of the accepted domain.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   true

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS
OUTPUTS

       -------------------------- EXAMPLE 1 --------------------------




       This example lists all the accepted domains in your organization.

       Get-AcceptedDomain




       -------------------------- EXAMPLE 2 --------------------------




    This example lists all the authoritative accepted domains in your
organization.

       Get-AcceptedDomain | Where{$_.DomainType -eq 'Authoritative'}




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/e0c2366a-
eda9-4152-bd3e-3a2d1953562d(EXCHG.141).aspx

NAME
       Get-ActiveSyncDevice

SYNOPSIS
    Use the Get-ActiveSyncDevice cmdlet to retrieve the list of devices
in your organization that have active Microsoft Exchange ActiveSync
partne
    rships.

SYNTAX
    Get-ActiveSyncDevice [-Identity <ActiveSyncDeviceIdParameter>] [-
DomainController <Fqdn>] [-Filter <String>] [-Organization
<OrganizationIdPar
    ameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]

    Get-ActiveSyncDevice -Mailbox <MailboxIdParameter> [-DomainController
<Fqdn>] [-Filter <String>] [-Organization <OrganizationIdParameter>] [-O
    rganizationalUnit <OrganizationalUnitIdParameter>] [-ResultSize
<Unlimited>] [-SortBy <String>] [<CommonParameters>]
DESCRIPTION
    The Get-ActiveSyncDevice cmdlet returns identification,
configuration, and status information for each device.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Exch
    ange ActiveSync user settings" entry in the Client Access Permissions
topic.


PARAMETERS
    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the user whose Exchange
ActiveSync devices you want to retrieve.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter specifies a set of attributes used to filter
the list of returned devices.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <ActiveSyncDeviceIdParameter>
        The Identity parameter specifies the device to retrieve. It can
be one of the following values used to identify a device in Active
Directo
        ry:
        * GUID
        * DeviceIdentity
          * Multi-TenantID

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies the organizational
unit (OU) where the task is run.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -SortBy <String>
           The SortBy parameter specifies the attribute to sort by.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS
OUTPUTS

       -------------------------- EXAMPLE 1 --------------------------




    This example returns all of the Exchange ActiveSync devices that Tony
Smith has used that are associated with his mailbox.

       Get-ActiveSyncDevice -Identity "TonySmith"




       -------------------------- EXAMPLE 2 --------------------------




    This example returns all of the Exchange ActiveSync devices that Tony
Smith has used that are associated with his mailbox.

       Get-ActiveSyncDevice -Mailbox "Redmond\TonySmith"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/06a82fdc-
9bf7-43c7-8471-d977034d3560(EXCHG.141).aspx

NAME
       Get-ActiveSyncDeviceAccessRule

SYNOPSIS
    Use the Get-ActiveSyncDeviceAccessRule cmdlet to retrieve an access
group of Exchange mobile devices along with their access level.

SYNTAX
    Get-ActiveSyncDeviceAccessRule [-Identity
<ActiveSyncDeviceAccessRuleIdParameter>] [-DomainController <Fqdn>] [-
Organization <OrganizationIdPa
    rameter>] [<CommonParameters>]


DESCRIPTION
    You can create multiple groups of devices: allowed devices, blocked
devices, and quarantined devices with the New-ActiveSyncDeviceAccessRule
c
    mdlet. The Get-ActiveSyncDeviceAccessRule cmdlet retrieves the
settings for any existing group.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Exch
    ange ActiveSync settings" entry in the Client Access Permissions
topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <ActiveSyncDeviceAccessRuleIdParameter>
        The Identity parameter specifies the unique identifier for the
device access rule.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS
NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example lists all the rules currently blocking mobile phones.

       Get-ActiveSyncDeviceAccessRule | where {$_.AccessLevel -eq 'Block'}




       -------------------------- EXAMPLE 2 --------------------------




       This example lists all device access rules set up on the server.

    Get-ActiveSyncDeviceAccessRule | Format-List Characteristic,
QueryString, AccessLevel




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/f9bcb8d8-
1239-43b8-9885-b655cbe8b4bc(EXCHG.141).aspx

NAME
       Get-ActiveSyncDeviceClass

SYNOPSIS
    Use the Get-ActiveSyncDeviceClass cmdlet to retrieve a list of mobile
phones or devices that have connected to the servers running Microsoft E
    xchange Server 2010 in an organization. The cmdlet returns the mobile
phone or device type and model information.

SYNTAX
    Get-ActiveSyncDeviceClass [-Identity
<ActiveSyncDeviceClassIdParameter>] [-DomainController <Fqdn>] [-Filter
<String>] [-Organization <Organiz
    ationIdParameter>] [-SortBy <String>] [<CommonParameters>]
DESCRIPTION
    You can use this cmdlet to view a list of mobile phones or devices by
type. For example, you can return a list of all Apple iPhone mobile digi
    tal devices in the organization or all Windows Mobile devices with
the DeviceType of PocketPC.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Exch
    ange ActiveSync settings" entry in the Client Access Permissions
topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter specifies the attribute by which to filter
the data. The following attributes are supported:
        * DeviceType
        * DeviceModel

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <ActiveSyncDeviceClassIdParameter>
        The Identity parameter specifies the group of devices on which to
scope the task.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. You can sort by t
        he following attributes:
        * DeviceType
        * DeviceModel
        The results are sorted in ascending order.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns a list of all devices with the DeviceType of
PocketPC.

    Get-ActiveSyncDeviceClass -Filter {DeviceType -eq "PocketPC"}




    -------------------------- EXAMPLE 2 --------------------------
    This example lists all device types within the organization along
with a count of the number of devices of each type present.

       Get-ActiveSyncDeviceClass | group-object -property DeviceType




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/f87f0260-
b1f3-4315-b71b-e381bd0ebc15(EXCHG.141).aspx

NAME
       Get-ActiveSyncDeviceStatistics

SYNOPSIS
    Use the Get-ActiveSyncDeviceStatistics cmdlet to retrieve the list of
mobile phones configured to synchronize with a specified user's mailbox
    and return a list of statistics about the mobile phones.

SYNTAX
    Get-ActiveSyncDeviceStatistics -Identity
<ActiveSyncDeviceIdParameter> [-DomainController <Fqdn>] [-GetMailboxLog
<SwitchParameter>] [-Notific
    ationEmailAddresses <MultiValuedProperty>] [-ShowRecoveryPassword
<SwitchParameter>] [<CommonParameters>]

    Get-ActiveSyncDeviceStatistics -Mailbox <MailboxIdParameter> [-
DomainController <Fqdn>] [-GetMailboxLog <SwitchParameter>] [-
NotificationEmail
    Addresses <MultiValuedProperty>] [-ShowRecoveryPassword
<SwitchParameter>] [<CommonParameters>]


DESCRIPTION
    The Get-ActiveSyncDeviceStatistics cmdlet returns a list of
statistics about each mobile phone. Additionally, it allows you to
retrieve logs a
    nd send those logs to a recipient for troubleshooting purposes.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Exch
    ange ActiveSync user settings" entry in the Client Access Permissions
topic.
PARAMETERS
    -Identity <ActiveSyncDeviceIdParameter>
        The Identity parameter specifies the user's device ID. If the
Mailbox parameter is specified, the Identity parameter is disabled.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the user mailbox for which you
want to retrieve the mobile phone statistics.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -GetMailboxLog <SwitchParameter>
        The GetMailboxLog parameter specifies whether to send the mailbox
logs via e-mail to the administrator running the task. If the parameter
        is set to $true, the command sends the mailbox logs via e-mail to
the administrator running the task. The default value of this parameter
        is $false.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -NotificationEmailAddresses <MultiValuedProperty>
         The NotificationEmailAddresses parameter specifies an optional
list of comma-separated aliases or e-mail addresses where the mailbox
logs
         are sent. If the GetMailboxLog parameter is set to $false, this
parameter is ignored.

        Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -ShowRecoveryPassword <SwitchParameter>
         The ShowRecoveryPassword parameter specifies whether to return
the recovery password for the mobile phone as one of the displayed
statisti
         cs. If this parameter is set to $true, the command returns the
recovery password for the mobile phone as one of the displayed
statistics.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS
    @{Text=FirstSyncTime}
        The date on which the mobile phone first synchronized with the
user's mailbox.

    @{Text=LastPingHeartbeat}
        The length of the last heartbeat interval.

    @{Text=LastPolicyUpdateTime}
        The time at which the mobile phone was last successfully updated.

    @{Text=LastPolicyUpdateRequestTime}
        The last time the mobile phone requested a policy update from the
server.

    @{Text=LastSyncAttemptTime}
        The last time the mobile phone tried to synchronize with the
user's mailbox.

    @{Text=LastSuccessSync}
        The last time the mobile phone successfully synchronized with the
user's mailbox.

    @{Text=LastSyncResponseStatus}
        The last status code sent to the mobile phone during the most
recent synchronization.
    @{Text=DeviceFriendlyName}
        The display name of the partnership configured on the mobile
phone. After the display name is configured, the mobile phone stores this
nam
        e in the user's mailbox.

    @{Text=DeviceId}
        The string ID of the mobile phone stored in the user's mailbox.

    @{Text=DeviceModel}
        The model of the mobile phone. This information is stored in the
user's mailbox.

    @{Text=DeviceOperatorNetwork}
        The mobile operator being used by the mobile phone. The mobile
phone stores this information in the user's mailbox.

    @{Text=DeviceOSAgent}
        The client operating system running on the mobile phone. The
mobile phone stores this information in the user's mailbox.

    @{Text=DeviceOSLanguage}
        The language of the operating system on the mobile phone.

    @{Text=LastPingHeartbeat}
        The length of time that has elapsed since the last response from
the mobile phone, also known as a heartbeat, was received.

    @{Text=DeviceWipeSentTime}
        The time at which the last device wipe command was sent from the
server.

    @{Text=DeviceWipeRequestTime}
        The time at which the RemoteWipe setting was enabled on the
mobile phone.

    @{Text=DeviceWipeAckTime}
        The time at which the server received the last wipe
acknowledgement sent by the client.

    @{Text=RecoveryPassword}
        The recovery password for the mobile phone.


TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )
    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the statistics for the mobile phone configured
to synchronize with the mailbox that belongs to the user Tony Smith.

    Get-ActiveSyncDeviceStatistics -Identity TonySmith




    -------------------------- EXAMPLE 2 --------------------------




    This example uses the Get-CASMailbox cmdlet to determine who in the
organization has a Microsoft Exchange ActiveSync device. For each device,
    the Exchange ActiveSync device statistics are retrieved.

    Get-CASMailbox -Filter {hasactivesyncdevicepartnership -eq $true -and
-not displayname -like "CAS_{*"} | Get-Mailbox | foreach { Get-ActiveSy
    ncDeviceStatistics -Mailbox $_}




    -------------------------- EXAMPLE 3 --------------------------




    This example retrieves the statistics for the mobile phone configured
to synchronize with the mailbox that belongs to the user Tony Smith. It
    also outputs the Exchange ActiveSync log file and sends it to the
System Administrator at admin@contoso.com.

    Get-ActiveSyncDeviceStatistics -Mailbox TonySmith -GetMailboxLog
$true -NotificationEmailAddresses "admin@contoso.com"
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2b6160ef-
ab82-49e7-a5be-fd7cae92dabb(EXCHG.141).aspx

NAME
       Get-ActiveSyncMailboxPolicy

SYNOPSIS
    Use the Get-ActiveSyncMailboxPolicy cmdlet to retrieve the policy
settings for a computer running Microsoft Exchange Server 2010 that has
the
    Client Access server role installed.

SYNTAX
    get-ActiveSyncMailboxPolicy [-Identity <MailboxPolicyIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [<Comm
    onParameters>]


DESCRIPTION
    A Microsoft Exchange ActiveSync mailbox policy is a group of settings
that specifies how mobile phones enabled for Exchange ActiveSync connect
     to the computer running Exchange. Exchange supports multiple
Exchange ActiveSync mailbox policies. The Get-ActiveSyncMailboxPolicy
cmdlet dis
    plays all the policy settings for the specified server. These
settings include password settings, file access settings, and attachment
setting
    s.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Exch
    ange ActiveSync mailbox policy settings" entry in the Client Access
Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Identity <MailboxPolicyIdParameter>
           The Identity parameter specifies the policy name.
          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example returns the policy settings for the Exchange ActiveSync
mailbox policy named SalesPolicy.

       Get-ActiveSyncMailboxPolicy -Identity "SalesPolicy"
       -------------------------- EXAMPLE 2 --------------------------




    This example returns the policy settings for the Exchange ActiveSync
mailbox policy named Default.

       Get-ActiveSyncMailboxPolicy -Identity "Default"




       -------------------------- EXAMPLE 3 --------------------------




    This example returns the policy settings for the Exchange ActiveSync
mailbox policy named Management.

       Get-ActiveSyncMailboxPolicy -Identity "Management"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/deffb9df-
6326-44dc-862b-424085d14d00(EXCHG.141).aspx

NAME
       Get-ActiveSyncOrganizationSettings

SYNOPSIS
    Use the Get-ActiveSyncOrganizationSettings cmdlet to retrieve the
Microsoft Exchange ActiveSync settings for your Microsoft Exchange Server
20
    10 organization.

SYNTAX
    Get-ActiveSyncOrganizationSettings [-Identity
<ActiveSyncOrganizationSettingsIdParameter>] [-DomainController <Fqdn>]
[-Organization <Organiza
    tionIdParameter>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Exch
    ange ActiveSync settings" entry in the Client Access Permissions
topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <ActiveSyncOrganizationSettingsIdParameter>
        The Identity parameter specifies the unique identifier for the
Exchange organization.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )
       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the Exchange ActiveSync organization settings
for the domain Contoso.com.

       Get-ActiveSyncOrganizationSettings -Contoso.com




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/a7f7f110-
4951-4c9b-8373-cf6a1d1ff426(EXCHG.141).aspx

NAME
       Get-AdminAuditLogConfig

SYNOPSIS
    Use the Get-AdminAuditLogConfig cmdlet to view the administrator
audit logging configuration settings.

SYNTAX
    Get-AdminAuditLogConfig [-Identity <OrganizationIdParameter>] [-
DomainController <Fqdn>] [<CommonParameters>]


DESCRIPTION
    When audit logging is enabled, a log entry is created for each cmdlet
that's run, excluding Get cmdlets. For more information about administra
    tor audit logging, see Administrator Audit Logging.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Admi
    nistrator audit logging" entry in the Exchange and Shell
Infrastructure Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <OrganizationIdParameter>
        The Identity parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example displays the administrator audit logging settings. The
output of the Get-AdminAudigLogConfig cmdlet is piped to the Format-List
c
    mdlet. For more information about piping and the Format-List cmdlet,
see the following topics:

    Pipelining
    Working with Command Output

    Get-AdminAuditLogConfig | Format-List
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/775f7985-
19f0-4681-afef-ac1db324784e(EXCHG.141).aspx

NAME
       Get-CalendarNotification

SYNOPSIS
    Use the Get-CalendarNotification cmdlet to return a list of all
calendar notification settings for a user.

SYNTAX
    Get-CalendarNotification -Identity <MailboxIdParameter> [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-ReadFromDomainController <Sw
    itchParameter>] [-ResultSize <Unlimited>] [<CommonParameters>]


DESCRIPTION
    The Get-CalendarNotification cmdlet retrieves and then displays the
rules used to trigger the calendar agenda notification, reminder
notificat
    ion, or update notification.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Text
     messaging settings" entry in the Client Access Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
         The Identity parameter specifies the mailbox ID for the user's
mailbox.

          Required?                     true
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user credentials used to
run the command.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies whether the
command should return data from the domain controller.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the amount of data returned.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
    This example returns the calendar notification settings for the user
Tony Smith using the user's alias.

       Get-CalendarNotification -Identity "TonySmith"




       -------------------------- EXAMPLE 2 --------------------------




    This example returns the calendar notification settings for the user
Tony Smith.

    Get-CalendarNotification -Identity tony@contoso.com -
ReadFromDomainController




       -------------------------- EXAMPLE 3 --------------------------




    This example returns the calendar notification settings for the user
Tony Smith using the user's domain and name.

       Get-CalendarNotification -Identity "contoso\tonysmith"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/62a20bc1-
1e3c-43c5-8a33-94781e24baed(EXCHG.141).aspx

NAME
       Get-CalendarProcessing

SYNOPSIS
    Use the Get-CalendarProcessing cmdlet to retrieve the Calendar
Attendant configuration on the target mailbox.

SYNTAX
    Get-CalendarProcessing -Identity <MailboxIdParameter> [-
DomainController <Fqdn>] [-ReadFromDomainController <SwitchParameter>] [-
ResultSize <U
    nlimited>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Cale
    ndar processing" entry in the Mailbox Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the user account. You can use
the following values:
        * GUID
        * ADObjectID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest,
and if you don't use this parameter, it's possible that the user
informati
        on is read from a global catalog with outdated information. If
you use this parameter, multiple reads might be necessary to get the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your Exchange servers.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of
mailboxes to display settings for.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- Example 1 --------------------------




    This example retrieves the Calendar Attendant configuration for the
user Andrea and formats the list.

       Get-CalendarProcessing -Identity andrea@alpineskihouse.com | Format-
List
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/8ffece5d-
acc9-4061-822e-e452479c03e9(EXCHG.141).aspx

NAME
       Get-CASMailbox

SYNOPSIS
    Use the Get-CASMailbox cmdlet to return a complete list of the
attributes of a Microsoft Exchange Server 2010 mailbox on a computer that
has t
    he Client Access server role installed.

SYNTAX
     Get-CASMailbox [-Identity <MailboxIdParameter>] [-
ActiveSyncDebugLogging <SwitchParameter>] [-Credential <PSCredential>] [-
DomainController <F
     qdn>] [-Filter <String>] [-GetImapProtocolLog <SwitchParameter>] [-
GetPopProtocolLog <SwitchParameter>] [-IgnoreDefaultScope
<SwitchParameter>
     ] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ProtocolSettings <SwitchParameter>] [-
Read
     FromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-
SendLogsTo <MultiValuedProperty>] [-SortBy <String>] [<CommonParameters>]

    Get-CASMailbox [-ActiveSyncDebugLogging <SwitchParameter>] [-Anr
<String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-
Filter <S
    tring>] [-GetImapProtocolLog <SwitchParameter>] [-GetPopProtocolLog
<SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization
    <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ProtocolSettings <SwitchParameter>] [-
ReadFromDomainControl
    ler <SwitchParameter>] [-ResultSize <Unlimited>] [-SendLogsTo
<MultiValuedProperty>] [-SortBy <String>] [<CommonParameters>]


DESCRIPTION
    A variety of CASMailbox attributes are returned. The types of
attributes returned include Microsoft Office Outlook Web App, Exchange
ActiveSyn
    c, POP3, and IMAP4.
    By default, all attributes are returned for all mailboxes in the
Exchange organization. You can filter these results by using the
functionalit
    y in the Exchange Management Shell.
    The Get-CASMailbox cmdlet can run only on an Exchange computer that
has the Mailbox server role installed.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Clie
    nt Access user settings" entry in the Client Access Permissions
topic.


PARAMETERS
    -ActiveSyncDebugLogging <SwitchParameter>
        The ActiveSyncDebugLogging parameter specifies whether logging is
enabled for Microsoft Exchange ActiveSync for the mailbox.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the account to use to read
from Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -GetImapProtocolLog <SwitchParameter>
        The GetImapProtocolLog parameter specifies whether to retrieve
the IMAP protocol log.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -GetPopProtocolLog <SwitchParameter>
        The GetPopProtocolLog parameter specifies whether to retrieve the
POP protocol log.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxIdParameter>
        The Identity parameter specifies the mailbox ID. You can use the
following values:
        * GUID
        * Distinguished name (DN)
        * User principal name (UPN)
        * SMTP address
        * Alias

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter limits the search to a specific
container.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ProtocolSettings <SwitchParameter>
        The ProtocolSetting parameter returns the POP3, IMAP4, and SMTP
server names for the mailbox.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
h
        ave set the recipient scope to include all recipients in the
forest and you don't use this parameter, the user information may be read
fro
        m a global catalog server whose information is outdated. If you
use this parameter, multiple reads may be necessary to retrieve the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your servers that run Exchange.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. The default value is 1000.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -SendLogsTo <MultiValuedProperty>
        The SendLogsTo parameter specifies an address to receive the log
files.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute used to sort the
results. The results are sorted in ascending order.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS
OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns all Client Access server mailbox details for the
user Jeff Hay in the Contoso domain.

    Get-CASMailbox -Identity jeffhay@contoso.com




    -------------------------- EXAMPLE 2 --------------------------




    This example returns all Client Access server mailbox details for the
user Tony Smith in the Contoso domain.

    Get-CASMailbox -Identity contoso\tonysmith




    -------------------------- EXAMPLE 3 --------------------------




    This example returns all Client Access server mailbox details for the
user Tony Smith in the fourthcoffee domain.
       Get-CASMailbox -Identity fourthcoffee\tonysmith




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/d80a5990-
9106-4eb8-bba8-b3975805c325(EXCHG.141).aspx

NAME
       Get-CASMailboxPlan

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-CASMailboxPlan cmdlet to view information about the
Client Access server mailbox plans in the organization.

SYNTAX
    Get-CASMailboxPlan [-Identity <MailboxPlanIdParameter>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDef
    aultScope <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainC
    ontroller <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy
<String>] [<CommonParameters>]


DESCRIPTION
    The Client Access server mailbox plan controls settings related to
client access for the organization, such as POP, IMAP and MAPI client
acces
    s settings.


PARAMETERS
    -Organization <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password for
viewing the object. The default is the current user's credentials.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter syntax used to
filter the results.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxPlanIdParameter>
        The Identity parameter specifies the Client Access server mailbox
plan. Typically, the name of the Client Access server mailbox plan is th
        e same as the mailbox plan, for example, DefaultMailboxPlan.
        You can use any value that uniquely identifies the Client Access
server mailbox plan, for example:
        * Distinguished name (DN)
        * Name
        * Display Name
        * GUID

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:

        Required?                     false
        Position?                     Named
        Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
         The ResultSize parameter specifies the total number of items to
display.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. You can sort by t
        he following attributes:
        * Display name
        * Name
        The results are sorted in ascending order.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS
NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example lists all the Client Access server mailbox plans in the
organization.

       Get-CASMailboxPlan




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/bdf86f79-
36ca-4360-acf2-4c418785dee0(EXCHG.141).aspx

NAME
       Get-Contact

SYNOPSIS
    Use the Get-Contact cmdlet to retrieve information on a specified
contact or contacts.

SYNTAX
    Get-Contact [-Identity <ContactIdParameter>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-
IgnoreDefaultScope <
    SwitchParameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainController <
    SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-
ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]

    Get-Contact [-Anr <String>] [-Credential <PSCredential>] [-
DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope
<SwitchParameter>]
     [-Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>]
     [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize
<Unlimited>] [-SortBy <String>] [<CommonParameters>]
DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
    pient Provisioning Permissions" section in the Mailbox Permissions
topic.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
access Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <ContactIdParameter>
        The Identity parameter specifies the contact. You can use the
following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SMTP address
        * Alias

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Organization <OrganizationIdParameter>
        The Organization parameter is reserved for internal Microsoft
use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter returns objects only from the
specified organizational unit (OU).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest,
and if you don't use this parameter, it's possible that the user
informati
        on is read from a global catalog with outdated information. If
you use this parameter, multiple reads might be necessary to get the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your Exchange servers.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientTypeDetails <RecipientTypeDetails[]>
        The RecipientTypeDetails parameter specifies the type of
recipients returned. Recipient types are divided into recipient types and
subtype
        s. Each recipient type contains all common properties for all
subtypes. For example, the type UserMailbox represents a user account in
Act
        ive Directory that has an associated mailbox. Because there are
several mailbox types, each mailbox type is identified by the
RecipientTyp
        eDetails parameter. For example, a conference room mailbox has
RecipientTypeDetails set to ConferenceRoomMailbox, whereas a user mailbox
h
        as RecipientTypeDetails set to UserMailbox.
        You can select from the following values:
        *   ArbitrationMailbox
        *   ConferenceRoomMailbox
        *   Contact
        *   DiscoveryMailbox
        *   DynamicDistributionGroup
        *   EquipmentMailbox
        *   ExternalManagedContact
        *   ExternalManagedDistributionGroup
        *   LegacyMailbox
        *   LinkedMailbox
        *   MailboxPlan
        *   MailContact
        *   MailForestContact
        *   MailNonUniversalGroup
        *   MailUniversalDistributionGroup
        *   MailUniversalSecurityGroup
        *   MailUser
        *   PublicFolder
        *   RoleGroup
        *   RoomList
        *   RoomMailbox
        *   SharedMailbox
        *   SystemAttendantMailbox
        *   SystemMailbox
        *   User
        *   UserMailbox

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies to sort by a single attribute in
ascending order.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
          This cmdlet supports the common parameters: Verbose, Debug,
          ErrorAction, ErrorVariable, WarningAction, WarningVariable,
          OutBuffer and OutVariable. For more information, type,
          "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the contact Markus Breyer using the Identity
parameter and pipelines the object to the Format-List command to display
t
    he information about the contact.

    Get-Contact -Identity MarkusBreyer | Format-List




    -------------------------- EXAMPLE 2 --------------------------




    This example uses the Anr parameter to retrieve all mail-enabled
contacts whose names start with Markus.

    Get-Contact -Anr Markus* -RecipientTypeDetails MailContact
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/59315afb-
fab5-4984-b3a1-ba1f82df8a10(EXCHG.141).aspx

NAME
       Get-DistributionGroup

SYNOPSIS
    Use the Get-DistributionGroup cmdlet to query for existing
distribution groups.

SYNTAX
    Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-
Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>]
[-
    IgnoreDefaultScope <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFr
    omDomainController <SwitchParameter>] [-RecipientTypeDetails
<RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<CommonPa
    rameters>]

    Get-DistributionGroup [-Credential <PSCredential>] [-DomainController
<Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Man
    agedBy <GeneralRecipientIdParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFr
    omDomainController <SwitchParameter>] [-RecipientTypeDetails
<RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<CommonPa
    rameters>]

    Get-DistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-
DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchP
    arameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainController <SwitchP
    arameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-
ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]


DESCRIPTION
     You can use distribution groups to create e-mail distribution lists
and security groups to assign permissions to shared resources.
Distributio
     n groups can be used only with e-mail applications to send e-mail
messages to collections of users. You can use the Get-DistributionGroup
cmdl
     et to query for existing distribution groups.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Dist
    ribution groups" entry in the Mailbox Permissions topic.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password for
accessing Active Directory. The default is the current user's credential
        s.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <DistributionGroupIdParameter>
        The Identity parameter specifies the distribution group. You can
use one of the following values:
        * GUID
        * Distinguished name (DN)
        * LegacyExchangeDN
        * Domain\Account Name
        * Alias

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ManagedBy <GeneralRecipientIdParameter>
        The ManagedBy parameter indicates the DN of the user or contact
that manages the group.

        Required?                     false
        Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter limits results to a specific
organizational unit (OU) container.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest,
and if you don't use this parameter, it's possible that the user
informati
        on is read from a global catalog with outdated information. If
you use this parameter, multiple reads might be necessary to get the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your Exchange servers.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -RecipientTypeDetails <RecipientTypeDetails[]>
           * You can select from the following values:

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -ResultSize <Unlimited>
        The ResultSize parameter indicates the maximum number of
recipient objects returned.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SortBy <String>
         The SortBy parameter specifies the attribute used to sort the
results.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the group Marketing Reports and pipelines the
object to the Format-List command to display the information about the di
    stribution group.
       Get-DistributionGroup -Identity "Marketing Reports" | Format-List




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves all distribution groups whose names begin with
the string "Marketing" and pipelines the object to the Format-Table comm
    and to display the distribution group names and who they're managed
by.

       Get-DistributionGroup -Anr marketing | Format-Table Name, ManagedBy




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/d84f5670-
f3ac-4d63-a6ac-af9de67677c5(EXCHG.141).aspx

NAME
       Get-DistributionGroupMember

SYNOPSIS
    Use the Get-DistributionGroupMember cmdlet to find existing
distribution group members.

SYNTAX
    Get-DistributionGroupMember -Identity
<DistributionGroupMemberIdParameter> [-Credential <PSCredential>] [-
DomainController <Fqdn>] [-IgnoreDef
    aultScope <SwitchParameter>] [-ReadFromDomainController
<SwitchParameter>] [-ResultSize <Unlimited>] [<CommonParameters>]


DESCRIPTION
     If your organization has multiple Active Directory domains, you may
need to run the Set-ADServerSettings cmdlet with the ViewEntireForest
para
     meter set to $true before running the Get-DistributionGroupMember
cmdlet to view the entire forest. For more information, see "EXAMPLE 2"
late
     r in this topic.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Dist
    ribution groups" entry in the Mailbox Permissions topic.


PARAMETERS
    -Identity <DistributionGroupMemberIdParameter>
        The Identity parameter specifies the identity of the distribution
group. You can use one of the following values:
        * GUID
        * Distinguished name (DN)
        * User principal name (UPN)
        * LegacyExchangeDN
        * Domain\Account name
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the Credential parameter.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest,
and if you don't use this parameter, it's possible that the user
informati
        on is read from a global catalog with outdated information. If
you use this parameter, multiple reads might be necessary to get the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your Exchange servers.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of members
returned.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS
OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns the existing distribution group members for the
distribution group Marketing USA.

    Get-DistributionGroupMember -Identity "Marketing USA"




    -------------------------- EXAMPLE 2 --------------------------




    This example sets the scope of the search to the entire forest by
running the Set-ADServerSettings cmdlet, and then the Get-
DistributionGroupM
    ember cmdlet searches the entire forest for the distribution group
members in the Marketing Worldwide distribution group.

    Set-ADServerSettings -ViewEntireForest $true
    Get-DistributionGroupMember -Identity "Marketing Worldwide"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/15c71bc5-
4246-44ac-8b34-8ccd585294b5(EXCHG.141).aspx

NAME
       Get-DynamicDistributionGroup

SYNOPSIS
    Use the Get-DynamicDistributionGroup cmdlet to retrieve the settings
on an existing dynamic distribution group.

SYNTAX
    Get-DynamicDistributionGroup [-Identity <DynamicGroupIdParameter>] [-
Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>]
    [-IgnoreDefaultScope <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-Read
    FromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-
SortBy <String>] [<CommonParameters>]

    Get-DynamicDistributionGroup [-Credential <PSCredential>] [-
DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope
<SwitchParameter>
    ] [-ManagedBy <GeneralRecipientIdParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [
    -ReadFromDomainController <SwitchParameter>] [-ResultSize
<Unlimited>] [-SortBy <String>] [<CommonParameters>]

    Get-DynamicDistributionGroup [-Anr <String>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-
IgnoreDefaultScope <
    SwitchParameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainController <
    SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<CommonParameters>]


DESCRIPTION
    You can use distribution groups to create e-mail distribution lists
and security groups to assign permissions to shared resources.
Distributio
    n groups can be used only with e-mail applications (such as Microsoft
Exchange) to send e-mail messages to collections of users. You can use t
    he Get-DynamicDistributionGroup cmdlet to retrieve the settings on an
existing dynamic distribution group in Active Directory.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Dyna
    mic distribution groups" entry in the Mailbox Permissions topic.
PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory. The DomainController parameter isn't supported on the
Edge Transport server role. The Edge Transport server role reads only
from
          the Active Directory Lightweight Directory Services (AD LDS)
instance.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <DynamicGroupIdParameter>
        The Identity parameter specifies the dynamic distribution group.
You can use one of the following values:
        * GUID
        * Distinguished name (DN)
        * User principal name (UPN)
        * LegacyExchangeDN
        * Domain\Account name
        * Alias
        * Primary SMTP address

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ManagedBy <GeneralRecipientIdParameter>
        The ManagedBy parameter specifies the name of the mailbox user,
mail-enabled group, or mail-enabled contact that appears in the Managed
by
         tab of the Active Directory object. You can use any of the
following values for this parameter:
        * DN
        * Canonical name
          *   GUID
          *   Name
          *   Display name
          *   Legacy Exchange DN
          *   Primary SMTP e-mail address

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter limits results to a specific
organizational unit (OU) container.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest
and don't use this parameter, it's possible that the user information is
re
        ad from a global catalog with outdated information. If you use
this parameter, multiple reads might be necessary to get the information.
        By default, the recipient scope is set to the domain that hosts
your servers that run Exchange.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of
recipient objects returned.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter is used to sort the results.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the dynamic distribution group Marketing and
pipelines the object to the Format-List command to display the
information
     about the dynamic distribution group.

    Get-DynamicDistributionGroup -Identity "Marketing" | Format-List
       -------------------------- EXAMPLE 2 --------------------------




     This example retrieves all dynamic distribution groups that begin
with the string "Research" and pipelines the object to the Format-Table
comm
     and to display the dynamic distribution group names and who they're
managed by.

    Get-DynamicDistributionGroup -Anr research | Format-Table Name,
ManagedBy




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/d97ee738-
dfa1-464b-855a-4242e8065473(EXCHG.141).aspx

NAME
       Get-FailedContentIndexDocuments

SYNOPSIS
    Use the Get-FailedContentIndexDocuments cmdlet to retrieve a list of
documents for a mailbox, mailbox database, or Mailbox server that couldn'
    t be indexed by Exchange Search.

SYNTAX
    Get-FailedContentIndexDocuments -Identity <MailboxIdParameter> [-
Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf
[<SwitchPara
    meter>]] [<CommonParameters>]

    Get-FailedContentIndexDocuments -Server <ServerIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParamet
    er>]] [<CommonParameters>]

    Get-FailedContentIndexDocuments -MailboxDatabase
<DatabaseIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController
<Fqdn>] [-WhatIf [<Sw
    itchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Get-FailedContentIndexDocuments cmdlet returns a list of
documents that couldn't be indexed. The most common reason is that there
was no f
     ilter available for that document type or there was an attachment
within the document. For example, the PDF filter isn't available by
default.
      If an e-mail message contains a PDF document, because there is no
PDF filter, the document is marked as failed content indexing.
     After a new filter is installed, only new messages with attachments
of the type for which the filter is installed are indexed. If you want to
     index older messages for the document type, the mailbox has to be
moved.
     The cmdlet output provides details about items in a mailbox that
couldn't be indexed, including an error code and the reason for failure.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Get
     unsearchable items" entry in the Mailbox Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the mailbox. You can use one of
the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -MailboxDatabase <DatabaseIdParameter>
        The MailboxDatabase parameter specifies the database from which
to get the mailbox. You can use the following values:
        * GUID of the database
        * Database name
        * Distinguished name (DN)

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Server <ServerIdParameter>
        The Server parameter specifies a Mailbox server. You can use the
following values:
        * Name
         * GUID
         * DN

         Required?                     true
         Position?                     Named
         Default value
         Accept pipeline input?        True
         Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS
OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example retrieves a list of items that couldn't be indexed by
Exchange Search from the mailbox of user Terry Adams.

       Get-FailedContentIndexDocuments -Identity "Terry Adams"




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves a list of items that couldn't be indexed by
Exchange Search from the mailbox database Mailbox Database MDB2.

    Get-FailedContentIndexDocuments -MailboxDatabase "Mailbox Database
MDB2"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/d128ec5f-
f805-4bc0-982b-b9adceb8eca8(EXCHG.141).aspx

NAME
       Get-FederatedDomainProof

SYNOPSIS
    Use the Get-FederatedDomainProof cmdlet to generate a
cryptographically secure string for the domain used for federated
delegation in your Mic
    rosoft Exchange Server 2010 organization.

SYNTAX
    Get-FederatedDomainProof -DomainName <SmtpDomain> [-DomainController
<Fqdn>] [-Thumbprint <String>] [<CommonParameters>]


DESCRIPTION
    The Get-FederatedDomainProof cmdlet generates a cryptographically
secure string for the domain that will be used for federated delegation.
The
     resulting string is used to manually configure a text (TXT) record
in the Domain Name System (DNS) zone for the domain used by the
administra
    tor when running the cmdlet. A TXT record needs to be added to DNS
for all accepted domains used for federated delegation. If the thumbprint
o
    f a certificate isn't provided, the task generates strings for all
the certificates currently configured for the federation trust. Upon
initia
    l configuration of federated delegation, the proof string generated
for the current certificate needs to be put into the TXT record for the
fe
    derated domain in DNS. We recommend you update the TXT records
whenever a new certificate is configured for the federation trust.
    To set up federated delegation for your on-premises Exchange 2010
organization, you must use a different domain namespace for the federated
de
    legation organizational identifier than the domain you're using as
your primary SMTP top-level domain. We recommend creating and using a
subdo
    main of exchangedelegation as the domain name of the subdomain to
differentiate that this subdomain is used for delegation functionality in
Ex
    change.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Fede
    ration trusts" entry in the Exchange and Shell Infrastructure
Permissions topic.


PARAMETERS
    -DomainName <SmtpDomain>
        The DomainName parameter specifies the domain name for which the
cryptographically secure string will be generated.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Thumbprint <String>
        The Thumbprint parameter specifies the thumbprint of an existing
certificate.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example generates a cryptographically secure string for the
domain exchangedelegation.contoso.com.

    Get-FederatedDomainProof -DomainName "exchangedelegation.contoso.com"




    -------------------------- EXAMPLE 2 --------------------------
    This example uses a specific certificate for the domain
exchangedelegation.contoso.com.

    Get-FederatedDomainProof -DomainName "exchangedelegation.contoso.com"
-Thumbprint AC00F35CBA8359953F4126E0984B5CCAFA2F4F17.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/ef27cb75-
e894-46c7-8f31-cb6af04ab3f1(EXCHG.141).aspx

NAME
       Get-FederatedOrganizationIdentifier

SYNOPSIS
    Use the Get-FederatedOrganizationIdentifier cmdlet to retrieve the
Microsoft Exchange Server 2010 organization's federated organization
identi
    fier and related details, such as federated domains, organization
contact, and status.
    For more information, see Understanding Federation.

SYNTAX
    Get-FederatedOrganizationIdentifier [-Identity
<OrganizationIdParameter>] [-DomainController <Fqdn>] [-
IncludeExtendedDomainInfo <SwitchParame
    ter>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Fede
    ration trusts" entry in the Exchange and Shell Infrastructure
Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <OrganizationIdParameter>
        The Identity parameter specifies the organization ID.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -IncludeExtendedDomainInfo <SwitchParameter>
        The IncludeExtendedDomainInfo switch specifies that the command
query Microsoft Federation Gateway for the status of each accepted domain
        that's federated. The status is returned with each domain in the
Domains property.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the Exchange 2010 organization's federated
organization identifier.

    Get-FederatedOrganizationIdentifier
       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the Exchange 2010 organization's federated
organization identifier. The IncludeExtendedDomainInfo switch is used to
ret
    urn the status of federated domains from the Microsoft Federation
Gateway.

       Get-FederatedOrganizationIdentifier -IncludeExtendedDomainInfo




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/922052b7-
0aec-46a3-a2be-32ed6d0628fa(EXCHG.141).aspx

NAME
       Get-FederationInformation

SYNOPSIS
    Use the Get-FederationInformation cmdlet to get federation
information, including federated domain names and target URLs, from an
external Exc
    hange organization.

SYNTAX
    Get-FederationInformation -DomainName <SmtpDomain> [-Force
<SwitchParameter>] [-TrustedHostnames <MultiValuedProperty>]
[<CommonParameters>]


DESCRIPTION
    The Get-FederationInformation cmdlet retrieves federation information
from the domain specified. Results from the cmdlet can be piped to the N
    ew-OrganizationRelationship cmdlet to establish an organization
relationship with the organization being queried.
    The domain specified should have federation enabled.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Fede
    ration trusts" entry in the Exchange and Shell Infrastructure
Permissions topic.


PARAMETERS
    -DomainName <SmtpDomain>
        The DomainName parameter specifies the domain name for which
federation information is to be retrieved.

          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Force <SwitchParameter>
        The Force switch specifies that the command should override the
prompt and fail immediately if the host name in the Autodiscover endpoint
        of the domain doesn't match the Secure Sockets Layer (SSL)
certificate presented by the endpoint, and the host name isn't specified
in the
         TrustedHostnames parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -TrustedHostnames <MultiValuedProperty>
         The TrustedHostnames parameter specifies the fully qualified
domain name (FQDN) of federation endpoints. Federation endpoints are
Client A
         ccess servers in an organization with federation enabled.
Explicitly specifying the TrustedHostnames parameter allows the cmdlet to
bypass
          prompting if the certificate presented by the endpoint doesn't
match the domain name specified in the DomainName parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS
NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example gets federation information from the domain Contoso.com.

       Get-FederationInformation -DomainName Contoso.com




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/e7e948c8-
453d-49e2-97da-45fd2a7853ba(EXCHG.141).aspx

NAME
       Get-FederationTrust

SYNOPSIS
    Use the Get-FederationTrust cmdlet to view the federation trusts
configured for the organization.

SYNTAX
    Get-FederationTrust [-Identity <FederationTrustIdParameter>] [-
DomainController <Fqdn>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Fede
    ration trusts" entry in the Exchange and Shell Infrastructure
Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
          irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -Identity <FederationTrustIdParameter>
         The Identity parameter specifies a federation trust ID. If not
specified, the cmdlet returns all federation trusts configured for the
orga
         nization.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves properties of federation trusts configured for
the organization.

    Get-FederationTrust | Format-List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/f6c81c31-
491a-48ca-a547-f938a31f433f(EXCHG.141).aspx

NAME
       Get-Group

SYNOPSIS
    Use the Get-Group cmdlet to query for existing groups.

SYNTAX
    Get-Group [-Identity <GroupIdParameter>] [-Credential <PSCredential>]
[-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <Swit
    chParameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainController <Swit
    chParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-
ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]

    Get-Group [-Anr <String>] [-Credential <PSCredential>] [-
DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope
<SwitchParameter>] [
    -Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>] [
    -RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize
<Unlimited>] [-SortBy <String>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Dist
    ribution groups" entry in the Mailbox Permissions topic.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

          Required?                  false
          Position?                  Named
          Default value
          Accept pipeline input?     False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <GroupIdParameter>
        The Identity parameter of the distribution group takes one of the
following forms:
        * GUID
        * Distinguished name (DN)
        * User principal name (UPN)
        * LegacyExchangeDN
        * Domain\Account name
        * Alias

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true
    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies an organizational unit
(OU) and is used to limit the results.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest,
and if you don't use this parameter, it's possible that the user
informati
        on is read from a global catalog with outdated information. If
you use this parameter, multiple reads might be necessary to get the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your servers that run Microsoft Exchange.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientTypeDetails <RecipientTypeDetails[]>
        The RecipientTypeDetails parameter specifies the type of
recipients returned. Recipient types are divided into recipient types and
subtype
        s. Each recipient type contains all common properties for all
subtypes. For example, the type UserMailbox represents a user account in
Act
        ive Directory that has an associated mailbox. Because there are
several mailbox types, each mailbox type is identified by the
RecipientTyp
        eDetails parameter. For example, a conference room mailbox has
RecipientTypeDetails set to ConferenceRoomMailbox, whereas a user mailbox
h
        as RecipientTypeDetails set to UserMailbox.
        You can select from the following values:
        * ArbitrationMailbox
        * ConferenceRoomMailbox
        * Contact
        * DiscoveryMailbox
        * DynamicDistributionGroup
        * EquipmentMailbox
        * ExternalManagedContact
        * ExternalManagedDistributionGroup
        * LegacyMailbox
        * LinkedMailbox
        * MailboxPlan
        * MailContact
        * MailForestContact
        * MailNonUniversalGroup
        * MailUniversalDistributionGroup
        * MailUniversalSecurityGroup
        * MailUser
        * PublicFolder
        * RoleGroup
        * RoomList
        * RoomMailbox
        * SharedMailbox
        * SystemAttendantMailbox
        * SystemMailbox
        * User
        * UserMailbox

        Required?                     false
        Position?                     Named
        Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of members
returned.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute to sort by.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
    This example uses the Get-Group cmdlet without parameters to return
all of the groups in Active Directory.

       Get-Group




       -------------------------- EXAMPLE 2 --------------------------




    This example uses the Identity parameter to return the group
Marketing Reports.

       Get-Group -Identity "Marketing Reports"




       -------------------------- EXAMPLE 3 --------------------------




    This example uses the Anr parameter to return all groups that begin
with "Mar".

       Get-Group -Anr Mar*




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/1dff448b-
e4ac-45b8-9a60-2ab3b5859559(EXCHG.141).aspx

NAME
       Get-HotmailSubscription

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-HotmailSubscription cmdlet to view information about
Hotmail subscriptions that are configured in cloud-based mailboxes.

SYNTAX
    Get-HotmailSubscription [-Identity
<AggregationSubscriptionIdParameter>] [-AggregationType <Aggregation |
Mirrored | Migration | All>] [-Confi
    rm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Mailbox
<MailboxIdParameter>] [-ResultSize <Unlimited>] [-WhatIf
[<SwitchParameter>]] [<C
    ommonParameters>]


DESCRIPTION
    You can view the properties of the Hotmail subscription, such as the
connection status and the last time a successful synchronization occurred
    .


PARAMETERS
    -AggregationType <Aggregation | Mirrored | Migration | All>
        The AggregationType parameter filters the results by type. The
acceptable values for this parameter are:
        * All
        * Aggregation
        * Migration
        * Mirrored

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <AggregationSubscriptionIdParameter>
        The Identity parameter specifies the Hotmail subscription. You
can identify the subscription by using one of the following methods:
        * Specify the globally unique identifier of the subscription,
which is its canonical name (CN).
        * Use the Mailbox parameter to specify the mailbox that contains
the subscription, and then specify the name of the subscription.
        You can find the identifying values for a Hotmail subscription,
such as Identity and Name, by running this command: Get-
HotmailSubscriptio
        n -Mailbox <mailbox>.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the cloud-based mailbox that
contains the Hotmail subscription. You can use any value that uniquely
identi
        fies the mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the total number of
subscriptions to return. If no value is specified, the parameter returns
all result
        s that match the filter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example lists all the Hotmail subscriptions that are configured
in the mailbox of a user named "Tamara Johnston".

       Get-HotmailSubscription -Mailbox "Tamara Johnston"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/61e79b8f-
2806-4c15-bdc3-74b181482d8f(EXCHG.141).aspx

NAME
       Get-ImapSubscription

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-ImapSubscription cmdlet to view information about IMAP
subscriptions that are configured in cloud-based mailboxes.

SYNTAX
    Get-ImapSubscription [-Identity <AggregationSubscriptionIdParameter>]
[-AggregationType <Aggregation | Mirrored | Migration | All>] [-Confirm
    [<SwitchParameter>]] [-DomainController <Fqdn>] [-Mailbox
<MailboxIdParameter>] [-ResultSize <Unlimited>] [-WhatIf
[<SwitchParameter>]] [<Comm
    onParameters>]


DESCRIPTION
    You can view the properties of the IMAP subscription, such as the
IMAP server, authentication method, connection status, and the last time
a s
    uccessful synchronization occurred.


PARAMETERS
    -AggregationType <Aggregation | Mirrored | Migration | All>
        The AggregationType parameter filters the results by type. The
acceptable values for this parameter are:
        * All
        * Aggregation
        * Migration
        * Mirrored

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <AggregationSubscriptionIdParameter>
        The Identity parameter specifies the IMAP subscription. You can
identify the subscription by using one of the following methods:
        * Specify the globally unique identifier of the subscription,
which is its canonical name (CN).
        * Use the Mailbox parameter to specify the mailbox that contains
the subscription, and then specify the name of the subscription.
        You can find the identifying values for an IMAP subscription,
such as Identity and Name, by running this command: Get-ImapSubscription
-Ma
        ilbox <mailbox>.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the cloud-based mailbox that
contains the IMAP subscription. You can use any value that uniquely
identifie
        s the mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the total number of
subscriptions to return. If no value is specified, the parameter returns
all result
        s that match the filter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example shows detailed information for all the IMAP
subscriptions that are configured in the mailbox of a user named "Kim
Akers".

       Get-ImapSubscription -Mailbox "Kim Akers" | Format-List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/e13a9ab2-
8cca-4b98-b304-837d13fd4a60(EXCHG.141).aspx

NAME
       Get-InboxRule

SYNOPSIS
    Use the Get-InboxRule cmdlet to view Inbox rule properties. Inbox
rules are used to process messages in the Inbox based on conditions
specifie
    d and take actions such as moving a message to a specified folder or
deleting a message.

SYNTAX
    Get-InboxRule [-Identity <InboxRuleIdParameter>] [-
DescriptionTimeFormat <String>] [-DescriptionTimeZone <ExTimeZoneValue>]
[-DomainController
     <Fqdn>] [-Mailbox <MailboxIdParameter>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Inbo
    x rules" entry in the Mailbox Permissions topic.


PARAMETERS
    -DescriptionTimeFormat <String>
        The DecriptionTimeFormat parameter specifies the format in which
time values are returned in the rule description. You must use standard t
        ime value format settings, for example:
        mm/dd/yyyy, where mm is the 2-digit month, dd is the 2-digit
date, and yyyy is the 4-digit year.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DescriptionTimeZone <ExTimeZoneValue>
        The DescriptionTimeZone parameter specifies the format in which
the time zone for time values is returned in the rule description. Use a
v
        alid Microsoft Windows time zone name.
        You can use the Windows PowerShell command-line interface to
retrieve time zone names from the registry, for example:
        $timezone = Get-ChildItem "HKLM :\Software\Microsoft\Windows
NT\CurrentVersion\Time zones" | For-Each {Get-ItemProperty $_.PSPath};
$timez
        one | ft pschildname,display -auto

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <InboxRuleIdParameter>
        The Identity parameter specifies the identity of an Inbox rule.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the mailbox to which the Inbox
rule belongs. You can use one of the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
    This example retrieves all Inbox rules for the mailbox
Joe@Contoso.com.

       Get-InboxRule -Mailbox Joe@Contoso.com




       -------------------------- EXAMPLE 2 --------------------------




     This example retrieves the Inbox rule ReceivedLastYear from the
mailbox joe@contoso.com on which the ReceivedBeforeDate parameter was set
when
      the rule was created. The DescriptionTimeFormat and
DescriptionTimeZone parameters are used in this example to specify
formatting of the time
      and the time zone used in the rule's Description property.

    Get-InboxRule "ReceivedLastYear" -Mailbox joe@contoso.com -
DescriptionTimeFormat "mm/dd/yyyy" -DescriptionTimeZone "Pacific Standard
Time"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b02ad57a-
460a-4dc2-a521-788cd893c269(EXCHG.141).aspx

NAME
       Get-IRMConfiguration

SYNOPSIS
    Use the Get-IRMConfiguration cmdlet to view the Information Rights
Management (IRM) configuration in a Microsoft Exchange Server 2010
organiza
    tion.

SYNTAX
    Get-IRMConfiguration [-Identity <OrganizationIdParameter>] [-
DomainController <Fqdn>] [<CommonParameters>]


DESCRIPTION
    The Get-IRMConfiguration cmdlet provides details about the current
IRM configuration, including whether individual IRM features are enabled
or
     disabled, and provides the URLs used for ServiceLocation,
PublishingLocation, and LicensingLocation.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Righ
    ts protection" entry in the Messaging Policy and Compliance
Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <OrganizationIdParameter>
        The Identity parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
    This example retrieves the IRM configuration in an Exchange 2010
organization.

       Get-IRMConfiguration




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/e1821219-
fe18-4642-a9c2-58eb0aadd61a(EXCHG.141).aspx

NAME
       Get-JournalRule

SYNOPSIS
    Use the Get-JournalRule cmdlet to view the journal configuration on a
Hub Transport server.

SYNTAX
    Get-JournalRule [-Identity <RuleIdParameter>] [-DomainController
<Fqdn>] [-LawfulInterception <SwitchParameter>] [-Organization
<OrganizationI
    dParameter>] [<CommonParameters>]


DESCRIPTION
    The Get-JournalRule cmdlet displays all rules configured for use with
the Journaling agent.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Jour
    naling" entry in the Messaging Policy and Compliance Permissions
topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false
    -Identity <RuleIdParameter>
        The Identity parameter specifies the rule to be viewed. Enter
either the GUID or the name of the journal rule. You can omit the
parameter
        label.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   true

    -LawfulInterception <SwitchParameter>
        The LawfulInterception parameter is reserved for internal
Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )
       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example retrieves all journal rules configured on a Hub
Transport server.

       Get-JournalRule




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the specific journal rule Brokerage
Communications and pipes the output to the Format-List cmdlet to view all
the param
    eters of the rule.

       Get-JournalRule "Brokerage Communications" | Format-List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/7620913f-
cf28-4e82-983f-61a79f0b6e5a(EXCHG.141).aspx

NAME
       Get-LinkedUser

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-LinkedUser cmdlet to view information about linked user
accounts. The Outlook Live Directory Sync (OLSync) service account is a
li
    nked user..

SYNTAX
    Get-LinkedUser [-Identity <UserIdParameter>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-
IgnoreDefaultScope <
    SwitchParameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainController <
    SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<CommonParameters>]

    Get-LinkedUser [-Anr <String>] [-Credential <PSCredential>] [-
DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope
<SwitchParamete
    r>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParamete
    r>] [-ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]


DESCRIPTION
    The OLSync service account is the only linked user in your
organization. By default, the account is named GALSync-ServiceAccount.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <UserIdParameter>
        The Identity parameter specifies the linked user. You can use any
value that uniquely identifies the linked user. For example:
        * Name
        * Distinguished name (DN)

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Organization <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -ReadFromDomainController <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute to sort by. This
parameter sorts by a single attribute in ascending order.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- Example --------------------------




    This example lists all linked users in the organization.
       Get-LinkedUser




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/7c425c78-
f2eb-4971-b0d7-cfb7f67ddb17(EXCHG.141).aspx

NAME
       Get-LogonStatistics

SYNOPSIS
    Use the Get-LogonStatistics cmdlet to retrieve logon statistics, such
as user name, logon time, last access time, client version, and adapter
    speed.

SYNTAX
    Get-LogonStatistics -Identity <LogonableObjectIdParameter> [-
DomainController <Fqdn>] [<CommonParameters>]

    Get-LogonStatistics -Database <DatabaseIdParameter> [-
DomainController <Fqdn>] [<CommonParameters>]

    Get-LogonStatistics -Server <ServerIdParameter> [-DomainController
<Fqdn>] [<CommonParameters>]


DESCRIPTION
    The Get-LogonStatistics cmdlet retrieves logon information about
currently active sessions. On Mailbox servers only, you can use the Get-
Logon
    Statistics cmdlet without parameters. In this case, the cmdlet
returns the logon statistics for all mailboxes on all databases on the
local se
    rver.
    Users who log on to their mailboxes using Microsoft Office Outlook
Web App aren't continually connected to the Mailbox server. An Outlook
Web
    App client connects to the server, performs tasks, and then
disconnects from the server. Therefore, you may see few or no logon
statistics for
     Outlook Web App, even if users are logged on with this client.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
    pient Provisioning Permissions" section in the Mailbox Permissions
topic.
PARAMETERS
    -Database <DatabaseIdParameter>
        The Database parameter specifies the name of the mailbox
database. When you specify a value for the Database parameter, the
Exchange Manag
        ement Shell returns logon statistics for all the mailboxes on the
database specified.
        You can use the following values:
        * Server\Database
        * Database
        This parameter accepts pipeline input from the Get-
MailboxDatabase command.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Identity <LogonableObjectIdParameter>
         The Identity parameter specifies a mailbox for which you want to
obtain logon statistics. You can use one of the following values:
         * GUID
         * Distinguished name (DN)
         * Domain\Account
         * User principal name (UPN)
         * Legacy Exchange DN
         * SmtpAddress
         * Alias
         This parameter accepts pipeline input from the Get-Mailbox
command.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Server <ServerIdParameter>
        The Server parameter specifies the server from which you want to
obtain logon statistics. You can use one of the following values:
        * Fully qualified domain name (FQDN)
        * NetBIOS name
        When you specify a value for the Server parameter, the command
returns logon statistics for all the mailboxes on all the databases,
includ
        ing recovery databases, on the specified server. If you don't
specify this parameter, the command returns logon statistics for the
local s
        erver.
        This parameter accepts pipeline input from the Get-ExchangeServer
and Get-MailboxServer commands.

        Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns logon statistics for all users connected to the
server named Server01.

    Get-LogonStatistics -Server Server01
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/c06f202e-
2302-4122-a514-9d11b6ad2c47(EXCHG.141).aspx

NAME
       Get-Mailbox

SYNOPSIS
    Use the Get-Mailbox cmdlet to view mailbox objects and attributes,
populate property pages, or supply mailbox information to other tasks.

SYNTAX
     Get-Mailbox [-Identity <MailboxIdParameter>] [-Arbitration
<SwitchParameter>] [-Archive <SwitchParameter>] [-Capabilities
<MultiValuedProperty
     >] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter
<String>] [-ForReconciliation <SwitchParameter>] [-IgnoreDefaultScope
<Swi
     tchParameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainController <Swi
     tchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-
RemoteArchive <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy
<String>
     ] [<CommonParameters>]

     Get-Mailbox [-Arbitration <SwitchParameter>] [-Archive
<SwitchParameter>] [-Capabilities <MultiValuedProperty>] [-Credential
<PSCredential>] [
     -DomainController <Fqdn>] [-Filter <String>] [-ForReconciliation
<SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-MailboxPlan
<Mai
     lboxPlanIdParameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainControll
     er <SwitchParameter>] [-RecipientTypeDetails
<RecipientTypeDetails[]>] [-RemoteArchive <SwitchParameter>] [-ResultSize
<Unlimited>] [-SortBy <
     String>] [<CommonParameters>]

    Get-Mailbox [-Arbitration <SwitchParameter>] [-Archive
<SwitchParameter>] [-Capabilities <MultiValuedProperty>] [-Credential
<PSCredential>] [
    -DomainController <Fqdn>] [-Filter <String>] [-ForReconciliation
<SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization
<Or
    ganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>] [-RecipientTypeDet
    ails <RecipientTypeDetails[]>] [-RemoteArchive <SwitchParameter>] [-
ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]
[
    <CommonParameters>]

    Get-Mailbox [-Arbitration <SwitchParameter>] [-Archive
<SwitchParameter>] [-Capabilities <MultiValuedProperty>] [-Credential
<PSCredential>] [
    -Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-Filter
<String>] [-ForReconciliation <SwitchParameter>] [-IgnoreDefaultScope <Sw
    itchParameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainController <Sw
    itchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-
RemoteArchive <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy
<String
    >] [<CommonParameters>]

    Get-Mailbox [-Anr <String>] [-Arbitration <SwitchParameter>] [-
Archive <SwitchParameter>] [-Capabilities <MultiValuedProperty>] [-
Credential <
    PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-
ForReconciliation <SwitchParameter>] [-IgnoreDefaultScope
<SwitchParameter>] [-
    Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>] [-
    RecipientTypeDetails <RecipientTypeDetails[]>] [-RemoteArchive
<SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<CommonParamet
    ers>]


DESCRIPTION
    The Get-Mailbox cmdlet retrieves the attributes and objects for a
mailbox. No parameters are required. If the cmdlet is used without a
paramet
    er, all mailboxes in the organization are listed.
    To accurately evaluate the current storage quota status using the
Get-Mailbox cmdlet, you must look at the UseDatabaseQuotaDefaults
property i
    n addition to the ProhibitSendQuota, ProhibitSendReceiveQuota, and
IssueWarningQuota properties. A value of True for the
UseDatabaseQuotaDefau
    lts property means that the per-mailbox settings are ignored and the
mailbox database limits are used. If this property is set to True and the
     ProhibitSendQuota, ProhibitSendReceiveQuota, and IssueWarningQuota
properties are set to unlimited, the mailbox doesn't have unlimited size.
    Instead, you must reference the mailbox database storage limits to
see what the limits for the mailbox are. A value of False for the
UseDataba
    seQuotaDefaults property means that the per-mailbox settings are
used.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
    pient Provisioning Permissions" section in the Mailbox Permissions
topic.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Arbitration <SwitchParameter>
        The Arbitration parameter specifies that the mailbox for which
you are executing the command is an arbitration mailbox. Arbitration
mailbo
        xes are used for managing approval workflow. For example, an
arbitration mailbox is used for handling moderated recipients and
distributio
        n group membership approval.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Archive <SwitchParameter>
        The Archive parameter specifies whether to return information
about the recipient's archive mailbox.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Capabilities <MultiValuedProperty>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Database <DatabaseIdParameter>
        The Database parameter specifies the database from which to get
the mailbox. You can use the following values:
        * GUID of the database
        * Database name
        If you don't specify the server name, the command searches for
the database on the local server.
        This parameter can't be used in conjunction with the Filter
parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ForReconciliation <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxIdParameter>
        The Identity parameter specifies the identity of the mailbox. You
can use one of the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

        Required?                     false
        Position?                     Named
        Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -MailboxPlan <MailboxPlanIdParameter>
         This parameter applies only to objects in the cloud-based
service.
         The MailboxPlan parameter specifies a mailbox plan for the
mailbox.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies an organizational unit
(OU) and is used to limit the results. If you use this parameter, you on
        ly get mailboxes in the container that you specify. You can use
either the OU or the domain name. If you use the OU, you must specify the
        canonical name of the OU.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest
and don't use this parameter, it's possible that the user information is
re
        ad from a global catalog with outdated information. If you use
this parameter, multiple reads might be necessary to get the information.
        By default, the recipient scope is set to the domain that hosts
your servers that run Exchange.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientTypeDetails <RecipientTypeDetails[]>
        The RecipientTypeDetails parameter specifies the type of
recipients returned. Recipient types are divided into recipient types and
subtype
        s. Each recipient type contains all common properties for all
subtypes. For example, the type UserMailbox represents a user account in
Act
        ive Directory that has an associated mailbox. Because there are
several mailbox types, each mailbox type is identified by the
RecipientTyp
        eDetails parameter. For example, a conference room mailbox has
RecipientTypeDetails set to RoomMailbox, whereas a user mailbox has
Recipie
        ntTypeDetails set to UserMailbox.
        This parameter accepts the following values:
        * RoomMailbox
        * EquipmentMailbox
        * LegacyMailbox
        * LinkedMailbox
        * UserMailbox
        * DiscoveryMailbox
        * SharedMailbox

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RemoteArchive <SwitchParameter>
        The RemoteArchive parameter specifies whether to disconnect the
remote archive for this mailbox. A remote archive exists in a cloud-based
        service.
        When you use this parameter, you can't use the Archive parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all mailboxes that match the query, use
        unlimited for the value of this parameter. The default value is
1000.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -Server <ServerIdParameter>
        The Server parameter specifies an individual server and is used
to limit the results. If you use this parameter, you only get mailboxes
th
        at reside on the server that you specify. Use the common name of
the server that you want to specify.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. You can sort by t
        he following attributes:
        * Alias
        * Display name
        * Name
        The results are sorted in ascending order.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:
    -------------------------- EXAMPLE 1 --------------------------




    This example returns a list of all the mailboxes in your
organization.

    Get-Mailbox -ResultSize unlimited




    -------------------------- EXAMPLE 2 --------------------------




    This example returns a list of all the mailboxes in your organization
in the Users OU.

    Get-Mailbox -OrganizationalUnit Users




    -------------------------- EXAMPLE 3 --------------------------




    This example returns all the mailboxes that resolve from the
ambiguous name resolution search on the string "Chr" that are in the
domain named
     DC01. This example returns mailboxes for users such as Chris Ashton,
Christian Hess, and Christa Geller.

    Get-Mailbox -Anr Chr -DomainController DC01




    -------------------------- EXAMPLE 4 --------------------------




    This example returns information about the mailbox named Chris,
including archive mailbox information.
       Get-Mailbox -Identity Chris -Archive




       -------------------------- EXAMPLE 5 --------------------------




    This example returns information about the mailbox ed@contoso.com,
including information about his remote archive mailbox.

       Get-Mailbox -Identity ed@contoso.com -RemoteArchive




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/8a5a6eb9-
4a75-47f9-ae3b-a3ba251cf9a8(EXCHG.141).aspx

NAME
       Get-MailboxAuditBypassAssociation

SYNOPSIS
    Use the Get-MailboxAuditByapssAssociation cmdlet to retrieve user or
computer accounts configured to bypass mailbox audit logging.

SYNTAX
    Get-MailboxAuditBypassAssociation [-Identity
<MailboxAuditBypassAssociationIdParameter>] [-DomainController <Fqdn>] [-
Organization <Organizati
    onIdParameter>] [-ResultSize <Unlimited>] [<CommonParameters>]


DESCRIPTION
    When you configure a user or computer account to bypass mailbox audit
logging, access or actions taken by the user or computer account to any
    mailbox isn't logged. By bypassing trusted user or computer accounts
that need to access mailboxes frequently, you can reduce the noise in mai
    lbox audit logs.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mail
    box audit logging" entry in the Messaging Policy and Compliance
Permissions topic.
PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <MailboxAuditBypassAssociationIdParameter>
        The Identity parameter specifies a user or computer account to
retrieve audit logging bypass association for.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all mailboxes that match the query, use
        unlimited for the value of this parameter. The default value is
1000.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS
NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example retrieves all user or computer accounts configured for
mailbox audit logging bypass.

       Get-MailboxAuditBypassAssociation -ResultSize unlimited




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the mailbox audit bypass association for the
Svc-MyApplication account.

       Get-MailboxAuditBypassAssociation -Identity "Svc-MyApplication"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2e3d8264-
0636-419d-8677-2be456c3551b(EXCHG.141).aspx

NAME
       Get-MailboxAutoReplyConfiguration

SYNOPSIS
    Use the Get-MailboxAutoReplyConfiguration cmdlet to retrieve
Automatic Replies settings for a specific mailbox.

SYNTAX
    Get-MailboxAutoReplyConfiguration -Identity <MailboxIdParameter> [-
Credential <PSCredential>] [-DomainController <Fqdn>] [-
ReadFromDomainContr
    oller <SwitchParameter>] [-ResultSize <Unlimited>]
[<CommonParameters>]


DESCRIPTION
     You can use the Get-MailboxAutoReplyConfiguration cmdlet to retrieve
all the mailboxes enabled for Automatic Replies. When run, the cmdlet ret
     urns Automatic Replies settings for the specified mailbox that
include the following:
     * Mailbox identity value
     * Whether Automatic Replies is enabled, scheduled, or disabled for
the mailbox
     * Start and end date, time during which Automatic Replies will be
sent
     * Whether external senders receive Automatic Replies (none, known
senders, or all)
     * Automatic Replies message to be sent to internal and external
senders
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"User
      options" entry in the Client Access Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies a unique identifier associated
with a mailbox. Accepted values for the mailbox are as follows:
        * GUID
        * ADObjectID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Credential <PSCredential>
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest,
and if you don't use this parameter, it's possible that the user
informati
        on is read from a global catalog with outdated information. If
you use this parameter, multiple reads might be necessary to get the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your servers that run Microsoft Exchange.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of settings
to return. If you want to return all settings that match the command, us
        e unlimited for the value of this parameter.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS
OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns Automatic Replies settings for all mailboxes in
the Exchange organization.

    Get-Mailbox | Get-MailboxAutoReplyConfiguration




    -------------------------- EXAMPLE 2 --------------------------




    This example retrieves Automatic Replies settings for Tony's mailbox
at contoso.com.

    Get-MailboxAutoReplyConfiguration -Identity 'contoso.com/Users/Tony
Smith'




    -------------------------- EXAMPLE 3 --------------------------




    This example retrieves all Automatic Replies settings for all
mailboxes in the Exchange organization.

    Get-Mailbox | Get-MailboxAutoReplyConfiguration -ResultSize unlimited
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/0963eab0-
8bc8-4f06-b6f7-7dd88b1559f5(EXCHG.141).aspx

NAME
       Get-MailboxCalendarConfiguration

SYNOPSIS
    Use the Get-MailboxCalendarConfiguration cmdlet to show the calendar
settings for a specified mailbox.

SYNTAX
    Get-MailboxCalendarConfiguration -Identity <MailboxIdParameter> [-
DomainController <Fqdn>] [<CommonParameters>]


DESCRIPTION
     The Get-MailboxCalendarConfiguration cmdlet returns settings for the
calendar of the specified mailbox, including the following:
     * Workdays   Days that appear in the calendar as work days in
Microsoft Office Outlook Web App
     * WorkingHoursStartTime    Time that the calendar work day starts
     * WorkingHoursEndTime    Time that the calendar work day ends
     * WorkingHoursTimeZone    Time zone set on the mailbox for the working
hours start and end times
     * WeekStartDay    First day of the calendar work week
     * ShowWeekNumbers    Number for each week ranging from 1 through 52
for the calendar while in month view in Outlook Web App
     * TimeIncrement    Increments in minutes in which the calendar
displays the time in Outlook Web App
     * RemindersEnabled    Whether Outlook Web App provides a visual cue
when a calendar reminder is due
     * ReminderSoundEnabled    Whether a sound is played when a calendar
reminder is due
     * DefaultReminderTime    Length of time before each meeting or
appointment that the calendar in Outlook Web App shows the reminder
     To see all of the settings returned, pipeline the command to the
Format-List command. To see a code sample, see "EXAMPLE 1" later in this
topi
     c.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"User
      options" entry in the Client Access Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies a unique identifier for the
mailbox. You can use the following values:
        * GUID
        * ADObjectID
          *   Distinguished name (DN)
          *   Domain\Account
          *   User principal name (UPN)
          *   LegacyExchangeDN
          *   SmtpAddress
          *   Alias

          Required?                       true
          Position?                       1
          Default value
          Accept pipeline input?          True
          Accept wildcard characters?     false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                       false
          Position?                       Named
          Default value
          Accept pipeline input?          False
          Accept wildcard characters?     false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves all the calendar settings for Kai's mailbox
where the Identity parameter is specified in the alias format.

    Get-MailboxCalendarConfiguration -Identity kai | Format-List
       -------------------------- EXAMPLE 2 --------------------------




    This example uses the Identity parameter specified in the
domain\account format and returns the calendar settings for Tony's
mailbox.

       Get-MailboxCalendarConfiguration -Identity contoso\tony




       -------------------------- EXAMPLE 3 --------------------------




    This example requests that the domain controller DC1 retrieves
calendar settings for Kai's mailbox from Active Directory.

       Get-MailboxCalendarConfiguration -Identity kai -DomainController DC1




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2a794a69-
3029-49df-920c-5d91ecdb057e(EXCHG.141).aspx

NAME
       Get-MailboxCalendarFolder

SYNOPSIS
    The Get-MailboxCalendarFolder cmdlet retrieves the publishing or
sharing settings for a specified mailbox calendar folder.

SYNTAX
    Get-MailboxCalendarFolder -Identity <MailboxFolderIdParameter> [-
DomainController <Fqdn>] [<CommonParameters>]


DESCRIPTION
    The Get-MailboxCalendarFolder cmdlet retrieves information for the
specified calendar folder. This information includes the calendar folder
na
    me, whether the folder is currently published or shared, the start
and end range of calendar days published, the level of details published
fo
    r the calendar, whether the published URL of the calendar can be
searched on the Web, and the published URL for the calendar.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"User
     options" entry in the Client Access Permissions topic.


PARAMETERS
    -Identity <MailboxFolderIdParameter>
        The Identity parameter specifies the mailbox and folder path or
folder name to the calendar folder that has the publishing settings
config
        ured. You can use the following values:
        * GUID
        * ADObjectID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

         Required?                     true
         Position?                     1
         Default value
         Accept pipeline input?        True
         Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

         Required?                     false
         Position?                     Named
         Default value
         Accept pipeline input?        False
         Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS
OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


      Type:
      Target Object Type:
      Suggested Action:

      -------------------------- EXAMPLE 1 --------------------------




    This example returns all provided publishing information for Kai's
mailbox for the specified calendar folder. In this example, the Identity
pa
    rameter specifies the mailbox with the alias format.

      Get-MailboxCalendarFolder -Identity kai:\Calendar




      -------------------------- EXAMPLE 2 --------------------------




    This example returns all provided publishing information for the
specified calendar folder in Kai's mailbox. This example also specifies
DC1 a
    s the domain controller to retrieve this information from Active
Directory.

      Get-MailboxCalendarFolder -Identity kai:\Calendar -DomainController
DC1




      -------------------------- EXAMPLE 3 --------------------------




    This example returns all provided publishing information for the
specified calendar folder in Kai's mailbox. In this example, the Identity
par
    ameter specifies the mailbox with the domain\account format.
       Get-MailboxCalendarFolder -Identity contoso\kai:\Calendar




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/dba2cebb-
3c37-40ce-8ac0-93ec8d79ce0d(EXCHG.141).aspx

NAME
       Get-MailboxFolder

SYNOPSIS
    Use the Get-MailboxFolder cmdlet to retrieve folders for a specified
mailbox when the mailbox owner runs the command.

SYNTAX
    Get-MailboxFolder [-Identity <MailboxFolderIdParameter>] [-
DomainController <Fqdn>] [<CommonParameters>]

    Get-MailboxFolder [-Identity <MailboxFolderIdParameter>] -GetChildren
<SwitchParameter> [-DomainController <Fqdn>] [-MailFolderOnly <SwitchPar
    ameter>] [-ResultSize <Unlimited>] [<CommonParameters>]

    Get-MailboxFolder [-Identity <MailboxFolderIdParameter>] -Recurse
<SwitchParameter> [-DomainController <Fqdn>] [-MailFolderOnly
<SwitchParamet
    er>] [-ResultSize <Unlimited>] [<CommonParameters>]


DESCRIPTION
    If the mailbox isn't specified, the cmdlet returns the specified
folders in the mailbox of the mailbox owner currently running the
command. Th
    is command checks that the mailbox specified in the Identity
parameter is a valid Exchange mailbox before retrieving the requested
folders. Th
    e cmdlet returns all folders if the MailFolderOnly parameter isn't
specified.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"User
     options" entry in the Client Access Permissions topic.


PARAMETERS
     -GetChildren <SwitchParameter>
         The GetChildren parameter specifies whether to return only the
first level of subfolders under the specified parent folder. You can't
spec
        ify both this parameter and the Recurse parameter at the same
time. The default value is $false.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Recurse <SwitchParameter>
        The Recurse parameter specifies whether to return the specified
parent folder and all of its subfolders. You can't specify both this
param
        eter and the GetChildren parameter at the same time. The default
value is $false.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxFolderIdParameter>
        The Identity parameter specifies the mailbox and the folder that
the command returns information about. If the folder isn't specified, the
         command returns information about folders in the root hierarchy
of the specified mailbox. You can specify values in the following format:
         <Mailbox Identity>:<Parent>
        Valid values for <Mailbox Identity> include:
        * GUID
        * ADObjectID distinguished name
        * Domain\username
        * User principal name (UPN)
        * LegacyExchangeDN
        * SMTP address
        * Alias
        * Store object ID of the parent folder
        Values for <Parent> can be both the store object ID and a path
string such as \Inbox\Personal.

        Required?                     false
        Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -MailFolderOnly <SwitchParameter>
        The MailFolderOnly parameter specifies whether to return only the
mail folders in the specified mailbox. The default value is $false.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of settings
to return. If you want to return all settings that match the command, us
        e unlimited for the value of this parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the Inbox folder in Tony's mailbox. The
Identity parameter is supplied in the format of <Mailbox
Identity>:<Folder>.

    Get-MailboxFolder -Identity Tony:\Inbox
    -------------------------- EXAMPLE 2 --------------------------




    This example returns the root folders in Tony's mailbox. The Identity
parameter is supplied in the format of <Mailbox Identity>.

    Get-MailboxFolder -Identity Tony




    -------------------------- EXAMPLE 3 --------------------------




    This example returns the first level of mail folders in Tony's
mailbox.

    Get-MailboxFolder -Identity Tony -GetChildren -MailFolderOnly




    -------------------------- EXAMPLE 4 --------------------------




    This example returns information about all the subfolders under Inbox
in Tony's mailbox.

    Get-MailboxFolder -Identity Tony:\Inbox -GetChildren




    -------------------------- EXAMPLE 5 --------------------------




    This example returns all levels of folders under Inbox in Tony's
mailbox.
       Get-MailboxFolder -Identity Tony:\Inbox -Recurse




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/d519b3de-
2118-4007-a556-51c01d1ba931(EXCHG.141).aspx

NAME
       Get-MailboxFolderPermission

SYNOPSIS
    Use the Get-MailboxFolderPermission cmdlet to view the folder-level
permissions for a folder or a specific user's permissions for a folder.

SYNTAX
    Get-MailboxFolderPermission -Identity <MailboxFolderIdParameter> [-
DomainController <Fqdn>] [-User <MailboxFolderUserIdParameter>]
[<CommonPar
    ameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mail
    box folder" entry in the Mailbox Permissions topic.


PARAMETERS
    -Identity <MailboxFolderIdParameter>
        The Identity parameter specifies the mailbox and folder for which
you want to view permissions. This parameter takes the following format:
         <SMTP Address or Alias of the mailbox>:<Folder path>, for
example, john@contoso.com:\Calendar.

          Required?                     true
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -User <MailboxFolderUserIdParameter>
        The User parameter specifies who's granted permission to view or
modify folder contents of the user and folder specified in the Identity p
        arameter. You can use the following values:
        * Alias
        * SMTP address

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns the current list of user permissions for John's
Reports mailbox folder under the Marketing folder.

    Get-MailboxFolderPermission -Identity
john@contoso.com:\Marketing\Reports




    -------------------------- EXAMPLE 2 --------------------------
    This example returns the permissions that Ayla has to view John's
Marketing Reports folder.

    Get-MailboxFolderPermission -Identity
john@contoso.com:\Marketing\Reports -User Ayla@contoso.com




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/048000f2-
70ce-4630-985f-b3902903ae67(EXCHG.141).aspx

NAME
       Get-MailboxFolderStatistics

SYNOPSIS
    Use the Get-MailboxFolderStatistics cmdlet to retrieve information
about the folders in a specified mailbox, including the number and size
of
    items in the folder, the folder name and ID, and other information.

SYNTAX
    Get-MailboxFolderStatistics -Identity <MailboxOrMailUserIdParameter>
[-Archive <SwitchParameter>] [-DomainController <Fqdn>] [-FolderScope <Ca
    lendar | Contacts | DeletedItems | Drafts | Inbox | JunkEmail |
Journal | Notes | Outbox | SentItems | Tasks | All | ManagedCustomFolder
| Rss
    Subscriptions | SyncIssues | ConversationHistory | Personal |
RecoverableItems>] [-IncludeAnalysis <SwitchParameter>] [-
IncludeOldestAndNewest
    Items <SwitchParameter>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mail
    box folder" entry in the Mailbox Permissions topic.
    A mailbox can have hidden items that are never visible to the user
and are only used by applications. The Get-MailboxFolderStatistics cmdlet
c
    an return hidden items for the following values: FolderSize,
FolderAndSubfolderSize, ItemsInFolder, and ItemsInFolderAndSubfolders.
    The Get-MailboxFolderStatistics cmdlet shouldn't be confused with the
Get-MailboxStatistics cmdlet. For more information, see Get-MailboxStati
    stics.
PARAMETERS
    -Identity <MailboxOrMailUserIdParameter>
        The Identity parameter specifies the identity of the mailbox or
mail-enabled user. You can use one of the following values:
        * GUID
        * ADObjectID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SMTP address
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Archive <SwitchParameter>
         The Archive parameter specifies whether to return the usage
statistics of the archive associated with the mailbox or mail-enabled
user. Yo
         u don't need to provide a value with this parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -FolderScope <Calendar | Contacts | DeletedItems | Drafts | Inbox |
JunkEmail | Journal | Notes | Outbox | SentItems | Tasks | All |
ManagedCu
    stomFolder | RssSubscriptions | SyncIssues | ConversationHistory |
Personal | RecoverableItems>
        The FolderScope parameter specifies the scope of the search by
folder type. Valid parameter values include:
        * All
        * Calendar
        * Contacts
        * ConversationHistory
        * DeletedItems
        * Drafts
        * Inbox
        * JunkEmail
        * Journal
        * ManagedCustomFolder
        * Notes
        * Outbox
        * Personal
        * RecoverableItems
        * RssSubscriptions
        * SentItems
        * SyncIssues
        * Tasks
        If the ManagedCustomFolder value is entered, the command returns
the output for all managed custom folders. If the RecoverableItems value
        is entered, the command returns the output for the Recoverable
Items folder and the Deletions, Purges, and Versions subfolders.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IncludeAnalysis <SwitchParameter>
        The IncludeAnalysis parameter specifies whether to scan all items
within a folder and return statistics related to the folder and item siz
        e. This parameter should be used for troubleshooting purposes and
it may take a long time to complete.
        You don't need to provide a value with this parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IncludeOldestAndNewestItems <SwitchParameter>
        The IncludeOldestAndNewestItems parameter specifies whether to
return the dates of the oldest and newest items in each folder.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".
INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example doesn't specify the FolderScope parameter and retrieves
all the information about the user Chris in the Contoso domain.

    Get-MailboxFolderStatistics -Identity contoso\chris




    -------------------------- EXAMPLE 2 --------------------------




    This example uses the FolderScope parameter to view the statistics
for calendar folders for the user Chris.

    Get-MailboxFolderStatistics -Identity Chris -FolderScope Calendar




    -------------------------- EXAMPLE 3 --------------------------
    This example uses the Archive parameter to view the statistics for
Ayla's archive.

       Get-MailboxFolderStatistics -Identity Ayla@contoso.com -Archive




       -------------------------- EXAMPLE 4 --------------------------




    This example uses the IncludeAnalysis parameter to view the
statistics of Tony's Recoverable Items folder.

    Get-MailboxFolderStatistics -Identity "Tony" -FolderScope
RecoverableItems -IncludeAnalysis




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/212ca564-
435e-4af6-8673-5564732bf118(EXCHG.141).aspx

NAME
       Get-MailboxJunkEmailConfiguration

SYNOPSIS
    Use the Get-MaillboxJunkEmailConfiguration cmdlet to view the junk e-
mail rule configuration for a specific mailbox.

SYNTAX
    Get-MailboxJunkEmailConfiguration -Identity <MailboxIdParameter> [-
Credential <PSCredential>] [-DomainController <Fqdn>] [-
ReadFromDomainContr
    oller <SwitchParameter>] [-ResultSize <Unlimited>]
[<CommonParameters>]


DESCRIPTION
    The junk e-mail rule helps Microsoft Outlook and Microsoft Office
Outlook Web App users to automatically remove any spam that gets past
anti-s
    pam filters and reaches the users' mailboxes. This cmdlet allows
users and administrators to view how the junk e-mail rule is configured
for a
     specific mailbox.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mail
    box junk e-mail configuration" entry in the Transport Permissions
topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the mailbox. You can use one of
the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias
        You can use the wildcard character (*) to view the junk e-mail
rule configuration for multiple mailboxes.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest
and don't use this parameter, it's possible that the user information is
re
        ad from a global catalog with outdated information. If you use
this parameter, multiple reads might be necessary to get the information.
        By default, the recipient scope is set to the domain that hosts
your servers that run Microsoft Exchange.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all mailboxes that match the query, use
        unlimited for the value of this parameter. The default value is
1000.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

    -------------------------- EXAMPLE 1 --------------------------




    This example displays the junk e-mail rule configuration for the user
David Pelton.

    Get-MailboxJunkEmailConfiguration -Identity "David Pelton"




    -------------------------- EXAMPLE 2 --------------------------
    This example displays the junk e-mail rule configuration for all
mailboxes in your organization that have the junk e-mail rule enabled.

    Get-MailboxJunkEmailConfiguration -Identity * | Where {$_.Enabled -eq
$true}




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/3d7e3a0a-
bf1f-4a88-9807-03e4ea9987b5(EXCHG.141).aspx

NAME
       Get-MailboxMessageConfiguration

SYNOPSIS
    Use the Get-MailboxMessageConfiguration cmdlet to view e-mail message
settings for a specified mailbox.

SYNTAX
    Get-MailboxMessageConfiguration -Identity <MailboxIdParameter> [-
Credential <PSCredential>] [-DomainController <Fqdn>] [-
ReadFromDomainControl
    ler <SwitchParameter>] [-ResultSize <Unlimited>] [<CommonParameters>]


DESCRIPTION
    The Get-MailboxMessageConfiguration cmdlet returns e-mail message
settings for the mailbox such as e-mail signature, message format,
message o
    ptions, read receipts, reading pane, and conversations.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"User
     options" entry in the Client Access Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the mailbox. You can use one of
the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest,
and if you don't use this parameter, it's possible that the user
informati
        on is read from a global catalog with outdated information. If
you use this parameter, multiple reads might be necessary to get the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your servers that run Exchange.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all mailboxes that match the query, use
        unlimited for the value of this parameter. The default value is
1000.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns e-mail message settings for Tony's mailbox.

    Get-MailboxMessageConfiguration -Identity tony




    -------------------------- EXAMPLE 2 --------------------------




    This example returns e-mail message settings for Tony's mailbox
specifying the domain controller to query these settings from Active
Directory
    .

    Get-MailboxMessageConfiguration -Identity tony -DomainController DC1
       -------------------------- EXAMPLE 3 --------------------------




       This example returns all e-mail message settings for Tony's mailbox.

       Get-MailboxMessageConfiguration -Identity tony -ResultSize unlimited




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/c9929748-
cd71-43c0-b1d9-a7f6cd2da99a(EXCHG.141).aspx

NAME
       Get-MailboxPermission

SYNOPSIS
    Use the Get-MailboxPermission cmdlet to get permissions on a mailbox.

SYNTAX
    Get-MailboxPermission -Identity <MailboxIdParameter> [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-ReadFromDomainController
<Switc
    hParameter>] [-ResultSize <Unlimited>] [-User
<SecurityPrincipalIdParameter>] [<CommonParameters>]

     Get-MailboxPermission -Identity <MailboxIdParameter> [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Owner <SwitchParameter>] [-
Read
     FromDomainController <SwitchParameter>] [-ResultSize <Unlimited>]
[<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mail
    box permissions and delegation" entry in the Mailbox Permissions
topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter identifies the mailbox. You can use one of
the following values:
        * GUID
        * ADObjectID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Owner <SwitchParameter>
        The Owner parameter returns the owner information for the mailbox
identified in the Identity parameter.
        This parameter can't be used with the User parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -ReadFromDomainController <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 if you don't use this parameter, it's possible that the user
i
        nformation is read from a global catalog with outdated
information.
        If you use this parameter, multiple reads might be necessary to
get the information.
        By default, the recipient scope is set to the domain that hosts
your servers that run Exchange.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of
recipient objects returned.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -User <SecurityPrincipalIdParameter>
        The User parameter specifies the UPN, domain\user, or the alias
of the user.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns permissions on the mailbox by its SMTP address
john@contoso.com.

    Get-MailboxPermission -Identity john@contoso.com | Format-List




    -------------------------- EXAMPLE 2 --------------------------




    This example returns permissions that the user Ayla has on John's
mailbox.

    Get-MailboxPermission -Identity john@contoso.com -User "Ayla"




    -------------------------- EXAMPLE 3 --------------------------




    This example returns the owner information for the resource mailbox
Room222.

    Get-MailboxPermission -Identity Room222 -Owner
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/56bcc678-
1598-4c9b-8b4f-4fa11c89ec41(EXCHG.141).aspx

NAME
       Get-MailboxPlan

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-MailboxPlan cmdlet to view information about the mailbox
plans in the organization.

SYNTAX
    Get-MailboxPlan [-Identity <MailboxPlanIdParameter>] [-
AllMailboxPlanReleases <SwitchParameter>] [-Capabilities
<MultiValuedProperty>] [-Crede
    ntial <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>]
[-IgnoreDefaultScope <SwitchParameter>] [-Organization
<OrganizationIdPara
    meter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-
SortBy
     <String>] [<CommonParameters>]


DESCRIPTION
    A mailbox plan is a template that automatically populates multiple
user properties and assigns default permissions to new or existing user
acc
    ounts.


PARAMETERS
    -Organization <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -AllMailboxPlanReleases <SwitchParameter>
         The AllMailboxPlanReleases parameter displays all mailbox plans
in the organization, including mailbox plans that were used in the
previou
         s version of the cloud-based service. If you don't specify the
AllMailboxPlanReleases parameter, the Get-MailboxPlan cmdlet only
displays
         mailbox plans that are used in the current version of the cloud-
based service. This parameter only has meaning for organizations that
were
          enrolled in the previous version of the cloud-based service.
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Capabilities <MultiValuedProperty>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password for
accessing the mailbox plan. The default is the current user's credential
        s.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter syntax used to
filter the results.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxPlanIdParameter>
        The Identity parameter specifies the mailbox plan. You can use
any value that uniquely identifies the mailbox plan, for example:
        * Distinguished name (DN)
        * Display Name
        * GUID
        * LegacyExchangeDN
        * Name

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
         The ResultSize parameter specifies the total number of items to
display.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. You can sort by t
        he following attributes:
        * Display name
        * Name
        * Alias
        The results are sorted in ascending order.

           Required?                      false
           Position?                      Named
           Default value
           Accept pipeline input?         False
           Accept wildcard characters?    false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




       This example returns all the mailbox plans in the organization.

       Get-MailboxPlan




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b30d2538-
8b04-4581-9663-87c964c58581(EXCHG.141).aspx

NAME
       Get-MailboxRegionalConfiguration

SYNOPSIS
    Use the Get-MailboxRegionalConfiguration cmdlet to retrieve regional
settings such as time zone, time format, date, and language settings for
    a specified mailbox.

SYNTAX
    Get-MailboxRegionalConfiguration -Identity <MailboxIdParameter> [-
DomainController <Fqdn>] [-VerifyDefaultFolderNameLanguage
<SwitchParameter>
    ] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"User
     options" entry in the Client Access Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter identifies the mailbox. You can use one of
the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -VerifyDefaultFolderNameLanguage <SwitchParameter>
        The VerifyDefaultFolderNameLangugage parameter specifies whether
the DefaultFolderNameMatchingUserLanguage property returned by the task i
        ndicates whether the mailbox default folder names are localized
with the language specified for the mailbox. If the
VerifyDefaultFolderNam
        eLangugage parameter is set to $true, the
DefaultFolderNameMatchingUserLanguage property returned by the task
indicates whether the mailbo
        x default folder names are localized with the language specified
for the mailbox. If this parameter isn't specified, the property isn't re
        turned by the task. This parameter can only be used by the
mailbox owner. If a non-mailbox-owner tries to run the command on the
mailbox w
        ith this parameter, an error is reported. The default value is
$false.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves regional settings for Tony's mailbox.

    Get-MailboxRegionalConfiguration -Identity tony




    -------------------------- EXAMPLE 2 --------------------------
    This example retrieves regional settings for Tony's mailbox,
requesting information from the domain controller closest to Tony's
mailbox.

    Get-MailboxRegionalConfiguration -Identity tony -DomainController
"DC1"




       -------------------------- EXAMPLE 3 --------------------------




    This example, in addition to returning regional settings for Tony's
mailbox, indicates whether the default folder names of the mailbox are
loc
    alized in the locale selected for the mailbox.

    Get-MailboxRegionalConfiguration -Identity tony -
VerifyDefaultFolderNameLanguage $true




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2a50a165-
5830-4771-8968-a13ab057532a(EXCHG.141).aspx

NAME
       Get-MailboxSpellingConfiguration

SYNOPSIS
    Use the Get-MailboxSpellingConfiguration cmdlet to retrieve the
Microsoft Office Outlook Web App spell checking settings of a specified
user.
    For example, users can set their dictionary language and configure
the spelling checker to ignore mixed digits and words in all uppercase.

SYNTAX
    Get-MailboxSpellingConfiguration -Identity <MailboxIdParameter> [-
DomainController <Fqdn>] [<CommonParameters>]


DESCRIPTION
    The Get-MailboxSpellingConfiguration cmdlet is primarily used to
populate the spell checking settings for end users in Outlook Web App.
Admini
    strators can also view users' settings by running this cmdlet in the
Exchange Management Shell. The following spell checking settings are retr
    ieved by the cmdlet for the specified mailbox:
    * Identity   This setting specifies the mailbox identity.
    * CheckBeforeSend   This setting specifies whether Outlook Web App
checks the spelling of every message when the user clicks Send in the new
m
      essage form.
    * DictionaryLanguage   This setting specifies the dictionary language
used when the spelling checker checks the spelling in messages.
    * IgnoreMixedDigits   This setting specifies whether the spelling
checker ignores words that contain numbers.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Publ
    ic folder administrative permissions" entry in the Mailbox
Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the mailbox. You can use one of
the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
          OutBuffer and OutVariable. For more information, type,
          "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the Outlook Web App options of user Tony.

    Get-MailboxSpellingConfiguration -Identity Tony




    -------------------------- EXAMPLE 2 --------------------------




    This example returns Outlook Web App spell checking options set on
Tony's mailbox by specifying domain controller DC1 to get the information
f
    rom Active Directory.

    Get-MailboxSpellingConfiguration -Identity Tony -DomainController DC1




    -------------------------- EXAMPLE 3 --------------------------




    This example returns the Outlook Web App spell checking options for
Tony's mailbox by specifying the identity of the mailbox in the format
dom
    ain\account.
       Get-MailboxSpellingConfiguration -Identity contoso\tony




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/7695cde3-
71d2-4523-8300-ada77cb8e7d4(EXCHG.141).aspx

NAME
       Get-MailboxStatistics

SYNOPSIS
    Use the Get-MailboxStatistics cmdlet to obtain information about a
mailbox, such as the size of the mailbox, the number of messages it
contain
    s, and the last time it was accessed. In addition, you can get the
move history or a move report of a completed move request.

SYNTAX
    Get-MailboxStatistics -Identity <GeneralMailboxOrMailUserIdParameter>
[-Archive <SwitchParameter>] [-DomainController <Fqdn>] [-IncludeMoveHis
    tory <SwitchParameter>] [-IncludeMoveReport <SwitchParameter>]
[<CommonParameters>]

    Get-MailboxStatistics -Database <DatabaseIdParameter> [-
DomainController <Fqdn>] [<CommonParameters>]

    Get-MailboxStatistics -Server <ServerIdParameter> [-DomainController
<Fqdn>] [<CommonParameters>]


DESCRIPTION
    On Mailbox servers only, you can use the Get-MailboxStatistics cmdlet
without parameters. In this case, the cmdlet returns the statistics for
    all mailboxes on all databases on the local server.
    The Get-MailboxStatistics cmdlet requires at least one of the
following parameters to complete successfully: Server, Database, or
Identity.
    You can use the Get-MailboxStatistics cmdlet to return detailed move
history and a move report for completed move requests to troubleshoot a m
    ove request. To view the move history, you must pass this cmdlet as
an object. Move histories are retained in the mailbox database and are
num
    bered incrementally, and the last executed move request is always
numbered 0. For more information, see "EXAMPLE 6," "EXAMPLE 7," and
"EXAMPLE
     8" later in this topic.
    You can only see move reports and move history for completed move
requests.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
    pient Provisioning Permissions" section in the Mailbox Permissions
topic.


PARAMETERS
    -Database <DatabaseIdParameter>
        The Database parameter specifies the name of the mailbox
database. When you specify a value for the Database parameter, the
Exchange Manag
        ement Shell returns statistics for all the mailboxes on the
database specified.
        You can use the following values:
        * GUID
        * Server\Database
        * Database
        This parameter accepts pipeline input from the Get-
MailboxDatabase cmdlet.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Identity <GeneralMailboxOrMailUserIdParameter>
         The Identity parameter specifies a mailbox. When you specify a
value for the Identity parameter, the command looks up the mailbox
specifie
         d in the Identity parameter, connects to the server where the
mailbox resides, and returns the statistics for the mailbox. You can use
one
          of the following values:
         * GUID
         * Distinguished name (DN)
         * Domain\Account
         * User principal name (UPN)
         * Legacy Exchange DN
         * SMTP address
         * Alias

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Server <ServerIdParameter>
        The Server parameter specifies the server from which you want to
obtain mailbox statistics. You can use one of the following values:
        * Fully qualified domain name (FQDN)
        * NetBIOS name
        When you specify a value for the Server parameter, the command
returns statistics for all the mailboxes on all the databases, including
re
        covery databases, on the specified server. If you don't specify
this parameter, the command returns logon statistics for the local
server.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Archive <SwitchParameter>
        The Archive switch parameter specifies whether to return mailbox
statistics for the archive mailbox associated with the specified mailbox.
        You don't have to specify a value with this parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IncludeMoveHistory <SwitchParameter>
         The IncludeMoveHistory switch specifies whether to return
additional information about the mailbox that includes the history of a
complete
         d move request, such as status, flags, target database, bad
items, start times, end times, duration that the move request was in
various s
         tages, and failure codes.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IncludeMoveReport <SwitchParameter>
        The IncludeMoveReport switch specifies whether to return a
verbose detailed move report for a completed move request, such as server
conne
        ctions and move stages.
        Because the output of this command is verbose, you should send
the output to a .CSV file for easier analysis.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the mailbox statistics for a mailbox by using
the alias AylaKol.

    Get-MailboxStatistics -Identity AylaKol




    -------------------------- EXAMPLE 2 --------------------------
    This example retrieves the mailbox statistics for all mailboxes on
the server MailboxServer01.

    Get-MailboxStatistics -Server MailboxServer01




    -------------------------- EXAMPLE 3 --------------------------




    This example retrieves the mailbox statistics for the specified
mailbox.

    Get-MailboxStatistics -Identity contoso\chris




    -------------------------- EXAMPLE 4 --------------------------




    This example retrieves the mailbox statistics for all mailboxes in
the specified mailbox database.

    Get-MailboxStatistics -Database "Mailbox Database"




    -------------------------- EXAMPLE 5 --------------------------




    This example retrieves the mailbox statistics for all disconnected
mailboxes. This example uses a WHERE clause. The $_ variable is used to
spe
    cify the object passed on the pipeline. The -ne operator means not
equal.

    Get-MailboxStatistics | Where {$_.DisconnectDate -ne $null}
       -------------------------- EXAMPLE 6 --------------------------




    This example returns the summary move history for the completed move
request for Ayla Kol's mailbox. If you don't pipeline the output to the F
    ormat-List cmdlet, the move history doesn't display.

       Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-
List




       -------------------------- EXAMPLE 7 --------------------------




    This example returns the detailed move history for the completed move
request for Ayla Kol's mailbox. This example uses a temporary variable t
    o store the mailbox statistics object. If the mailbox has been moved
multiple times, there will be multiple move reports. The last move report
     is always MoveReport[0].

       $temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory
       $temp.MoveHistory[0]




       -------------------------- EXAMPLE 8 --------------------------




    This example returns the detailed move history and a verbose detailed
move report for Ayla Kol's mailbox. This example uses a temporary variab
    le to store the move request statistics object and outputs the move
report to a CSV file.

       $temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport
       $temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/cec76f70-
941f-4bc9-b949-35dcc7671146(EXCHG.141).aspx

NAME
       Get-MailContact

SYNOPSIS
    Use the Get-MailContact cmdlet to retrieve all of the specified
contact attributes from Active Directory.

SYNTAX
    Get-MailContact [-Identity <MailContactIdParameter>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-
IgnoreDefaul
    tScope <SwitchParameter>] [-Organization <OrganizationIdParameter>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainCont
    roller <SwitchParameter>] [-RecipientTypeDetails
<RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<CommonParameters>]

    Get-MailContact [-Anr <String>] [-Credential <PSCredential>] [-
DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope
<SwitchParamet
    er>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParamet
    er>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize
<Unlimited>] [-SortBy <String>] [<CommonParameters>]


DESCRIPTION
    The Get-MailContact cmdlet retrieves all attributes of the specified
contact. No parameters are required. If the cmdlet is run without a param
    eter, a complete list of contacts for the Exchange organization is
returned.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
    pient Provisioning Permissions" section in the Mailbox Permissions
topic.


PARAMETERS
    -ANR <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the account to use to gain
access to Active Directory.
        If the Credential parameter is used, the command prompts for the
account's password before continuing.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailContactIdParameter>
        The Identity parameter identifies the contact. You can use one of
the following values:
        * ADObjectID
          *   Distinguished name (DN)
          *   LegacyExchangeDN
          *   GUID
          *   Domain\SamAccountName
          *   User principal name (UPN)
          *   E-mail address
          *   Alias

          Required?                       false
          Position?                       1
          Default value
          Accept pipeline input?          True
          Accept wildcard characters?     true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

          Required?                       false
          Position?                       Named
          Default value
          Accept pipeline input?          False
          Accept wildcard characters?     false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                       false
          Position?                       Named
          Default value
          Accept pipeline input?          False
          Accept wildcard characters?     false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
         The OrganizationalUnit parameter specifies a container in which
to limit the results. Either an organizational unit (OU) or a domain can
b
         e specified. Also, the canonical name should be specified, for
example:
         * OU: westcoast.contoso.com/users
         * Domain: westcoast.contoso.com
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest
and you don't use this parameter, it's possible that the user information
i
        s read from a global catalog with outdated information. If you
use this parameter, multiple reads might be necessary to get the
informatio
        n.
        By default, the recipient scope is set to the domain that hosts
your servers running Microsoft Exchange.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientTypeDetails <RecipientTypeDetails[]>
        The RecipientTypeDetails parameter specifies the type of
recipients returned. Recipient types are divided into recipient types and
subtype
        s. Each recipient type contains all common properties for all
subtypes. For example, the type UserMailbox represents a user account in
Act
        ive Directory that has an associated mailbox. Because there are
several mailbox types, each mailbox type is identified by the
RecipientTyp
        eDetails parameter. For example, a conference room mailbox has
RecipientTypeDetails set to ConferenceRoomMailbox, whereas a user mailbox
h
        as RecipientTypeDetails set to UserMailbox.
        You can select from the following values:
        * ArbitrationMailbox
        * ConferenceRoomMailbox
        * Contact
        * DiscoveryMailbox
        * DynamicDistributionGroup
        * EquipmentMailbox
        * ExternalManagedContact
        * ExternalManagedDistributionGroup
        * LegacyMailbox
        * LinkedMailbox
        * MailboxPlan
        * MailContact
          *   MailForestContact
          *   MailNonUniversalGroup
          *   MailUniversalDistributionGroup
          *   MailUniversalSecurityGroup
          *   MailUser
          *   PublicFolder
          *   RoleGroup
          *   RoomList
          *   RoomMailbox
          *   SharedMailbox
          *   SystemAttendantMailbox
          *   SystemMailbox
          *   User
          *   UserMailbox

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the total number of recipient
objects to return. If not specified, the parameter returns all results th
        at match the filter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. Sorting is performed one attribute at a time and is always perf
        ormed in ascending order.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
       (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example retrieves the mail-enabled contact named Arlene.

       Get-MailContact -Identity Arlene | Format-List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/d254bdd5-
d497-424c-97ad-d7e8f7e73c27(EXCHG.141).aspx

NAME
       Get-MailUser

SYNOPSIS
    Use the Get-MailUser cmdlet to retrieve the specified user's mail-
related attributes from Active Directory.

SYNTAX
    get-MailUser [-Identity <MailUserIdParameter>] [-Capabilities
<MultiValuedProperty>] [-Credential <PSCredential>] [-DomainController
<Fqdn>] [
    -Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-
Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitId
    Parameter>] [-ReadFromDomainController <SwitchParameter>] [-
ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]

    get-MailUser [-ArchiveDatabase <DatabaseIdParameter>] [-Capabilities
<MultiValuedProperty>] [-Credential <PSCredential>] [-DomainController <F
    qdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-
Organization <OrganizationIdParameter>] [-OrganizationalUnit
<Organizationa
    lUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-
ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]

    get-MailUser [-Anr <String>] [-Capabilities <MultiValuedProperty>] [-
Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>]
    [-IgnoreDefaultScope <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-Read
    FromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-
SortBy <String>] [<CommonParameters>]


DESCRIPTION
    The Get-MailUser cmdlet retrieves all mail-related attributes of the
specified user.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
    pient Provisioning Permissions" section in the Mailbox Permissions
topic.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ArchiveDatabase <DatabaseIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false
    -Capabilities <MultiValuedProperty>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the account to use to gain
access to Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailUserIdParameter>
        The Identity parameter identifies the user. You can use one of
the following values:
        * ADObjectID
        * Distinguished name (DN)
        * LegacyExchangeDN
          *   GUID
          *   Domain\SamAccountName
          *   User principal name (UPN)
          *   E-mail address
          *   Alias

          Required?                       false
          Position?                       1
          Default value
          Accept pipeline input?          True
          Accept wildcard characters?     true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

          Required?                       false
          Position?                       Named
          Default value
          Accept pipeline input?          False
          Accept wildcard characters?     false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                       false
          Position?                       Named
          Default value
          Accept pipeline input?          False
          Accept wildcard characters?     false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies a container in which
to limit the results. You can specify either an organizational unit (OU)
o
        r a domain. The canonical name should be specified, for example:
        * OU: westcoast.contoso.com/users
        * Domain: westcoast.contoso.com

          Required?                       false
          Position?                       Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest
and don't use this parameter, it's possible that the user information is
re
        ad from a global catalog with outdated information. If you use
this parameter, multiple reads might be necessary to get the information.
        By default, the recipient scope is set to the domain that hosts
your servers that run Exchange.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of
recipient objects to return. If not specified, the parameter returns all
results
        that match the filter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. Sorting is performed one attribute at a time and is always perf
        ormed in ascending order.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS
TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example retrieves a complete list of mail-enabled users for the
entire Exchange organization.

       Get-MailUser




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the settings for the mail user named Ed, and
then the command is piped to the Format-List cmdlet for display.

       Get-MailUser -Identity Ed | Format-List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/37b36f1c-
95ec-4896-a08a-985ef4aa23b7(EXCHG.141).aspx

NAME
       Get-ManagementRole

SYNOPSIS
    Use the Get-ManagementRole cmdlet to view management roles that have
been created in your organization.

SYNTAX
    Get-ManagementRole [-Identity <RoleIdParameter>] [-Cmdlet <String>]
[-CmdletParameters <String[]>] [-DomainController <Fqdn>] [-Organization
<
    OrganizationIdParameter>] [-RoleType <Custom | UnScoped |
OrganizationManagement | RecipientManagement |
ViewOnlyOrganizationManagement | Dist
    ributionGroupManagement | MyDistributionGroups |
MyDistributionGroupMembership | UmManagement | RecordsManagement |
MyBaseOptions | UmRecipien
    tManagement | HelpdeskRecipientManagement |
GALSynchronizationManagement | ApplicationImpersonation |
UMPromptManagement | PartnerDelegatedTen
    antManagement | DiscoveryManagement | CentralAdminManagement |
UnScopedRoleManagement | MyContactInformation | MyProfileInformation |
MyVoiceM
    ail | MyTextMessaging | MyMailSubscriptions | MyRetentionPolicies |
MyOptions | MailRecipients | FederatedSharing |
DatabaseAvailabilityGroups
     | Databases | PublicFolders | AddressLists | RecipientPolicies |
DisasterRecovery | Monitoring | DatabaseCopies | UnifiedMessaging |
Journali
    ng | RemoteAndAcceptedDomains | EmailAddressPolicies | TransportRules
| SendConnectors | EdgeSubscriptions | OrganizationTransportSettings | E
    xchangeServers | ExchangeVirtualDirectories |
ExchangeServerCertificates | POP3AndIMAP4Protocols | ReceiveConnectors |
UMMailboxes | UserOptio
    ns | SecurityGroupCreationAndMembership | MailRecipientCreation |
MessageTracking | RoleManagement | ViewOnlyRecipients |
ViewOnlyConfiguratio
    n | DistributionGroups | MailEnabledPublicFolders | MoveMailboxes |
ResetPassword | AuditLogs | RetentionManagement | SupportDiagnostics |
Mai
    lboxSearch | LegalHold | MailTips | PublicFolderReplication |
ActiveDirectoryPermissions | UMPrompts | Migration | DataCenterOperations
| Tran
    sportHygiene | TransportQueues | Supervision | CmdletExtensionAgents
| OrganizationConfiguration | OrganizationClientAccess | ExchangeConnecto
    rs | MailboxImportExport | ViewOnlyCentralAdminManagement |
ViewOnlyCentralAdminSupport | ViewOnlyRoleManagement | Reporting |
ViewOnlyAuditLo
    gs | TransportAgents | InformationRightsManagement |
LawEnforcementRequests | MyDiagnostics>] [<CommonParameters>]

    Get-ManagementRole -Identity <RoleIdParameter> -Recurse
<SwitchParameter> [-DomainController <Fqdn>] [-Organization
<OrganizationIdParameter>]
     [-RoleType <Custom | UnScoped | OrganizationManagement |
RecipientManagement | ViewOnlyOrganizationManagement |
DistributionGroupManagement |
      MyDistributionGroups | MyDistributionGroupMembership | UmManagement
| RecordsManagement | MyBaseOptions | UmRecipientManagement | HelpdeskRec
     ipientManagement | GALSynchronizationManagement |
ApplicationImpersonation | UMPromptManagement |
PartnerDelegatedTenantManagement | Discovery
     Management | CentralAdminManagement | UnScopedRoleManagement |
MyContactInformation | MyProfileInformation | MyVoiceMail |
MyTextMessaging | M
     yMailSubscriptions | MyRetentionPolicies | MyOptions | MailRecipients
| FederatedSharing | DatabaseAvailabilityGroups | Databases | PublicFold
     ers | AddressLists | RecipientPolicies | DisasterRecovery |
Monitoring | DatabaseCopies | UnifiedMessaging | Journaling |
RemoteAndAcceptedDom
     ains | EmailAddressPolicies | TransportRules | SendConnectors |
EdgeSubscriptions | OrganizationTransportSettings | ExchangeServers |
Exchange
     VirtualDirectories | ExchangeServerCertificates |
POP3AndIMAP4Protocols | ReceiveConnectors | UMMailboxes | UserOptions |
SecurityGroupCreatio
     nAndMembership | MailRecipientCreation | MessageTracking |
RoleManagement | ViewOnlyRecipients | ViewOnlyConfiguration |
DistributionGroups |
     MailEnabledPublicFolders | MoveMailboxes | ResetPassword | AuditLogs
| RetentionManagement | SupportDiagnostics | MailboxSearch | LegalHold |
     MailTips | PublicFolderReplication | ActiveDirectoryPermissions |
UMPrompts | Migration | DataCenterOperations | TransportHygiene |
TransportQ
     ueues | Supervision | CmdletExtensionAgents |
OrganizationConfiguration | OrganizationClientAccess | ExchangeConnectors
| MailboxImportExport
     | ViewOnlyCentralAdminManagement | ViewOnlyCentralAdminSupport |
ViewOnlyRoleManagement | Reporting | ViewOnlyAuditLogs | TransportAgents
| In
     formationRightsManagement | LawEnforcementRequests | MyDiagnostics>]
[<CommonParameters>]

    Get-ManagementRole -Identity <RoleIdParameter> -GetChildren
<SwitchParameter> [-DomainController <Fqdn>] [-Organization
<OrganizationIdParamet
    er>] [-RoleType <Custom | UnScoped | OrganizationManagement |
RecipientManagement | ViewOnlyOrganizationManagement |
DistributionGroupManageme
    nt | MyDistributionGroups | MyDistributionGroupMembership |
UmManagement | RecordsManagement | MyBaseOptions | UmRecipientManagement
| Helpdes
    kRecipientManagement | GALSynchronizationManagement |
ApplicationImpersonation | UMPromptManagement |
PartnerDelegatedTenantManagement | Disco
    veryManagement | CentralAdminManagement | UnScopedRoleManagement |
MyContactInformation | MyProfileInformation | MyVoiceMail |
MyTextMessaging
     | MyMailSubscriptions | MyRetentionPolicies | MyOptions |
MailRecipients | FederatedSharing | DatabaseAvailabilityGroups |
Databases | Public
     Folders | AddressLists | RecipientPolicies | DisasterRecovery |
Monitoring | DatabaseCopies | UnifiedMessaging | Journaling |
RemoteAndAccepte
     dDomains | EmailAddressPolicies | TransportRules | SendConnectors |
EdgeSubscriptions | OrganizationTransportSettings | ExchangeServers |
Exch
     angeVirtualDirectories | ExchangeServerCertificates |
POP3AndIMAP4Protocols | ReceiveConnectors | UMMailboxes | UserOptions |
SecurityGroupCre
     ationAndMembership | MailRecipientCreation | MessageTracking |
RoleManagement | ViewOnlyRecipients | ViewOnlyConfiguration |
DistributionGroup
     s | MailEnabledPublicFolders | MoveMailboxes | ResetPassword |
AuditLogs | RetentionManagement | SupportDiagnostics | MailboxSearch |
LegalHol
     d | MailTips | PublicFolderReplication | ActiveDirectoryPermissions |
UMPrompts | Migration | DataCenterOperations | TransportHygiene | Transp
     ortQueues | Supervision | CmdletExtensionAgents |
OrganizationConfiguration | OrganizationClientAccess | ExchangeConnectors
| MailboxImportExp
     ort | ViewOnlyCentralAdminManagement | ViewOnlyCentralAdminSupport |
ViewOnlyRoleManagement | Reporting | ViewOnlyAuditLogs | TransportAgents
     | InformationRightsManagement | LawEnforcementRequests |
MyDiagnostics>] [<CommonParameters>]

    Get-ManagementRole [-Identity <RoleIdParameter>] [-DomainController
<Fqdn>] [-Organization <OrganizationIdParameter>] [-Script <String>] [-
Scr
    iptParameters <String[]>] [<CommonParameters>]


DESCRIPTION
    You can view management roles in several ways, from listing all the
roles in your organization to listing only the child roles of a specified
    parent role. You can also view the details of a specific role by
piping the output of the Get-ManagementRole cmdlet to the Format-List
cmdlet.
    For more information about management roles, see Understanding
Management Roles.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mana
    gement roles" entry in the Role Management Permissions topic.


PARAMETERS
    -GetChildren <SwitchParameter>
        The GetChildren parameter retrieves a list of all the roles that
were created based on the parent role specified in the Identity parameter
        . Only the immediate child roles of the parent role are included.
The GetChildren parameter can only be used with the Identity and RoleTyp
        e parameters.
        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <RoleIdParameter>
        The Identity parameter specifies the role you want to view. If
the role you want to view contains spaces, enclose the name in quotation
ma
        rks ("). You can use the wildcard character (*) and a partial
role name to match multiple roles.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Recurse <SwitchParameter>
        The Recurse parameter retrieves a list of all the roles that were
created based on the parent role specified in the Identity parameter. Th
        e role specified in the Identity parameter, its child roles, and
their children are returned. The Recurse parameter can only be used with
        the Identity and RoleType parameters.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Cmdlet <String>
        The Cmdlet parameter returns a list of all roles that include the
specified cmdlet.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -CmdletParameters <String[]>
        The CmdletParameters parameter returns a list of all roles that
include the specified parameter or parameters. You can specify more than
o
        ne parameter by separating each parameter with a comma. If you
specify multiple parameters, only the roles that include all of the
specifi
        ed parameters are returned.

        Required?                     false
        Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -RoleType <Custom | UnScoped | OrganizationManagement |
RecipientManagement | ViewOnlyOrganizationManagement |
DistributionGroupManagement | M
    yDistributionGroups | MyDistributionGroupMembership | UmManagement |
RecordsManagement | MyBaseOptions | UmRecipientManagement | HelpdeskRecip
    ientManagement | GALSynchronizationManagement |
ApplicationImpersonation | UMPromptManagement |
PartnerDelegatedTenantManagement | DiscoveryMa
    nagement | CentralAdminManagement | UnScopedRoleManagement |
MyContactInformation | MyProfileInformation | MyVoiceMail |
MyTextMessaging | MyM
    ailSubscriptions | MyRetentionPolicies | MyOptions | MailRecipients |
FederatedSharing | DatabaseAvailabilityGroups | Databases | PublicFolder
    s | AddressLists | RecipientPolicies | DisasterRecovery | Monitoring
| DatabaseCopies | UnifiedMessaging | Journaling | RemoteAndAcceptedDomai
    ns | EmailAddressPolicies | TransportRules | SendConnectors |
EdgeSubscriptions | OrganizationTransportSettings | ExchangeServers |
ExchangeVi
    rtualDirectories | ExchangeServerCertificates | POP3AndIMAP4Protocols
| ReceiveConnectors | UMMailboxes | UserOptions | SecurityGroupCreationA
    ndMembership | MailRecipientCreation | MessageTracking |
RoleManagement | ViewOnlyRecipients | ViewOnlyConfiguration |
DistributionGroups | Ma
    ilEnabledPublicFolders | MoveMailboxes | ResetPassword | AuditLogs |
RetentionManagement | SupportDiagnostics | MailboxSearch | LegalHold | Ma
    ilTips | PublicFolderReplication | ActiveDirectoryPermissions |
UMPrompts | Migration | DataCenterOperations | TransportHygiene |
TransportQue
    ues | Supervision | CmdletExtensionAgents | OrganizationConfiguration
| OrganizationClientAccess | ExchangeConnectors | MailboxImportExport |
    ViewOnlyCentralAdminManagement | ViewOnlyCentralAdminSupport |
ViewOnlyRoleManagement | Reporting | ViewOnlyAuditLogs | TransportAgents
| Info
    rmationRightsManagement | LawEnforcementRequests | MyDiagnostics>
        The RoleType parameter returns a list of roles that match the
specified role type. For a list of valid role types, see Understanding
Manag
        ement Roles.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Script <String>
        The Script parameter returns a list of all roles that include the
specified script.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ScriptParameters <String[]>
        The ScriptParameters parameter returns a list of all roles that
include the specified parameter or parameters. You can specify more than
o
        ne parameter by separating each parameter with a comma. If you
specify multiple parameters, only the roles that include all of the
specifi
        ed parameters are returned.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )
    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example lists all the roles that have been created in your
organization.

    Get-ManagementRole




    -------------------------- EXAMPLE 2 --------------------------




    This example lists all the roles that are children of the Mail
Recipients management role. The command performs a recursive query of all
the c
    hild roles of the specified parent role. This recursive query finds
every child role from the immediate children of the parent to the last
chi
    ld role in the hierarchy. In a recursive list, the parent role is
also returned in the list.

    Get-ManagementRole "Mail Recipients" -Recurse




    -------------------------- EXAMPLE 3 --------------------------




    This example lists all the roles that contain both the Identity and
Database parameters. Roles that contain only one parameter or the other
ar
    en't returned.

    Get-ManagementRole -CmdletParameters Identity, Database
    -------------------------- EXAMPLE 4 --------------------------




    This example lists all the roles that have a type of
UnScopedTopLevel. These roles contain custom scripts or non-Exchange
cmdlets.

    Get-ManagementRole -RoleType UnScopedTopLevel




    -------------------------- EXAMPLE 5 --------------------------




    This example retrieves only the Transport Rules role and passes the
output of the Get-ManagementRole cmdlet to the Format-List cmdlet. The
For
    mat-List cmdlet then shows only the Name and RoleType properties of
the Transport Rules role. For more information about pipelining and the
Fo
    rmat-List cmdlet, see Pipelining and Working with Command Output.

    Get-ManagementRole "Transport Rules" | Format-List Name, RoleType




    -------------------------- EXAMPLE 6 --------------------------




    This example lists the immediate children of the Mail Recipients
role. Only the child roles that hold the Mail Recipients role as their
parent
     role are returned. The Mail Recipients role isn't returned in the
list.

    Get-ManagementRole "Mail Recipients" -GetChildren
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/c3a48baa-
ee7d-4615-88e3-5798443dee35(EXCHG.141).aspx

NAME
       Get-ManagementRoleAssignment

SYNOPSIS
    Use the Get-ManagementRoleAssignment cmdlet to retrieve management
role assignments.

SYNTAX
    Get-ManagementRoleAssignment [-Identity <RoleAssignmentIdParameter>]
[-ConfigWriteScope <None | NotApplicable | OrganizationConfig | CustomCon
    figScope | PartnerDelegatedTenantScope | ExclusiveConfigScope>] [-
CustomConfigWriteScope <ManagementScopeIdParameter>] [-
CustomRecipientWriteS
    cope <ManagementScopeIdParameter>] [-Delegating <$true | $false>] [-
DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exclusive <$true |
    $false>] [-ExclusiveConfigWriteScope <ManagementScopeIdParameter>] [-
ExclusiveRecipientWriteScope <ManagementScopeIdParameter>] [-GetEffective
    Users <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-
RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>] [-Recip
    ientWriteScope <None | NotApplicable | Organization | MyGAL | Self |
MyDirectReports | OU | CustomRecipientScope | MyDistributionGroups | MyEx
    ecutive | ExclusiveRecipientScope>] [-RoleAssigneeType <User |
SecurityGroup | RoleAssignmentPolicy | MailboxPlan |
ForeignSecurityPrincipal |
     RoleGroup | LinkedRoleGroup | Computer | PartnerLinkedRoleGroup>] [-
WritableDatabase <DatabaseIdParameter>] [-WritableRecipient <GeneralRecip
    ientIdParameter>] [-WritableServer <ServerIdParameter>]
[<CommonParameters>]

     Get-ManagementRoleAssignment [-AssignmentMethod <AssignmentMethod[]>]
[-ConfigWriteScope <None | NotApplicable | OrganizationConfig | CustomCo
     nfigScope | PartnerDelegatedTenantScope | ExclusiveConfigScope>] [-
CustomConfigWriteScope <ManagementScopeIdParameter>] [-
CustomRecipientWrite
     Scope <ManagementScopeIdParameter>] [-Delegating <$true | $false>] [-
DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exclusive <$true |
      $false>] [-ExclusiveConfigWriteScope <ManagementScopeIdParameter>]
[-ExclusiveRecipientWriteScope <ManagementScopeIdParameter>] [-
GetEffectiv
     eUsers <SwitchParameter>] [-Organization <OrganizationIdParameter>]
[-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>] [-
Reci
     pientWriteScope <None | NotApplicable | Organization | MyGAL | Self |
MyDirectReports | OU | CustomRecipientScope | MyDistributionGroups | MyE
     xecutive | ExclusiveRecipientScope>] [-Role <RoleIdParameter>] [-
RoleAssignee <RoleAssigneeIdParameter>] [-RoleAssigneeType <User |
SecurityGr
     oup | RoleAssignmentPolicy | MailboxPlan | ForeignSecurityPrincipal |
RoleGroup | LinkedRoleGroup | Computer | PartnerLinkedRoleGroup>] [-Writ
    ableDatabase <DatabaseIdParameter>] [-WritableRecipient
<GeneralRecipientIdParameter>] [-WritableServer <ServerIdParameter>]
[<CommonParameter
    s>]


DESCRIPTION
    You can retrieve role assignments in a variety of ways including by
assignment type, scope type, or name, and whether the assignment is
enable
    d or disabled. You can also view a list of role assignments that
provide access to a specified recipient, server, or database.
    For more information about management role assignments, see
Understanding Management Role Assignments.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Role
     assignments" entry in the Role Management Permissions topic.


PARAMETERS
    -AssignmentMethod <AssignmentMethod[]>
        The AssignmentMethod parameter specifies the type of role
assignment to include in the results returned by the cmdlet. You can
specify one
         or more of the following values:
        * Direct
        * SecurityGroup
        * RoleGroup
        * RoleAssignmentPolicy
        If you provide more than one value, separate each value with a
comma.
        You must specify a value with the RoleAssignee parameter if you
use the AssignmentMethod parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ConfigWriteScope <None | NotApplicable | OrganizationConfig |
CustomConfigScope | PartnerDelegatedTenantScope | ExclusiveConfigScope>
        The ConfigWriteScope parameter specifies the type of management
configuration scope to include in the results returned by the cmdlet. The
        valid values are None, OrganizationConfig, CustomConfigScope, and
ExclusiveConfigScope.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -CustomConfigWriteScope <ManagementScopeIdParameter>
         The CustomConfigWriteScope parameter returns only the regular
role assignments that include the specified configuration-based regular
scop
         e.
         This parameter can only be used to retrieve regular
configuration-based scopes. To retrieve a list of exclusive
configuration-based scopes
         , use the ExclusiveConfigWriteScope parameter instead.
         If the scope name contains spaces, enclose it in quotation marks
(").

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -CustomRecipientWriteScope <ManagementScopeIdParameter>
         The CustomRecipientWriteScope parameter returns only the regular
role assignments that include the specified recipient-based regular scope
         .
         This parameter can only be used to retrieve regular recipient-
based scopes. To retrieve a list of exclusive recipient-based scopes, use
th
         e ExclusiveRecipientWriteScope parameter instead.
         If the scope name contains spaces, enclose it in quotation marks
(").

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -Delegating <$true | $false>
         The Delegating parameter specifies whether delegating or regular
role assignments should be returned.
         By default, both delegating and regular scopes are returned. To
return only delegating role assignments, specify a value of $True. To
retu
         rn only regular role assignments, specify a value of $False.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Enabled <$true | $false>
        The Enabled parameter specifies whether enabled or disabled role
assignments should be returned. To return enabled role assignments, speci
        fy a value of $True. To return disabled role assignments, specify
a value of $False.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Exclusive <$true | $false>
        The Exclusive parameter specifies whether exclusive or regular
role assignments should be returned.
        By default, both exclusive and regular scopes are returned. To
return only exclusive role assignments, specify a value of $True. To
return
         only regular role assignments, specify a value of $False.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ExclusiveConfigWriteScope <ManagementScopeIdParameter>
         The ExclusiveConfigWriteScope parameter returns only the
exclusive role assignments that include the specified configuration-based
exclusi
         ve scope.
         This parameter can only be used to retrieve exclusive
configuration-based scopes. To retrieve a list of regular configuration-
based scopes
         , use the CustomConfigWriteScope parameter instead.
         If the scope name contains spaces, enclose it in quotation marks
(").

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
     -ExclusiveRecipientWriteScope <ManagementScopeIdParameter>
         The ExclusiveRecipientWriteScope parameter returns only the
exclusive role assignments that include the specified recipient-based
exclusiv
         e scope.
         This parameter can only be used to retrieve exclusive recipient-
based scopes. To retrieve a list of regular recipient-based scopes, use
th
         e CustomRecipientWriteScope parameter instead.
         If the scope name contains spaces, enclose it in quotation marks
(").

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -GetEffectiveUsers <SwitchParameter>
        The GetEffectiveUsers switch specifies that the command should
show the list of users in the role groups, assignment policies, or USGs
ass
        ociated with a role assignment. The users are effectively
assigned the role assignment through their role group, assignment policy,
or USG
        .

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <RoleAssignmentIdParameter>
        The Identity parameter specifies the name of the role assignment
to retrieve. If the name of the role assignment contains spaces, enclose
        it in quotation marks ("). If the RoleAssignee parameter is used,
you can't use the Identity parameter.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>
        The RecipientOrganizationalUnitScope parameter returns only the
role assignments that include the specified organizational unit (OU). If
t
        he OU tree contains spaces, enclose it in quotation marks (").

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientWriteScope <None | NotApplicable | Organization | MyGAL |
Self | MyDirectReports | OU | CustomRecipientScope | MyDistributionGroups
    | MyExecutive | ExclusiveRecipientScope>
        The RecipientWriteScope parameter returns only the role
assignments associated with the recipient scope restriction type
specified. The va
        lid values are None, MyGAL, Self, OU, CustomRecipientScope,
MyDistributionGroups, and ExclusiveRecipientScope.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Role <RoleIdParameter>
        The Role parameter returns only the role assignments associated
with the specified management role. If the name of the role contains
space
        s, enclose it in quotation marks (").

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

     -RoleAssignee <RoleAssigneeIdParameter>
         The RoleAssignee parameter specifies the role group, assignment
policy, user, or universal security group (USG) for which you want to
view
          role assignments. If the RoleAssignee parameter is used, you
can't use the Identity parameter.
         By default, the command returns both direct role assignments to
the role assignee, and indirect role assignments granted to a role
assigne
         e through role groups or assignment policies.
         If the name of the user or USG contains spaces, enclose it in
quotation marks (").
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RoleAssigneeType <User | SecurityGroup | RoleAssignmentPolicy |
MailboxPlan | ForeignSecurityPrincipal | RoleGroup | LinkedRoleGroup |
Comput
    er | PartnerLinkedRoleGroup>
        The RoleAssigneeType parameter specifies the type of role
assignee to return. The valid values are User, SecurityGroup,
RoleAssignmentPoli
        cy, ForeignSecurityPrincipal, RoleGroup, and LinkedRoleGroup.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WritableDatabase <DatabaseIdParameter>
         The WritableDatabase parameter specifies the database object you
want to test to determine which role assignments allow it to be modified.
          The command takes into account the roles and scopes associated
with each role assignment. If the database name contains spaces, enclose
i
         t in quotation marks (").
         If this parameter is used with the GetEffectiveUsers switch, all
the users who can modify the database object indirectly through role grou
         ps and USGs are also returned. Without the GetEffectiveUsers
switch, only the role groups, users, and USGs directly assigned the role
assi
         gnment are returned.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -WritableRecipient <GeneralRecipientIdParameter>
        The WritableRecipient parameter specifies the recipient object
you want to test to determine which role assignments allow it to be
modifie
        d. The command takes into account the roles and scopes associated
with each role assignment. If the recipient name contains spaces, enclos
        e it in quotation marks (").
        If this parameter is used with the GetEffectiveUsers switch, all
of the users who can modify the recipient object indirectly through role
        groups and USGs are also returned. Without the GetEffectiveUsers
switch, only the role groups, users, and USGs directly assigned the role
        assignment are returned.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -WritableServer <ServerIdParameter>
        The WritableServer parameter specifies the server object you want
to test to determine which role assignments allow it to be modified. The
         command takes into account the roles and scopes associated with
each role assignment. If the server object name contains spaces, enclose
        it in quotation marks (").
        If this parameter is used with the GetEffectiveUsers switch, all
of the users who can modify the server object indirectly through role gro
        ups and USGs are also returned. Without the GetEffectiveUsers
switch, only the role groups, users, and USGs directly assigned the role
ass
        ignment are returned.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the Denver Help Desk role assignment using the
Get-ManagementRoleAssignment cmdlet and pipes the output to the Format-L
    ist cmdlet. For more information about the Format-List cmdlet, see
Working with Command Output.

    Get-ManagementRoleAssignment "Denver Help Desk" | Format-List
    -------------------------- EXAMPLE 2 --------------------------




    This example retrieves all the role assignments that are enabled and
have been designated as delegating role assignments.

    Get-ManagementRoleAssignment -Enabled $True -Delegating $True




    -------------------------- EXAMPLE 3 --------------------------




    This example retrieves all the role assignments that include the
MyGAL recipient-based scope restriction type.

    Get-ManagementRoleAssignment -RecipientWriteScope MyGAL




    -------------------------- EXAMPLE 4 --------------------------




    This example retrieves all the role assignments associated with the
Organization Management management role.

    Get-ManagementRoleAssignment -Role "Mail Recipients"




    -------------------------- EXAMPLE 5 --------------------------




    This example retrieves a list of all the users and the role
assignments that can modify the recipient Bob.
    Get-ManagementRoleAssignment -WritableRecipient Bob -
GetEffectiveUsers




       -------------------------- EXAMPLE 6 --------------------------




    This example retrieves a list of all exclusive scopes that can modify
server objects that match Redmond Executive Servers. The command also li
    sts the users who are effectively assigned the role assignments
through role groups or USGs.

    Get-ManagementRoleAssignment -ExclusiveConfigWriteScope "Redmond
Executive Servers" -GetEffectiveUsers




       -------------------------- EXAMPLE 7 --------------------------




    This example retrieves all the role assignments that can modify the
database Contoso Sales.

       Get-ManagementRoleAssignment -WritableDatabase "Contoso Sales"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/a3a6ee46-
061b-444a-8639-43a416309445(EXCHG.141).aspx

NAME
       Get-ManagementRoleEntry

SYNOPSIS
    Use the Get-ManagementRoleEntry cmdlet to retrieve management role
entries that have been configured on management roles.

SYNTAX
    Get-ManagementRoleEntry -Identity <RoleEntryIdParameter> [-
DomainController <Fqdn>] [-Parameters <String[]>] [-PSSnapinName
<String>] [-Type <
    ManagementRoleEntryType[]>] [<CommonParameters>]


DESCRIPTION
     The Get-ManagementRoleEntry cmdlet retrieves role entries that have
been configured on roles. You can retrieve specific role entries that
matc
     h specific criteria such as role name, cmdlet name, parameter name,
or a combination of each, or role entry type or the associated Windows
Pow
     erShell snap-in.
     For more information about management role entries, see Understanding
Management Roles.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mana
     gement role entries" entry in the Role Management Permissions topic.


PARAMETERS
    -Identity <RoleEntryIdParameter>
        The Identity parameter specifies the role entry to retrieve. You
must specify the value of the Identity parameter in the format, <manageme
        nt role>\<role entry name>, for example, ExampleRole\Set-Mailbox.
        For more information about how management role entries work, see
Understanding Management Roles.
        You can use the wildcard character (*) instead of the role,
cmdlet name, or both.
        If the role entry name contains spaces, enclose the name in
quotation marks (").

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -Parameters <String[]>
        The Parameters parameter includes only the role entries that
contain the parameters specified. You can specify multiple parameters,
separa
        ted by commas. You can use the wildcard character (*) with
partial parameter names to retrieve all parameters that match the value
you spe
        cify.
        This parameter is useful when you use the wildcard character (*)
with the value you specify in the Identity parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -PSSnapinName <String>
        The PSSnapinName parameter specifies the Windows PowerShell snap-
in that contains the role entry to return. Use the Get-PSSnapin cmdlet to
         retrieve a list of available Windows PowerShell snap-ins.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Type <ManagementRoleEntryType[]>
         The Type parameter specifies the type of role entry to return.
The valid values for the Type parameter are any combination of the
followin
         g parameters, separated by commas: Cmdlet, Script, and
ApplicationPermission.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )
    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves a list of all the role entries that exist on
the Transport Rules management role.

    Get-ManagementRoleEntry "Transport Rules\*"




    -------------------------- EXAMPLE 2 --------------------------




    This example retrieves a list of all the role entries that contain
the Get-Recipient cmdlet.

    Get-ManagementRoleEntry *\Get-Recipient




    -------------------------- EXAMPLE 3 --------------------------




    This example retrieves the Tier 2 Help Desk\Set-Mailbox role entry
and pipes the output of the Get-ManagementRoleEntry cmdlet to the Format-
Li
    st cmdlet. The Format-List cmdlet then outputs only the Name,
Parameters, Role, and Type properties from the role entry.

    Get-ManagementRoleEntry "Tier 2 Help Desk\Set-Mailbox" | Format-List
Name, Parameters, Role, Type




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/3b58e5dc-
0e57-4998-82cb-94dc081f6420(EXCHG.141).aspx

NAME
       Get-ManagementScope

SYNOPSIS
    Use the Get-ManagementScope cmdlet to return a list of management
scopes.

SYNTAX
    Get-ManagementScope [-Identity <ManagementScopeIdParameter>] [-
DomainController <Fqdn>] [-Exclusive <$true | $false>] [-Organization
<Organiza
    tionIdParameter>] [-Orphan <SwitchParameter>] [<CommonParameters>]


DESCRIPTION
    You can retrieve one scope or many, retrieve only scopes that aren't
associated with management role assignments, or retrieve scopes that are
    exclusive or regular scopes.
    For more information about regular and exclusive scopes, see
Understanding Management Role Scopes.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mana
    gement scopes" entry in the Role Management Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Exclusive <$true | $false>
        The Exclusive parameter specifies whether exclusive scopes should
be returned. If the Exclusive parameter isn't specified, regular scopes
        and exclusive scopes are returned. If the Exclusive parameter is
set to $True, only exclusive scopes are returned. If the Exclusive parame
        ter is set to $False, only regular scopes are returned. The valid
values are $True and $False.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <ManagementScopeIdParameter>
        The Identity parameter specifies the name of the management scope
to return. If the management scope name contains spaces, enclose it in q
        uotation marks (").

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Orphan <SwitchParameter>
        The Orphan parameter returns only the management scopes that
aren't associated with role assignments.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------
    This example retrieves all the management scopes that start with the
string Redmond.

    Get-ManagementScope Redmond*




    -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the Redmond Servers Scope using the Get-
ManagementScope cmdlet and pipes the output to the Format-List cmdlet.
For more
     information about the Format-List cmdlet, see Working with Command
Output.

    Get-ManagementScope "Redmond Servers Scope" | Format-List




    -------------------------- EXAMPLE 3 --------------------------




    This example retrieves a list of management scopes that aren't
associated with any role assignments.

    Get-ManagementScope -Orphan




    -------------------------- EXAMPLE 4 --------------------------




    This example retrieves a list of exclusive scopes.

    Get-ManagementScope -Exclusive $True
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/a14e4ca3-
2035-4959-a55f-efc50685a224(EXCHG.141).aspx

NAME
       Get-MessageCategory

SYNOPSIS
    Use the Get-MessageCategory cmdlet to retrieve a message category
from the specified mailbox.

SYNTAX
    Get-MessageCategory [-Identity <MessageCategoryIdParameter>] [-
DomainController <Fqdn>] [-Mailbox <MailboxIdParameter>]
[<CommonParameters>]


DESCRIPTION
    The Get-MessageCategory cmdlet is used by the Web management
interface in Microsoft Exchange Server 2010 to populate fields that
display messa
    ge category information.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mess
    age categories" entry in the Exchange and Shell Infrastructure
Permissions topic.


PARAMETERS
    -Identity <MessageCategoryIdParameter>
        The Identity parameter specifies the name of the message category
to be retrieved.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the identity of a mailbox user to
retrieve the message category from.

           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       This example retrieves message categories from the mailbox User1.

       Get-MessageCategory -Mailbox "User1"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/62d403c8-
d1cf-4507-a0d7-342bdfb17a9a(EXCHG.141).aspx

NAME
       Get-MessageClassification

SYNOPSIS
    Use the Get-MessageClassification cmdlet to view an existing message
classification instance in your Microsoft Exchange Server 2010 organizati
    on.

SYNTAX
    Get-MessageClassification [-Identity
<MessageClassificationIdParameter>] [-DomainController <Fqdn>] [-
IncludeLocales <SwitchParameter>] [-Orga
    nization <OrganizationIdParameter>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mess
    age classifications" entry in the Transport Permissions topic.


PARAMETERS
     -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory. The DomainController parameter isn't supported on the
Edge Transport server role. The Edge Transport server role reads only
from
          the Active Directory Lightweight Directory Services (AD LDS)
instance.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MessageClassificationIdParameter>
        The Identity parameter specifies the name of the message
classification instance that you want to view. When you specify a name
that inclu
        des spaces, you must enclose the name in quotation marks ("), for
example, "Administrative Name".

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true

    -IncludeLocales <SwitchParameter>
        The IncludeLocales parameter specifies whether the command output
includes the message classification locale data. When the IncludeLocales
         parameter is set to $true, the output includes the message
classification locale data. The default value is $false.

           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

       -------------------------- EXAMPLE 1 --------------------------




    This example lists all message classifications in your Exchange
organization.

       Get-MessageClassification




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2bc71c83-
4d16-4c16-9ce6-751f4e60b991(EXCHG.141).aspx

NAME
       Get-MessageTrackingReport

SYNOPSIS
    Use the Get-MessageTrackingReport cmdlet to return the data for a
specific message tracking report. This cmdlet requires you to specify the
ID
     for the message tracking report you want to view. Therefore, first
you need to use the Search-MessageTrackingReport cmdlet to find the
messag
    e tracking report ID for a specific message. You then pass the
message tracking report ID from the output of the Search-
MessageTrackingReport
    cmdlet to the Get-MessageTrackingReport cmdlet. For more information,
see Search-MessageTrackingReport. To learn more about message tracking,
    see Understanding Message Tracking.

SYNTAX
    Get-MessageTrackingReport -Identity <MessageTrackingReportId> [-
BypassDelegateChecking <SwitchParameter>] [-DetailLevel <Basic |
Verbose>] [-D
    omainController <Fqdn>] [-DoNotResolve <SwitchParameter>] [-
RecipientPathFilter <SmtpAddress>] [-Recipients <String[]>] [-
ReportTemplate <Summ
    ary | RecipientPath>] [-ResultSize <Unlimited>] [-Status
<Unsuccessful | Pending | Delivered | Transferred | Read>] [-TraceLevel
<Low | Medium
     | High>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mess
    age tracking" entry in the Transport Permissions topic.


PARAMETERS
    -Identity <MessageTrackingReportId>
        The Identity parameter specifies the ID of the message tracking
report ID to get.
        You should run the Search-MessageTrackingReport cmdlet to find
the message tracking report ID for the specific message you're tracking,
an
        d then pass the value of the MessageTrackingReportID field to
this parameter.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -BypassDelegateChecking <SwitchParameter>
        The BypassDelegateChecking parameter allows Help desk staff and
administrators to get message tracking reports for any user.
        By default, each user can only see the message tracking reports
for messages sent or received by the user. When you use this switch,
Excha
        nge allows you to view the message tracking reports for message
exchanges among other users.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DetailLevel <Basic | Verbose>
        The DetailLevel parameter specifies the amount of detail to be
displayed for the message tracking report. You can use one of the
following
         values:
        * Basic
        * Verbose
        If you specify Basic, simple delivery report information is
displayed, which is more appropriate for information workers. If you
specify V
        erbose, full report information is displayed, including server
names and physical topology information.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DoNotResolve <SwitchParameter>
        The DoNotResolve parameter prevents the resolution of e-mail
addresses to display names. This improves performance, but the end result
may
         not be as easy to interpret because it's missing the display
names.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientPathFilter <SmtpAddress>
        The RecipientPathFilter parameter specifies the recipient for
which the command returns the detailed tracking report.
        Use this parameter when you're using the RecipientPath report
template.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Recipients <String[]>
        The Recipients parameter specifies the recipients for whom you
want to get the message tracking data.
        You can use this parameter to specify the recipients in the
report details if you're using the Summary report template.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReportTemplate <Summary | RecipientPath>
        The ReportTemplate parameter specifies a predefined format for
the output. You can either return a summary for all recipients or a
detaile
        d tracking report for one recipient. You can specify one of the
following values:
        * RecipientPath
        * Summary

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all messages that match the search crite
        ria, use unlimited for the value of this parameter. The default
value is 1000.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Status <Unsuccessful | Pending | Delivered | Transferred | Read>
        The Status parameter specifies the delivery status codes you're
interested in. You can specify one of the following values:
        * Delivered
        * Read
        * Pending
        * Transferred
        * Unsuccessful

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -TraceLevel <Low | Medium | High>
        The TraceLevel parameter specifies whether additional trace
details are included in the output of the message tracking report. This
parame
        ter is intended to be used when troubleshooting message tracking
issues.
        The acceptable values for the TraceLevel parameter are:
        * Low    Minimal additional data is returned, including servers
that were accessed, timing, message tracking search result counts, and
any
          error information.
        * Medium    In addition to all the data returned for the Low
setting, the actual message tracking search results are also returned.
        * High    Full diagnostic data is returned.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

    -------------------------- EXAMPLE 1 --------------------------




    This example gets the message tracking report for messages sent from
one user to another. This example returns the summary of the message trac
    king report for a message that David Jones sent to Wendy Richardson.
    $Temp = Search-MessageTrackingReport -Identity "David Jones" -
Recipients "wendy@contoso.com"
    Get-MessageTrackingReport -Identity $Temp.MessageTrackingReportID -
ReportTemplate Summary




       -------------------------- EXAMPLE 2 --------------------------




    This example gets the message tracking report for the following
scenario: The user Cigdem Akin was expecting an e-mail message from
joe@contos
    o.com which never arrived. She contacted the Help desk, which needs
to determine what happened. They need to generate the message tracking
rep
    ort on behalf of Cigdem, and they don't need to see the display
names.
    This example searches the message tracking data for the specific
message tracking reports, and then returns detailed troubleshooting
informati
    on for the specific recipient path.

    Search-MessageTrackingReport -Identity "Cigdem Akin" -Sender
"joe@contoso.com" -ByPassDelegateChecking -DoNotResolve | ForEach-Object
{ Get-Me
    ssageTrackingReport -Identity $_.MessageTrackingReportID -DetailLevel
Verbose -BypassDelegateChecking -DoNotResolve -RecipientPathFilter "cigd
    em@fabrikam.com" -ReportTemplate RecipientPath }




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b949297c-
843b-4eb6-9e5e-378c84b841a3(EXCHG.141).aspx

NAME
       Get-MigrationBatch

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-MigrationBatch cmdlet to get status information about the
current e-mail migration batch.

SYNTAX
    Get-MigrationBatch [-Identity <MigrationBatchIdParameter>] [-
DomainController <Fqdn>] [-LimitErrorsTo <Int32>] [-Organization
<OrganizationIdP
    arameter>] [<CommonParameters>]


DESCRIPTION
    The Get-MigrationBatch cmdlet displays status information about the
current migration batch. This information includes the following
informati
    on:
    * Status of the migration batch
    * Connection settings
    * Total number of mailboxes being migrated
    * Number successfully completed migrations
    * Migration errors
    * Date and time when the migration was started


PARAMETERS
    -Identity <MigrationBatchIdParameter>
        The Identity parameter identifies the name of the current
migration batch. The value for this parameter is specified by the Name
parameter
         for the New-MigrationBatch cmdlet.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -LimitErrorsTo <Int32>
         The LimitErrorsTo parameter specifies the number of migration
errors that will be displayed. If you don't include this parameter, the
defa
         ult value is 500.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Organization <OrganizationIdParameter>
          The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example displays status information on the current migration
batch.

       Get-MigrationBatch




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b3ab7e6c-
6de6-4356-87bc-9548d42264b6(EXCHG.141).aspx

NAME
       Get-MigrationStatus

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-MigrationStatus cmdlet to get information about the
overall e-mail migration in progress. The cmdlet returns information
about the
     current migration batch and any completed migration batch. Use the
Get-MigrationBatch cmdlet to get information about the current migration
b
    atch only.

SYNTAX
    Get-MigrationStatus [-Identity <MigrationBatchIdParameter>] [-
DomainController <Fqdn>] [-LimitErrorsTo <Int32>] [-Organization
<OrganizationId
    Parameter>] [<CommonParameters>]


DESCRIPTION
    The Get-MigrationStatus cmdlet displays status information about the
migration that is currently being processed. This includes the following
    information:
    * Whether the overall migration is still active
    * Whether a migration batch is currently running
    * Whether the finalization process is in progress
    * The number of mailboxes that have been migrated
    * The number of mailbox migration requests from all migration batches
    * Migration errors
    * The e-mail addresses to which migration status reports are sent


PARAMETERS
    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MigrationBatchIdParameter>
        The value of the Identity parameter is assigned by the migration
service running on Microsoft Exchange.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -LimitErrorsTo <Int32>
        The LimitErrorsTo parameter specifies the number of migration
errors that are displayed. If you don't include this parameter, the
default
        value is 500.

        Required?                     false
        Position?                     Named
        Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




       This example displays information about the current e-mail migration.

       Get-MigrationStatus




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b66520aa-
4b23-4a36-b4f5-a00767c493b9(EXCHG.141).aspx

NAME
       Get-MoveRequest

SYNOPSIS
    Use the Get-MoveRequest cmdlet to view the detailed status of an
ongoing asynchronous mailbox move that was initiated by using the New-
MoveReq
    uest cmdlet.

SYNTAX
    Get-MoveRequest [-Identity <MoveRequestIdParameter>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Organization
<OrganizationIdPar
    ameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]

    Get-MoveRequest [-BatchName <String>] [-Credential <PSCredential>] [-
DomainController <Fqdn>] [-MoveStatus <None | Queued | InProgress | AutoS
    uspended | CompletionInProgress | Completed | CompletedWithWarning |
Suspended | Failed>] [-Offline <$true | $false>] [-Organization <Organiza
    tionIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-Protect <$true | $false>] [-
RemoteHostName <Fqdn>] [-ResultSize <Unl
    imited>] [-SortBy <String>] [-SourceDatabase <DatabaseIdParameter>]
[-Suspend <$true | $false>] [-SuspendWhenReadyToComplete <$true |
$false>]
     [-TargetDatabase <DatabaseIdParameter>] [<CommonParameters>]


DESCRIPTION
    The search criteria for the Get-MoveRequests cmdlet is a Boolean And
statement. If you use multiple parameters, it narrows your search and red
    uces your search results.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mail
    box moves" entry in the Mailbox Permissions topic.


PARAMETERS
    -BatchName <String>
        The BatchName parameter specifies the name that was given to a
batch move request.
        You can't use this parameter in conjunction with the Identity
parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).
        If you don't specify the Credential parameter, the credential of
the current user is used.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MoveRequestIdParameter>
        The Identity parameter specifies the identity of the mailbox or
mail user. You can use the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * Legacy Exchange DN
        * SMTP address
        * Alias
        This parameter can't be used in conjunction with the following
parameters:
        * BatchName
        * MoveStatus
        * Offline
        * Protect
        * RemoteHostName
        * SourceDatabase
        * Suspend
        * SuspendWhenReadyToComplete
        * TargetDatabase

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false
    -MoveStatus <None | Queued | InProgress | AutoSuspended |
CompletionInProgress | Completed | CompletedWithWarning | Suspended |
Failed>
        The MoveStatus parameter returns move requests in the specified
status. You can use the following values:
        * AutoSuspended
        * Completed
        * CompletedWithWarning
        * CompletionInProgress
        * Failed
        * InProgress
        * None
        * Queued
        * Suspended
        You can't use this parameter in conjunction with the Identity
parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Offline <$true | $false>
        The Offline parameter returns mailboxes being moved in offline
mode. This parameter accepts $true or $false.
        You can't use this parameter in conjunction with the Identity
parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies an organizational unit
(OU) and is used to limit the results. If you use this parameter, you on
        ly get move requests that pertain to mailboxes in the container
that you specify. You can use either the OU or the domain name. If you
use
         the OU, you must specify the canonical name of the OU.

          Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Protect <$true | $false>
        The Protect parameter returns mailboxes being moved in protected
mode. This parameter accepts $true or $false.
        You can't use this parameter in conjunction with the Identity
parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RemoteHostName <Fqdn>
        The RemoteHostName parameter specifies the FQDN of the cross-
forest organization from which you're moving the mailbox.
        You can't use this parameter in conjunction with the Identity
parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all requests that match the query, use u
        nlimited for the value of this parameter. The default value is
1000.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. The results are s
        orted in ascending order.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SourceDatabase <DatabaseIdParameter>
        The SourceDatabase parameter specifies that all mailboxes being
moved from the specified source database are returned. You can use the
fol
        lowing values:
        * GUID of the database
        * Database name
        You can't use this parameter in conjunction with the Identity
parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Suspend <$true | $false>
        The Suspend parameter specifies whether to return mailboxes with
moves that have been suspended. This parameter accepts $true or $false.
        You can't use this parameter in conjunction with the Identity
parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SuspendWhenReadyToComplete <$true | $false>
        The SuspendWhenReadytoComplete parameter specifies whether to
return mailboxes that have been moved with the New-MoveRequest command
and i
        ts SuspendWhenReadyToComplete switch. This parameter accepts
$true or $false.
        You can't use this parameter in conjunction with the Identity
parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -TargetDatabase <DatabaseIdParameter>
        The TargetDatabase parameter specifies whether to return all
mailboxes that are being moved to the specified target database. You can
use
        the following values:
        * GUID of the database
        * Database name
        You can't use this parameter in conjunction with the Identity
parameter.

        Required?                     false
        Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the status of the ongoing mailbox move for
Tony Smith's mailbox (tony@contoso.com).

    Get-MoveRequest -Identity 'tony@contoso.com'




    -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the status of ongoing mailbox moves to the
target database DB05.

    Get-MoveRequest -MoveStatus InProgress -TargetDatabase DB05




    -------------------------- EXAMPLE 3 --------------------------
    This example retrieves the status of move requests in the
FromDB01ToDB02 batch that completed, but had warnings.

    Get-MoveRequest -BatchName "FromDB01ToDB02" -MoveStatus
CompletedWithWarning




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/3f8aa1a6-
ed8c-4220-9cc7-dd615203f5c5(EXCHG.141).aspx

NAME
       Get-MoveRequestStatistics

SYNOPSIS
    Use the Get-MoveRequestStatistics cmdlet to view detailed information
about move requests.

SYNTAX
    Get-MoveRequestStatistics -Identity <MoveRequestIdParameter> [-
DomainController <Fqdn>] [-IncludeReport <SwitchParameter>]
[<CommonParameters>
    ]

    Get-MoveRequestStatistics -MoveRequestQueue <DatabaseIdParameter> [-
DomainController <Fqdn>] [-IncludeReport <SwitchParameter>] [-MailboxGuid
    <Guid>] [<CommonParameters>]

    Get-MoveRequestStatistics -MRSInstance <Fqdn> [-DomainController
<Fqdn>] [-MailboxGuid <Guid>] [<CommonParameters>]


DESCRIPTION
    The MoveRequestQueue and MRSInstance parameter syntax sets are for
debugging purposes only.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mail
    box moves" entry in the Mailbox Permissions topic.


PARAMETERS
    -Identity <MoveRequestIdParameter>
        The Identity parameter specifies the identity of the mailbox or
mail user. You can use one of the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * Legacy Exchange DN
        * SMTP address
        * Alias
        This parameter can't be used in conjunction with the
MoveRequestQueue, MRSInstance, or MailboxGuid parameters.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -MoveRequestQueue <DatabaseIdParameter>
        The MoveRequestQueue parameter specifies the mailbox database on
which the move request resides. You can use one of the following values:
        * GUID of the database
        * Database name
        This parameter can't be used in conjunction with the Identity or
MRSInstance parameters.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MRSInstance <Fqdn>
        The MRSInstance parameter specifies the fully qualified domain
name (FQDN) of the Client Access server on which the Microsoft Exchange
Mai
        lbox Replication service (MRS) resides. When using this
parameter, all records are returned for this instance of MRS.
        This parameter can't be used in conjunction with the Identity or
MoveRequestQueue parameters.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -IncludeReport <SwitchParameter>
        The IncludeReport switch specifies whether to return additional
details about the request, which can be used for troubleshooting.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -MailboxGuid <Guid>
        The MailboxGuid parameter specifies the GUID of a mailbox for
which you want to view the move request statistics.
        This parameter can't be used in conjunction with the Identity
parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns the default statistics for Tony Smith's mailbox,
which include the status, mailbox size, archive mailbox size, and the pe
    rcentage complete.

    Get-MoveRequestStatistics -Identity Tony@contoso.com
    -------------------------- EXAMPLE 2 --------------------------




    This example returns the detailed statistics for Tony Smith's mailbox
by pipelining the results to the Format-List command.

    Get-MoveRequestStatistics -Identity "contoso\tony" | Format-List




    -------------------------- EXAMPLE 3 --------------------------




    This example returns additional information about the mailbox move
for Tony Smith's mailbox and exports the report to a CSV file.

    Get-MoveRequestStatistics -Identity Tony@contoso.com -IncludeReport |
Export-CSV C:\MRStats.csv




    -------------------------- EXAMPLE 4 --------------------------




    This example returns default statistics for all mailboxes whose move
requests are in progress or haven't been cleared for the database MBXDB02
    .

    Get-MoveRequestStatistics -MoveRequestQueue "MBXDB02"




    -------------------------- EXAMPLE 5 --------------------------




    This example returns default statistics for a mailbox that has been
moved by the instance of the Microsoft Exchange Mailbox Replication
servic
       e running on the server CAS01.

    Get-MoveRequestStatistics -MRSInstance CAS01.contoso.com -MailboxGuid
b6a6795c-a010-4f67-aaaa-da372d56fcb9




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/1baf0fd7-
40e1-4d91-bab7-beff28b89e99(EXCHG.141).aspx

NAME
       Get-OrganizationalUnit

SYNOPSIS
    Use the Get-OrganizationalUnit cmdlet to view a list of
organizational units (OUs) that exist in your organization.

SYNTAX
    Get-OrganizationalUnit [-Identity
<ExtendedOrganizationalUnitIdParameter>] [-DomainController <Fqdn>] [-
IncludeContainers <SwitchParameter>] [
    -Organization <OrganizationIdParameter>] [-SingleNodeOnly
<SwitchParameter>] [<CommonParameters>]


DESCRIPTION
    The Get-OrganizationalUnit cmdlet is used by the Exchange Management
Console and the Exchange Control Panel in Microsoft Exchange Server 2010
    to populate fields that display OU information.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Acti
    ve Directory Domain Services server settings" entry in the Exchange
and Shell Infrastructure Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false
    -Identity <ExtendedOrganizationalUnitIdParameter>
        The Identity parameter specifies the OU to retrieve. If the OU
name contains spaces, enclose the value in quotation marks (").

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -IncludeContainers <SwitchParameter>
        The IncludeContainers switch instructs the command to return
containers while returning a list of OUs.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SingleNodeOnly <SwitchParameter>
         The SingleNodeOnly switch instructs the command to return only
the first level child OUs beneath the OU specified in the Identity
paramete
         r.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
       (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example retrieves a list of the first level child OUs beneath
the North America OU and formats the output so that only the Name and
Disti
    nguishedName properties are displayed.

    Get-OrganizationalUnit "North America" -SingleNodeOnly | Format-Table
Name, DistinguishedName

    For more information about pipelining and the Format-Table cmdlet,
see Pipelining and Working with Command Output.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/ec2d1cc9-
863f-47f1-b235-57f2a2835437(EXCHG.141).aspx

NAME
       Get-OrganizationRelationship

SYNOPSIS
    Use the Get-OrganizationRelationship cmdlet to retrieve settings for
a relationship that has been created for free/busy information access or
    secure e-mail delivery using federated delivery.

SYNTAX
    Get-OrganizationRelationship [-Identity
<OrganizationRelationshipIdParameter>] [-DomainController <Fqdn>] [-
Organization <OrganizationIdParame
    ter>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Orga
    nization relationships" entry in the Mailbox Permissions topic.
PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <OrganizationRelationshipIdParameter>
        The Identity parameter specifies the identity of the
organizational relationship. You can use the following values:
        * Canonical name
        * GUID
        * Name

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:
       -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the organization relationship settings for
Contoso using the Identity parameter.

       Get-OrganizationRelationship -Identity Contoso




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the organization relationship settings by
using the FQDN of the domain controller.

       Get-OrganizationRelationship -DomainController 'mail.contoso.com'




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b689bf46-
437b-4ac4-89ce-dcffc3a388f5(EXCHG.141).aspx

NAME
       Get-OutlookProtectionRule

SYNOPSIS
    Use the Get-OutlookProtectionRule cmdlet to retrieve Microsoft
Outlook protection rules configured in an organization.

SYNTAX
    Get-OutlookProtectionRule [-Identity <RuleIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>]
[<CommonParameter
    s>]


DESCRIPTION
    Outlook protection rules are used to automatically rights-protect e-
mail messages using a Rights Management Services (RMS) template before
the
     message is sent. However, Outlook protection rules don't inspect
message content. To rights-protect messages based on message content, use
tr
    ansport protection rules. For more information, see Understanding
Outlook Protection Rules.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Righ
    ts protection" entry in the Messaging Policy and Compliance
Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Identity <RuleIdParameter>
           The Identity parameter identifies an Outlook protection rule.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS
OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example gets details of all Outlook protection rules configured
in the organization.

       Get-OutlookProtectionRule




       -------------------------- Example 2 --------------------------




    This example gets all properties of the Outlook protection rule
ProjectContoso.

       Get-OutlookProtectionRule ProjectContoso | Format-List

    The Identity parameter is positional. When used after the cmdlet
name, the parameter value can be specified without providing the
parameter la
    bel.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/5a5197f2-
a219-4dd2-abe3-d0e8722f414a(EXCHG.141).aspx

NAME
       Get-OwaMailboxPolicy

SYNOPSIS
    Use the Get-OwaMailboxPolicy cmdlet to retrieve all Microsoft Office
Outlook Web App mailbox policies in a Microsoft Exchange Server 2010 orga
    nization.
SYNTAX
    Get-OwaMailboxPolicy [-Identity <MailboxPolicyIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>]
[<CommonParam
    eters>]


DESCRIPTION
    The Get-OwaMailboxPolicy cmdlet retrieves information about existing
Outlook Web App mailbox policies.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Outl
    ook Web App mailbox policies" entry in the Client Access Permissions
topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <MailboxPolicyIdParameter>
        The Identity parameter specifies the name of the policy or path
to the policy including the name, for example,
<Organization>\<ResellerA>\
        <Reseller…n>\<Tenant>\<Object Name>.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false
    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves the properties of all mailbox policies for the
organization Contoso.

    Get-OwaMailboxPolicy -Organization Contoso




    -------------------------- Example 2 --------------------------




    This example retrieves the properties of the Outlook Web App mailbox
policy Executives in the organization Fabrikam.

    Get-OwaMailboxPolicy -Identity Fabrikam\Executives




    -------------------------- Example 3 --------------------------
    This example retrieves the information for the Outlook Web App
mailbox policy Corporate for the tenant Contoso in the organization
Proseware.

       Get-OwaMailboxPolicy -Identity Proseware\Contoso\Corporate




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/bdd580d3-
8812-4b4a-93e8-c6401b0d2f0f(EXCHG.141).aspx

NAME
       Get-PerimeterConfig

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-PerimeterConfig cmdlet to view the list of gateway server
and internal mail server IP addresses that have been added to the cloud-
    based safelists.

SYNTAX
    Get-PerimeterConfig [-Identity <OrganizationIdParameter>] [-
DomainController <Fqdn>] [<CommonParameters>]


DESCRIPTION
    If you have an on-premises messaging system, you can add the IP
addresses of your mail servers to cloud-based safelists. Safelists are
also kn
    own as whitelists. You add IP addresses to cloud-based safelists to
make sure that e-mail that originates in your on-premises messaging
system
     isn't treated as spam.


PARAMETERS
    -Identity <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -DomainController <Fqdn>
           This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example returns the list of gateway servers and internal mail
servers in your organization that have been added to cloud-based
safelists.

       Get-PerimeterConfig




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/34ef07d4-
b055-4f33-bb88-15e41e0386db(EXCHG.141).aspx

NAME
       Get-PopSubscription

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-PopSubscription cmdlet to view information about POP
subscriptions that are configured in cloud-based mailboxes.

SYNTAX
    Get-PopSubscription [-Identity <AggregationSubscriptionIdParameter>]
[-AggregationType <Aggregation | Mirrored | Migration | All>] [-Confirm [
    <SwitchParameter>]] [-DomainController <Fqdn>] [-Mailbox
<MailboxIdParameter>] [-ResultSize <Unlimited>] [-WhatIf
[<SwitchParameter>]] [<Commo
    nParameters>]


DESCRIPTION
    You can view the properties of the POP subscription, such as the POP
server, authentication method, connection status, and the last time a suc
    cessful synchronization occurred.


PARAMETERS
    -AggregationType <Aggregation | Mirrored | Migration | All>
        The AggregationType parameter filters the results by type. The
acceptable values for this parameter are:
        * All
        * Aggregation
        * Migration
        * Mirrored

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <AggregationSubscriptionIdParameter>
        The Identity parameter specifies the POP subscription. You can
identify the subscription by using one of the following methods:
        * Specify the globally unique identifier of the subscription,
which is its canonical name (CN).
        * Use the Mailbox parameter to specify the mailbox that contains
the subscription, and then specify the name of the subscription.
        You can find the identifying values for a POP subscription, such
as Identity and Name, by running this command: Get-PopSubscription -Mailb
        ox <mailbox>.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the cloud-based mailbox that
contains the POP subscription. You can use any value that uniquely
identifies
         the mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the total number of
subscriptions to return. If no value is specified, the parameter returns
all result
        s that match the filter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example shows detailed information for all the POP subscriptions
that are configured in the mailbox of a user named "Kim Akers".

       Get-PopSubscription -Mailbox "Kim Akers" | Format-List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/961266ab-
21f2-4410-896b-9ede09ba20cd(EXCHG.141).aspx

NAME
       Get-ProvisioningRequest

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-ProvisioningRequest cmdlet to get status information
about the current provisioning request.

SYNTAX
    Get-ProvisioningRequest [-Identity <ProvisioningRequestIdParameter>]
[-DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [<Co
    mmonParameters>]
DESCRIPTION
    The Get-ProvisioningRequest cmdlet displays status information about
the current provisioning request being processed by the bulk provisioning
     service. This includes the following information:
    * Identity ID
    * DisplayName for the provisioning request
    * The user account of the administrator that submitted the New-
ProvisioningRequest cmdlet
    * Date and time that the request was submitted
    * Whether the provisioning request has been started
    * Number of rows in the CSV file
    * Number of user accounts successfully created
    * Number of user accounts that failed


PARAMETERS
    -Identity <ProvisioningRequestIdParameter>
        The Identity parameter specifies the ID of the provisioning
request. The value for this parameter is assigned by the bulk
provisioning ser
        vice.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -DomainController <Fqdn>
           This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS
OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example displays status information on the current provisioning
request.

       Get-ProvisioningRequest




       -------------------------- EXAMPLE 2 --------------------------




    This example displays the value for the Identity parameter for the
current provisioning request.

       Get-ProvisioningRequest | FL Identity




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b3580cd5-
c973-4c9d-bf46-134045726b14(EXCHG.141).aspx

NAME
       Get-Recipient

SYNOPSIS
    Use the Get-Recipient cmdlet to return a list of recipient objects
from Active Directory.

SYNTAX
    Get-Recipient [-Identity <RecipientIdParameter>] [-AuthenticationType
<Managed | Federated>] [-BookmarkDisplayName <String>] [-Capabilities <M
    ultiValuedProperty>] [-Credential <PSCredential>] [-DomainController
<Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Incl
    udeBookmarkObject <$true | $false>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-Property
    Set <All | ControlPanel | ConsoleSmallSet | ConsoleLargeSet |
Minimum>] [-ReadFromDomainController <SwitchParameter>] [-RecipientType
<Recipie
    ntType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-
ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]

    Get-Recipient [-AuthenticationType <Managed | Federated>] [-
Capabilities <MultiValuedProperty>] [-Credential <PSCredential>] [-
DomainControlle
    r <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>]
[-Organization <OrganizationIdParameter>] [-OrganizationalUnit <Organizat
    ionalUnitIdParameter>] [-PropertySet <All | ControlPanel |
ConsoleSmallSet | ConsoleLargeSet | Minimum>] [-ReadFromDomainController
<SwitchPar
    ameter>] [-RecipientPreviewFilter <String>] [-RecipientType
<RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-
ResultSize <
    Unlimited>] [-SortBy <String>] [<CommonParameters>]

    Get-Recipient [-Anr <String>] [-AuthenticationType <Managed |
Federated>] [-Capabilities <MultiValuedProperty>] [-Credential
<PSCredential>] [
    -DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope
<SwitchParameter>] [-Organization <OrganizationIdParameter>] [-
Organizationa
    lUnit <OrganizationalUnitIdParameter>] [-PropertySet <All |
ControlPanel | ConsoleSmallSet | ConsoleLargeSet | Minimum>] [-
ReadFromDomainContr
    oller <SwitchParameter>] [-RecipientType <RecipientType[]>] [-
RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>]
[-SortB
    y <String>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
    pient Provisioning Permissions" section in the Mailbox Permissions
topic.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AuthenticationType <Managed | Federated>
         This parameter applies only to objects in the cloud-based
service.
         The AuthenticationType parameter specifies the recipient by
authentication type. Use one of the following values:
         * Federated
         * Managed

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -BookmarkDisplayName <String>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Capabilities <MultiValuedProperty>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <RecipientIdParameter>
        The Identity parameter specifies the recipient. You can use one
of the following values:
        * GUID
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SMTP address
        * Name
        * Alias
        * Distinguished Name (DN)

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -IncludeBookmarkObject <$true | $false>
           This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies an organizational unit
(OU) or domain canonical name, and is used to limit the results. If you
        use this parameter, you only get recipients in the container that
you specify. For example:
        * OU: westcoast.contoso.com/users
        * Domain: westcoast.contoso.com

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -PropertySet <All | ControlPanel | ConsoleSmallSet | ConsoleLargeSet
| Minimum>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest,
and if you don't use this parameter, it's possible that the user
informati
        on is read from a global catalog with outdated information. If
you use this parameter, multiple reads might be necessary to get the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your servers that run Microsoft Exchange.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientPreviewFilter <String>
        The RecipientPreviewFilter parameter specifies a recipient filter
that would define the recipients returned by this command. You can creat
        e a custom recipient filter for a dynamic distribution group, an
address list, or an e-mail address policy. To verify that the recipient f
        ilter you specified will return the recipients you want, you can
pass the OPATH filter specified in the RecipientFilter property for that
        dynamic distribution group, address list, or e-mail address
policy to the RecipientPreviewFilter parameter and preview the list of
recipie
        nts.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientType <RecipientType[]>
        The RecipientType parameter specifies the type of recipients to
return. You can use one or more of the following values:
        * DynamicDistributionGroup
        * UserMailbox
        * MailUser
        * MailContact
        * MailUniversalDistributionGroup
        * MailUniversalSecurityGroup
        * MailNonUniversalGroup
        * PublicFolder

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientTypeDetails <RecipientTypeDetails[]>
        The RecipientTypeDetails parameter specifies the type of
recipients returned. Recipient types are divided into recipient types and
subtype
        s. Each recipient type contains all common properties for all
subtypes. For example, the type UserMailbox represents a user account in
Act
        ive Directory that has an associated mailbox. Because there are
several mailbox types, each mailbox type is identified by the
RecipientTyp
        eDetails parameter. For example, a conference room mailbox has
RecipientTypeDetails set to ConferenceRoomMailbox, whereas a user mailbox
h
        as RecipientTypeDetails set to UserMailbox.
        You can select from the following values:
        * ArbitrationMailbox
        * ConferenceRoomMailbox
        * Contact
        * DiscoveryMailbox
        * DynamicDistributionGroup
        * EquipmentMailbox
        * ExternalManagedContact
        * ExternalManagedDistributionGroup
        * LegacyMailbox
        * LinkedMailbox
        * MailboxPlan
        * MailContact
        * MailForestContact
        * MailNonUniversalGroup
        * MailUniversalDistributionGroup
        * MailUniversalSecurityGroup
        * MailUser
        * PublicFolder
        * RoleGroup
        * RoomList
        * RoomMailbox
        * SharedMailbox
        * SystemAttendantMailbox
        * SystemMailbox
        * User
        * UserMailbox

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all recipients that match the filter, us
        e unlimited for the value of this parameter. The default value is
1000.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. You can sort by t
        he following attributes:
        * Alias
        * DisplayName
        * Name
        The results are sorted in ascending order.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
    This example retrieves information about all the recipients in your
organization.

       Get-Recipient -ResultSize unlimited




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves information about all the mail contacts in
your organization and sorts them by name.

       Get-Recipient -RecipientType MailContact -SortBy Name




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2ce6250f-
0ad3-4b29-870c-e1d6e1e154bc(EXCHG.141).aspx

NAME
       Get-RecipientPermission

SYNOPSIS
    Content specific to Exchange 2010 will be available at a later date.

SYNTAX
    Get-RecipientPermission [-Identity <RecipientIdParameter>] [-
AccessRights <MultiValuedProperty>] [-DomainController <Fqdn>] [-
ReadFromDomainCo
    ntroller <SwitchParameter>] [-ResultSize <Unlimited>] [-Trustee
<SecurityPrincipalIdParameter>] [<CommonParameters>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"<Fea
    ture>" entry in the <topic link> topic.
PARAMETERS
    -Identity <RecipientIdParameter>


        Required?                      false
        Position?                      1
        Default value
        Accept pipeline input?         True
        Accept wildcard characters?    false

    -AccessRights <MultiValuedProperty>


        Required?                      false
        Position?                      Named
        Default value
        Accept pipeline input?         False
        Accept wildcard characters?    false

    -DomainController <Fqdn>


        Required?                      false
        Position?                      Named
        Default value
        Accept pipeline input?         False
        Accept wildcard characters?    false

    -ReadFromDomainController <SwitchParameter>


        Required?                      false
        Position?                      Named
        Default value
        Accept pipeline input?         False
        Accept wildcard characters?    false

    -ResultSize <Unlimited>


        Required?                      false
        Position?                      Named
        Default value
        Accept pipeline input?         False
        Accept wildcard characters?    false

    -Trustee <SecurityPrincipalIdParameter>


        Required?                      false
        Position?                      Named
        Default value
        Accept pipeline input?         False
        Accept wildcard characters?    false
       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




       Insert descriptive text for example 1.

       Insert example commands for example 1.




       -------------------------- EXAMPLE 2 --------------------------




       Insert descriptive text for example 2.

       Insert example commands for example 2.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/a80d1ec7-
2504-44f1-b6b4-2e65310b4c6e(EXCHG.141).aspx

NAME
       Get-RecipientStatisticsReport

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-RecipientStatisticReport cmdlet to view the recipient
statistics report.

SYNTAX
    Get-RecipientStatisticsReport [-Identity <OrganizationIdParameter>]
[-DomainController <Fqdn>] [-ReportingDatabase <String>] [-
ReportingServer
     <Fqdn>] [<CommonParameters>]


DESCRIPTION
    The recipient statistics report provides information about the total
number of mailboxes and the total number of active mailboxes in the organ
    ization.


PARAMETERS
    -Identity <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReportingDatabase <String>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReportingServer <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example displays the recipient statistics report for the
organization.

       Get-RecipientStatisticsReport




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/1c6f788c-
349d-41aa-a0b0-b931e8588791(EXCHG.141).aspx

NAME
       Get-RemoteDomain

SYNOPSIS
    Use the Get-RemoteDomain cmdlet to view the configuration information
for the remote domains configured in your organization. You can view the
     remote domain configuration from inside the Exchange organization or
from a computer that has the Edge Transport server role installed in a M
    icrosoft Exchange Server 2010 organization.

SYNTAX
    Get-RemoteDomain [-Identity <RemoteDomainIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>]
[<CommonParameters
    >]
DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Remo
    te domains" entry in the Transport Permissions topic.


PARAMETERS
     -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory. The DomainController parameter isn't supported on the
Edge Transport server role. The Edge Transport server role reads only
from
          the Active Directory Lightweight Directory Services (AD LDS)
instance.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <RemoteDomainIdParameter>
        The Identity parameter specifies a string value for the remote
domain. Enter either the GUID or name of the remote domain.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   true

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS
OUTPUTS

       -------------------------- EXAMPLE 1 --------------------------




    This example returns all remote domains configured in the Active
Directory forest in which you run the command.

       Get-RemoteDomain




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/183b2f07-
4225-4ef3-96c8-d29269730d18(EXCHG.141).aspx

NAME
       Get-RemovedMailbox

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-RemoveMailbox cmdlet to view information about deleted
mailboxes in your organization.

SYNTAX
    Get-RemovedMailbox [-Identity <RemovedMailboxIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-
ResultSize <
    Unlimited>] [<CommonParameters>]


DESCRIPTION
    If you can view the deleted mailbox using the Get-RemovedMailbox
cmdlet, you can recover the deleted mailbox by using the New-Mailbox
cmdlet.


PARAMETERS
    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       -Identity <RemovedMailboxIdParameter>
        The Identity parameter specifies the removed mailbox. You can use
the following values that uniquely identify the removed mailbox:
        * Name
        * Windows Live ID
        * SamAccountName

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -Organization <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. The default value is 500. If you want to return all removed ma
        ilboxes, use unlimited for the value of this parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
    This example displays all the removed mailboxes that are available
for recovery in your organization

       Get-RemovedMailbox




       -------------------------- EXAMPLE 2 --------------------------




    This example recovers the mailbox for a deleted account named "Tamara
Johnston". The account was deleted without preserving the Windows Live I
    D, so you must specify a new password value to recover Tamara's
account.
    Get-RemovedMailbox tjohnston@contoso.edu | New-Mailbox -Name "Tamara
Johnston" -Password (ConvertTo-SecureString -String 'Pa$$word1' -AsPlainT
    ext -Force)




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/91b2cd34-
5fcc-493d-951c-d47352bac12f(EXCHG.141).aspx

NAME
       Get-RetentionPolicy

SYNOPSIS
    Use the Get-RetentionPolicy cmdlet to retrieve the settings for
retention policies.

SYNTAX
    get-RetentionPolicy [-Identity <MailboxPolicyIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>]
[<CommonParame
    ters>]


DESCRIPTION
    A retention policy is associated with a group of retention policy
tags that specify retention settings for items in a mailbox. A policy may
co
    ntain one default retention policy tag and multiple non-default
retention policy tags. A mailbox can have only one retention policy
applied to
     it. The Get-RetentionPolicy cmdlet displays all policy settings
associated with the specified policy.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mess
    aging records management" entry in the Messaging Policy and
Compliance Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Identity <MailboxPolicyIdParameter>
           The Identity parameter specifies the policy name.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )
       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE1 --------------------------




    This example returns all the properties of the retention policy RP
Finance. The output is piped to the Format-List cmdlet to format the
result
    s as a list of properties.

       Get-RetentionPolicy -Identity "RP Finance" | Format-List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/7a05203e-
894b-4109-9647-ca7afc44a08f(EXCHG.141).aspx

NAME
       Get-RetentionPolicyTag

SYNOPSIS
    Use the Get-RetentionPolicyTag cmdlet to retrieve settings for a
retention tag.

SYNTAX
    Get-RetentionPolicyTag [-Identity <RetentionPolicyTagIdParameter>] [-
DomainController <Fqdn>] [-IncludeSystemTags <SwitchParameter>] [-Organiz
    ation <OrganizationIdParameter>] [-Types <ElcFolderType[]>]
[<CommonParameters>]

    Get-RetentionPolicyTag [-DomainController <Fqdn>] [-IncludeSystemTags
<SwitchParameter>] [-Mailbox <MailboxIdParameter>] [-OptionalInMailbox <
    SwitchParameter>] [-Organization <OrganizationIdParameter>] [-Types
<ElcFolderType[]>] [<CommonParameters>]


DESCRIPTION
    Retention tags are used to apply message retention settings to
messages or folders. There are three types of retention tags:
    * Retention policy tags
    * Default policy tags
    * Personal tags
    Retention policy tags are applied to default folders such as Inbox
and Deleted Items. Personal tags are available to users to tag items and
fo
    lders. The default policy tag is applied to all items that don't have
a tag applied by the user or aren't inherited from the folder they're lo
    cated in. The Get-RetentionPolicyTag cmdlet displays all the settings
for the specified tag.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Mess
    aging records management" entry in the Messaging Policy and
Compliance Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <RetentionPolicyTagIdParameter>
        The Identity parameter specifies the name of the tag.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -IncludeSystemTags <SwitchParameter>
        The IncludeSystemTags switch specifies whether to return any
system tags.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter isn't available in this release.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
       -OptionalInMailbox <SwitchParameter>
           The OptionalInMailbox parameter isn't available in this release.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Types <ElcFolderType[]>
        The Types parameter specifies the type of retention tag to
return. Valid values include:
        * Calendar
        * Contacts
        * DeletedItems
        * Drafts
        * Inbox
        * JunkEmail
        * Journal
        * Notes
        * Outbox
        * SentItems
        * Tasks
        * All
        * RssSubscriptions
        * ConversationHistory
        * Personal
        The parameter accepts multiple values separated by a comma.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS
NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns all retention tags.

    Get-RetentionPolicyTag




    -------------------------- EXAMPLE 2 --------------------------




    This example returns system tags in addition to personal and default
tags.

    Get-RetentionPolicyTag -IncludeSystemTags




    -------------------------- EXAMPLE 3 --------------------------




    This example returns the settings for the tag Consolidated Messenger.

    Get-RetentionPolicyTag "Consolidated Messenger"




    -------------------------- EXAMPLE 4 --------------------------
    This example returns all retention tags of Inbox and All types and
pipes the results to the Format-Table command to display the Name, Type,
Re
    tentionEnabled, AgeLimitForRetention, and RetentionAction properties.

    Get-RetentionPolicyTag -Types Inbox,All | Format-Table
Name,Type,RetentionEnabled,AgeLimitForRetention,RetentionAction -AutoSize




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/5cddcfea-
6f67-4481-9c00-5b13c11d5ced(EXCHG.141).aspx

NAME
       Get-RMSTemplate

SYNOPSIS
    Use the Get-RMSTemplate cmdlet to retrieve the current list of active
rights policy templates from the Active Directory Rights Management Serv
    ices (AD RMS) deployment for the organization.

SYNTAX
    Get-RMSTemplate [-Identity <RmsTemplateIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-
ResultSize <Unlimi
    ted>] [-TrustedPublishingDomain
<RmsTrustedPublishingDomainIdParameter>] [-Type <Archived | Distributed |
All>] [<CommonParameters>]


DESCRIPTION
    The Get-RMSTemplate cmdlet doesn't return any active rights policy
templates if internal licensing isn't enabled. Use the Get-
IRMConfiguration
     cmdlet to check the InternalLicensingEnabled parameter.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Righ
    ts protection" entry in the Messaging Policy and Compliance
Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Identity <RmsTemplateIdParameter>
           The Identity parameter specifies the name of the RMS template.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. The default value is 1000. To return all results, use unlimite
        d.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -TrustedPublishingDomain <RmsTrustedPublishingDomainIdParameter>
         This parameter applies only to objects in the cloud-based
service.
         The TrustedPublishingDomain parameter specifies the trusted
publishing domain you want to search for RMS templates. You can use any
value
         that uniquely identifies the trusted publishing domain, for
example:
         * Name
         * Distinguished name (DN)
         * GUID

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false
    -Type <Archived | Distributed | All>
         This parameter applies only to objects in the cloud-based
service.
         The Type parameter specifies the type of RMS template. Use one of
the following values:
         * All
         * Archived
         * Distributed

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves all RMS templates available from the RMS
deployment.

    Get-RMSTemplate -ResultSize unlimited




    -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the Company Confidential RMS template.
       Get-RMSTemplate -Identity "Company Confidential"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/4a5066e8-
b770-4aa2-b464-0d2190914f71(EXCHG.141).aspx

NAME
       Get-RMSTrustedPublishingDomain

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-RMSTrustedPublishingDomain cmdlet to view the settings of
an existing trusted publishing domain (TPD) in your organization.

SYNTAX
    Get-RMSTrustedPublishingDomain [-Identity
<RmsTrustedPublishingDomainIdParameter>] [-DomainController <Fqdn>] [-
Organization <OrganizationIdPa
    rameter>] [<CommonParameters>]


DESCRIPTION
    A trusted publishing domain (TPD) contains the settings needed to use
RMS features in your organization. For example, users can apply RMS temp
    lates to e-mail messages.


PARAMETERS
    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -Identity <RmsTrustedPublishingDomainIdParameter>
         The Identity parameter specifies the trusted publishing domain.
You can use any value that uniquely identifies the trusted publishing
doma
         in. For example:
         * Name
         * Distinguished name (DN)
         * GUID

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example lists all the trusted publishing domains that are
configured in your organization and shows detailed information for each
trusted
     publishing domain.

       Get-RMSTrustedPublishingDomain | Format-List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/69499195-
f08f-41bd-b0ed-443688410b12(EXCHG.141).aspx

NAME
       Get-RoleAssignmentPolicy
SYNOPSIS
    Use the Get-RoleAssignmentPolicy cmdlet to view an existing
management role assignment policy on a server running Microsoft Exchange
Server 20
    10.

SYNTAX
    Get-RoleAssignmentPolicy [-Identity <MailboxPolicyIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>]
[<CommonP
    arameters>]


DESCRIPTION
    For more information about assignment policies, see Understanding
Management Role Assignment Policies.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Assi
    gnment policies" entry in the Role Management Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <MailboxPolicyIdParameter>
        The Identity parameter specifies the name of the assignment
policy to view. If the name contains spaces, enclose the name in
quotation mar
        ks (").

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns a list of all the existing role assignment
policies.

    Get-RoleAssignmentPolicy




    -------------------------- EXAMPLE 2 --------------------------




    This example returns the details of the specified assignment policy.
The output of the Get-RoleAssignmentPolicy cmdlet is piped to the Format-
    List cmdlet.

    Get-RoleAssignmentPolicy "End User Policy" | Format-List

    For more information about pipelining and the Format-List cmdlet, see
Pipelining and Working with Command Output.
       -------------------------- EXAMPLE 3 --------------------------




    This example returns the default assignment policy.
    The output of the Get-RoleAssignmentPolicy cmdlet is piped to the
Where cmdlet. The Where cmdlet filters out all of the policies except the
po
    licy that has the IsDefault property set to $True.

       Get-RoleAssignmentPolicy | Where { $_.IsDefault -eq $True }

    For more information about pipelining and the Format-List cmdlet, see
Pipelining and Working with Command Output.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/da0ecaa3-
ce67-4ea2-aca3-56e056555900(EXCHG.141).aspx

NAME
       Get-RoleGroup

SYNOPSIS
    Use the Get-RoleGroup cmdlet to retrieve a list of management role
groups.

SYNTAX
    Get-RoleGroup [-Identity <RoleGroupIdParameter>] [-DomainController
<Fqdn>] [-Filter <String>] [-Organization <OrganizationIdParameter>] [-
Rea
    dFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-
ShowPartnerLinked <SwitchParameter>] [-SortBy <String>] [<CommonParameter
    s>]


DESCRIPTION
    For more information about role groups, see Understanding Management
Role Groups.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Role
     groups" entry in the Role Management Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the property to be used to filter
the role groups. Only the role groups that match the criteria you specify
         are returned.
        You can filter on the LinkedGroup, ManagedBy, Members, Name,
RoleGroupType, and DisplayName properties. If you create a filter using
the R
        oleGroupType property, the only values you can use in the filter
are Standard and Linked.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <RoleGroupIdParameter>
        The Identity parameter specifies the role group to retrieve. If
the name of the role group contains spaces, enclose the name in quotation
        marks (").
        If the Identity parameter isn't specified, all role groups are
returned.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController switch specifies that the role group
information should be read from a domain controller in the user's domain
        . If you use the Set-AdServerSettings cmdlet to include scope
commands to the entire forest and don't use this switch, it's possible
that
        the role group information is read from a global catalog with
outdated information.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all the role groups, use Unlimited for t
        he value of this parameter. The default value is 1000.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ShowPartnerLinked <SwitchParameter>
         This ShowPartnerLinked switch specifies whether to return built-
in role groups that are of type PartnerRoleGroup. Role groups of this
type
          are used in the cloud-based services to allow partner service
providers to manage their customer organizations. These role groups can't
b
         e edited and are therefore not shown by default.
         This parameter applies only to objects in the cloud-based
service.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. You can sort by t
        he Name attribute.
        The results are sorted in ascending order.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
          ErrorAction, ErrorVariable, WarningAction, WarningVariable,
          OutBuffer and OutVariable. For more information, type,
          "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example retrieves a list of role groups.

    Get-RoleGroup




    -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the details for the Recipient Administrators
role group.

    Get-RoleGroup "Recipient Administrators" | Format-List

    For more information about the Format-List cmdlet and pipelining, see
Working with Command Output and Pipelining.




    -------------------------- EXAMPLE 3 --------------------------




    This example retrieves a list of role groups as seen by the domain
controller closest to the user.

    Get-RoleGroup -ReadFromDomainController
       -------------------------- EXAMPLE 4 --------------------------




    This example retrieves a list of all linked role groups and the
Active Directory security identifier (SID) of the foreign universal
security g
    roups (USG) that are linked to each of them. You can then use the
SIDs to find the USGs so you can modify their members.

    Get-RoleGroup -Filter { RoleGroupType -Eq "Linked" } | Format-Table
Name, LinkedGroup




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/369800ff-
fced-4d1c-adb0-1ddbe798670d(EXCHG.141).aspx

NAME
       Get-RoleGroupMember

SYNOPSIS
    Use the Get-RoleGroupMember cmdlet to retrieve a list of members of a
management role group.

SYNTAX
    Get-RoleGroupMember -Identity <RoleGroupMemberIdParameter> [-
DomainController <Fqdn>] [-ReadFromDomainController <SwitchParameter>] [-
ResultSi
    ze <Unlimited>] [<CommonParameters>]


DESCRIPTION
    For more information about role groups, see Understanding Management
Role Groups.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Role
     groups" entry in the Role Management Permissions topic.


PARAMETERS
    -Identity <RoleGroupMemberIdParameter>
        The Identity parameter specifies the role group for which member
information should be retrieved. If the role group name contains spaces,
        enclose the name in quotation marks (").

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController switch specifies that the role group
information should be read from a domain controller in the user's domain
        . If you use the Set-AdServerSettings cmdlet to include all role
groups in the forest and don't use this parameter, it's possible that the
         role group information is read from a global catalog with
outdated information.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all the members of a role group, use Unl
        imited for the value of this parameter. The default value is
1,000.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".
INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example retrieves a list of all of the members of the Recipient
Administrators role group.

       Get-RoleGroupMember "Recipient Administrators"




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves a list of all of the members of the
Organization Administrators as seen by the domain controller closest to
the user ru
    nning the command.

    Get-RoleGroupMember "Recipient Administrators" -
ReadFromDomainController




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/1ff116aa-
1a62-4283-bc8e-5963d12958e1(EXCHG.141).aspx

NAME
       Get-SecurityPrincipal

SYNOPSIS
    Use the Get-SecurityPrincipal cmdlet to return a list of security
principals.

SYNTAX
    Get-SecurityPrincipal [-Identity
<ExtendedSecurityPrincipalIdParameter>] [-DomainController <Fqdn>] [-
Filter <String>] [-IncludeDomainLocalFro
    m <SmtpDomain>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <ExtendedOrganizationalUnitIdParameter>] [-ResultSize
<Unlimite
    d>] [-RoleGroupAssignable <SwitchParameter>] [-Types
<MultiValuedProperty>] [<CommonParameters>]


DESCRIPTION
     Security principals are entities, such as users or security groups,
which can be assigned permissions and user rights.
     If the IncludeDomainLocalFrom parameter is specified along with the
Filter or Identity parameters, the cmdlet doesn't return domain local
secu
     rity groups. This cmdlet is required for internal Exchange Management
Console functionality.
     The Get-SecurityPrincipal cmdlet is used by the Exchange Management
Console and the Exchange Control Panel in Microsoft Exchange Server 2010
t
     o populate fields that display recipient information.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Acti
     ve Directory Domain Services server settings" entry in the Exchange
and Shell Infrastructure Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter specifies one or more attributes and their
corresponding values to restrict the security principals returned by the
c
        ommand. When the Filter parameter is used, only those security
principals matching the filter conditions are returned.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -Identity <ExtendedSecurityPrincipalIdParameter>
         The Identity parameter specifies the identity of the security
principal. When the security principal is explicitly specified by using
this
          parameter, no additional security principals are returned.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -IncludeDomainLocalFrom <SmtpDomain>
        The IncludeDomainLocalFrom parameter specifies the FQDN of an
Active Directory domain. The command returns domain local groups from the
sp
        ecified domain.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <ExtendedOrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies an organizational unit
(OU), container, or domain name. It's used to limit the results. If you
        use this parameter, you only get mailboxes in the OU, container,
or domain that you specify, in addition to well-known security principals
         and domain local groups from the domain you specify in the
IncludeDomainLocalFrom parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false
    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of objects
to return. The default value is 1000. To return all objects that match th
        e query, use the value unlimited.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -RoleGroupAssignable <SwitchParameter>
        The RoleGroupAssignable switch filters security principals and
returns only those entities that can be assigned to an RBAC role group.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Types <MultiValuedProperty>
        The Types parameter isn't available at this time.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
    This example retrieves security principals in the OU People, well-
known security principals, and domain local groups from the domain
Contoso.c
    om.

    Get-SecurityPrincipal -OrganizationalUnit OU=People,DC=Contoso,DC=com
-IncludeDomainLocalFrom Contoso.com




    -------------------------- EXAMPLE 2 --------------------------




    This example retrieves security principals from the Legal department
by using the Filter parameter. Only security principals matching the filt
    er condition are retrieved.

    Get-SecurityPrincipal -Filter {Department -eq "Legal"} -
IncludeDomainLocalFrom Contoso.com




    -------------------------- EXAMPLE 3 --------------------------




    This example retrieves a single security principal explicitly
specified by using the Identity parameter.

    Get-SecurityPrincipal -Identity Administrator -IncludeDomainLocalFrom
Contoso.com




    -------------------------- EXAMPLE 4 --------------------------




     This example retrieves well-known security principals by pipelining
the results from the Get-SecurityPrincipal cmdlet to the Where-Object
comm
     and. The results are pipelined to the Format-Table command. Only the
Name and SID parameters are selected to be included in the final output.
    Get-SecurityPrincipal -IncludeDomainLocalFrom Contoso.com | ?
{$_.Type -eq "WellKnownSecurityPrincipal} | ft Name,SID -AutoSize

    The question mark character (?) is an alias for the Where-Object
command. Ft is an alias for the Format-Table command. Both aliases are
includ
    ed by default in the Windows PowerShell command-line interface.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/98d70e10-
6972-4317-88d0-59f99845cf15(EXCHG.141).aspx

NAME
       Get-SendAddress

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use Get-SendAddress to view the e-mail addresses on a user's mailbox
that can be configured as the default From address.

SYNTAX
    Get-SendAddress [-Identity <SendAddressIdParameter>] [-
DomainController <Fqdn>] [-Mailbox <MailboxIdParameter>]
[<CommonParameters>]

    Get-SendAddress [-AddressId <String>] [-DomainController <Fqdn>] [-
Mailbox <MailboxIdParameter>] [<CommonParameters>]


DESCRIPTION
    Configuring a default From address only makes sense if the user has
POP, IMAP, or Hotmail subscriptions configured on their mailbox. If you
do
    n't specify a value for the default From address, the default
behavior is:
    * The primary e-mail address on the user's mailbox is used for all
new messages.
    * The To address of the incoming message is used as the From address
for all replies or forwarded messages.
    The only e-mail addresses that can be configured as the default From
address are:
    * The user's primary e-mail address
    * The e-mail addresses of a user's POP, IMAP or Hotmail subscription
    You set the user's default From address in the SendAddressDefault
parameter on the Set-MailboxMessageConfiguration cmdlet. The user can
overri
    de the default From address when they create an e-mail message in
Outlook Web App.
    Note   The Get-SendAddress and Set-MailboxMessageConfiguration
cmdlets represent the e-mail addresses of POP, IMAP, or Hotmail
subscriptions a
    s a GUID. It's easier to configure a user's default From address in
Outlook Web App > Options > Account > Connected Accounts.


PARAMETERS
    -AddressId <String>
        The AddressId parameter specifies the e-mail address. The value
of AddressId is in the following formats:
        * The user's primary e-mail address is displayed as an e-mail
address. For example, bob@contoso.com.
        * The e-mail address of a POP, IMAP, or Hotmail subscription is
displayed as a GUID.
        * No default From address is set. This is represented by the
value $null.
        You can find the values of AddressId on a user's mailbox by
running the command Get-SendAddress -Mailbox <mailbox>.
        If you use the AddressId parameter, you must also use the Mailbox
parameter. If you use the AddressId parameter, you can't use the Identit
        y parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <SendAddressIdParameter>
        The Identity parameter specifies the mailbox and the e-mail
address. The value of Identity is in the format <mailbox>\<address>. The
<mail
        box> part is any value that uniquely identifies the mailbox. The
<address> part is in one following formats:
        * The user's primary e-mail address is displayed as an e-mail
address. For example, bob@contoso.com.
        * The e-mail address of a POP, IMAP, or Hotmail subscription is
displayed as a GUID.
        * No default From address is set. This is represented by a blank
value.
        You can find the values of Identity on a user's mailbox by
running the command Get-SendAddress -Mailbox <mailbox>.
        If you use the Identity parameter, you can't use the AddressId
parameter.
          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the mailbox. You can use any
value that uniquely identifies the mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE --------------------------




    The following example lists all the e-mail addresses of a user named
Tamara Johnston that can be used as the default From address.

    Get-SendAddress -Mailbox "Tamara Johnston"
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/b2c57a7e-
bd6d-461d-8a9d-5384a715344b(EXCHG.141).aspx

SYNTAX

DESCRIPTION


PARAMETERS
    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS


RELATED LINKS

NAME
       Get-SharingPolicy

SYNOPSIS
    Use the Get-SharingPolicy cmdlet to view the settings of sharing
policies.

SYNTAX
    Get-SharingPolicy [-Identity <SharingPolicyIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>]
[<CommonParamete
    rs>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Crea
    ting and modifying sharing policies" entry in the Mailbox Permissions
topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <SharingPolicyIdParameter>
        The Identity parameter specifies the identity of the sharing
policy for which you want to view the settings. You can use one of the
follow
        ing values:
        * ADObjectID
        * Distinguished name (DN)
        * Legacy DN
        * GUID
        The Identity parameter can't be used with the Organization
parameter.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

       -------------------------- EXAMPLE 1 --------------------------
    This example retrieves the default information for the sharing policy
FourthCoffee.

       Get-SharingPolicy -Identity FourthCoffee




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves the full information for the sharing policy
Fabrikam.

       Get-SharingPolicy Fabrikam | Format List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/0ad91f5b-
aaf4-4df0-90a1-a00ac83546ac(EXCHG.141).aspx

NAME
       Get-Subscription

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-Subscription cmdlet to view the properties of an existing
subscription that is configured in a user's cloud-based mailbox.

SYNTAX
     Get-Subscription [-Identity <AggregationSubscriptionIdParameter>] [-
AggregationType <Aggregation | Mirrored | Migration | All>] [-Confirm
[<Sw
     itchParameter>]] [-DomainController <Fqdn>] [-Mailbox
<MailboxIdParameter>] [-ResultSize <Unlimited>] [-SubscriptionType
<Unknown | Pop | Delt
     aSyncMail | AbchContact | IMAP | AllEMail | All>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
     You can view the properties of the subscription, such as the remote
server, authentication method, connection status, and the last time a
succ
     essful synchronization occurred.
PARAMETERS
    -AggregationType <Aggregation | Mirrored | Migration | All>
        The AggregationType parameter filters the results by type. The
acceptable values for this parameter are:
        * All
        * Aggregation
        * Migration
        * Mirrored

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -Identity <AggregationSubscriptionIdParameter>
         The Identity parameter specifies the subscription. You can
identify the subscription by using one of the following methods:
         * Specify the globally unique identifier of the subscription,
which is its canonical name (CN).
         * Use the Mailbox parameter to specify the mailbox that contains
the subscription, and then specify the name of the subscription.
         You can find the identifying values for a subscription, such as
Identity and Name, by running this command: Get-Subscription -Mailbox
<mai
         lbox>.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false
    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the cloud-based mailbox that
contains the subscription. You can use any value that uniquely identifies
the
         mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the total number of
subscriptions to return. If no value is specified, the parameter returns
all result
        s that match the filter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SubscriptionType <Unknown | Pop | DeltaSyncMail | AbchContact | IMAP
| AllEMail | All>
        The SubscriptionType parameter filters the results based on the
type of subscription. The acceptable values for this parameter are:
        * All
        * Unknown
        * Pop
        * IMAP
        * DeltaSyncMail
        * AbchContact

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
         what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example lists all the subscriptions that are configured in the
mailbox of a user named "Ayla Kol".

       Get-Subscription -Mailbox "Ayla Kol"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/a9c74996-
557b-4437-9aeb-658449d4d012(EXCHG.141).aspx

NAME
       Get-SupervisionListEntry

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-SupervisionListEntry cmdlet to view information about the
supervision list entries in a cloud-based mailbox. Each user has a perso
    nalized list of entries.
SYNTAX
    Get-SupervisionListEntry -Identity <RecipientIdParameter> [-
Credential <PSCredential>] [-DomainController <Fqdn>] [-
ReadFromDomainController <
    SwitchParameter>] [-ResultSize <Unlimited>] [-Tag <String>]
[<CommonParameters>]


DESCRIPTION
    Supervision list entries that are configured in a mailbox perform the
following functions:
    * They specify individual exceptions for the user in the closed
campus supervision policy.
    * They identify the user as a victim in the anti-bullying policy.
This prevents the specified recipients from sending messages to the user.


PARAMETERS
    -Identity <RecipientIdParameter>
        The Identity parameter specifies the mailbox that will contain
the supervision list entry. You can use any value that uniquely
identifies
        the mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the logon credentials used to
access the mailbox that contains the supervision list entry.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
          This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Tag <String>
        The Tag parameter specifies the supervision tag. Acceptable
values are Allow or Reject. The value Allow specifies individual
exceptions to
         the closed campus supervision policies. The value Reject
identifies the person specified by the Entry parameter as a bully in the
anti-bu
        llying supervision policy.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )
       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example shows the supervision list entries that prevent people
from sending messages to a user named "Tamara Johnston". The anti-
bullying
     supervision policy prevents these people from sending messages to
Tamara.

       Get-SupervisionListEntry "Tamara Johnston" -Tag "Reject"




       -------------------------- EXAMPLE 2 --------------------------




    This example returns all the supervision list entries that are
configured in the mailbox of a user named "Tamara Johnston" and displays
the re
    sult in a tabular format.

       Get-SupervisionListEntry "Tamara Johnston" | Format-Table




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/4d5f923e-
aab5-455c-9785-a9afd48030e0(EXCHG.141).aspx

NAME
       Get-SupervisionPolicy

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-SupervisionPolicy cmdlet to view information about
supervision policies in the organization.

SYNTAX
    Get-SupervisionPolicy [-Identity <OrganizationIdParameter>] [-
DisplayDetails <SwitchParameter>] [-DomainController <Fqdn>]
[<CommonParameters>
    ]


DESCRIPTION
    You can't create or delete supervision policies.


PARAMETERS
    -DisplayDetails <SwitchParameter>
        The DisplayDetails parameter displays exceptions that are
configured for the closed campus policies, and custom words that are
configured
        for the bad words policy.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )
       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example lists the available supervision policies in the
organization, and shows detailed information about the closed campus
supervision
    policy and bad words supervision policy.

       Get-SupervisionPolicy -DisplayDetails




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/9a6ecacb-
cf64-4b4e-956f-fe7c76cec43c(EXCHG.141).aspx

SYNTAX

DESCRIPTION


PARAMETERS
    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS


RELATED LINKS

NAME
       Get-TextMessagingAccount

SYNOPSIS
    Use the Get-TextMessagingAccount cmdlet to return a user's short
messaging service (SMS) settings.

SYNTAX
    Get-TextMessagingAccount -Identity <MailboxIdParameter> [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-ReadFromDomainController <Sw
    itchParameter>] [-ResultSize <Unlimited>] [<CommonParameters>]


DESCRIPTION
    The Get-TextMessagingAccount cmdlet gets the SMS settings for a
particular user. These settings include whether Microsoft Exchange
ActiveSync
    is enabled, the user's country or region ID, mobile operator ID,
service provider ID, and notification phone number.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Text
     messaging settings" entry in the Client Access Permissions topic.


PARAMETERS
    -Identity <MailboxIdParameter>
        The Identity parameter specifies the identity of the mailbox.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the logon credentials of the
user.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies whether the
cmdlet should return data from the domain controller.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the amount of data returned.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns the text messaging settings for Tony Smith's
mailbox using his alias.

    Get-TextMessagingAccount -Identity "TonySmith" -DomainController
server.contoso.com




    -------------------------- EXAMPLE 2 --------------------------
    This example returns the text messaging settings for Tony Smith's
mailbox using his domain and username.

    Get-TextMessagingAccount -Identity "contoso\tonysmith" -
DomainController DC1.contoso.com




       -------------------------- EXAMPLE 3 --------------------------




    This example returns the text messaging settings for Tony Smith's
mailbox using his e-mail address.

    Get-TextMessagingAccount -Identity "tony@contoso.com" -
DomainController gc.contoso.com




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2d692e94-
1b64-4bdf-b486-31f11110fb31(EXCHG.141).aspx

NAME
       Get-ThrottlingPolicy

SYNOPSIS
    Use the Get-ThrottlingPolicy cmdlet to view the client throttling
settings for one or more throttling policies.

SYNTAX
    Get-ThrottlingPolicy [-Identity <ThrottlingPolicyIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>]
[<CommonPa
    rameters>]


DESCRIPTION
    The Get-ThrottlingPolicy cmdlet returns the client throttling
settings for one or more throttling policies. If you use the Identity
parameter,
     the cmdlet returns the settings for the identified throttling
policy. If you don't use the Identity parameter, the cmdlet returns the
setting
    s for all throttling policies.
    For more information about client throttling, see Understanding
Client Throttling Policies. For more information about managing
performance wi
    th client throttling policies, see Managing Performance with Client
Throttling Policies.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Clie
    nt throttling settings" entry in the Client Access Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <ThrottlingPolicyIdParameter>
        The Identity parameter identifies the name of the throttling
policy that you want to return settings for.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS
OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns the settings for all throttling policies.

    Get-ThrottlingPolicy




    -------------------------- EXAMPLE 2 --------------------------




    This example displays the parameters and values for throttling policy
ThrottlingPolicy2.

    Get-ThrottlingPolicy -Identity ThrottlingPolicy2




    -------------------------- EXAMPLE 3 --------------------------




    This example returns the default throttling policy. Default
throttling policies have the IsDefault parameter set to $true.

    Get-ThrottlingPolicy | where-object {$_.IsDefault -eq $true}




    -------------------------- EXAMPLE 4 --------------------------
    This example returns the throttling policies associated with the user
with the alias tonysmith.

    $policy = $null;
    $policyLink = (get-mailbox tonysmith).ThrottlingPolicy;
    if ($policyLink -eq $null)
    {
         $policy = Get-ThrottlingPolicy | where-object {$_.IsDefault -eq
$true}
    }
    else
    {
         $policy = $policyLink | Get-ThrottlingPolicy;
    }




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/f7490b98-
20e0-46ee-b369-6f77538da689(EXCHG.141).aspx

NAME
       Get-ThrottlingPolicyAssociation

SYNOPSIS
    Use the Get-ThrottlingPolicyAssociation cmdlet to view the
relationship between objects and their associated throttling policies.
The object c
    an be a user with a mailbox, a user without a mailbox, a contact, or
a computer account.

SYNTAX
    Get-ThrottlingPolicyAssociation [-Identity
<ThrottlingPolicyAssociationIdParameter>] [-Credential <PSCredential>] [-
DomainController <Fqdn>] [
    -Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-
Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitId
    Parameter>] [-ReadFromDomainController <SwitchParameter>] [-
ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]

    Get-ThrottlingPolicyAssociation [-Anr <String>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-
IgnoreDefaultScop
    e <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainControlle
    r <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<CommonParameters>]
DESCRIPTION
    For more information, see Understanding Client Throttling Policies
and Managing Performance with Client Throttling Policies.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Clie
    nt throttling settings" entry in the Client Access Permissions topic.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <ThrottlingPolicyAssociationIdParameter>
        The Identity parameter specifies the object to query to see its
throttling policy associations. The object can be a user with a mailbox,
a
         user without a mailbox, a contact, or a computer account.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the distinguished name (DN) for the Identity
parameter. Other forms of identification, such as alias or GUID, aren't
ac
          cepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Organization <OrganizationIdParameter>
        The Organization parameter specifies the organization that the
object specified by the Identity parameter is in.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies an organizational unit
(OU) and is used to limit the results. If you use this parameter, you on
        ly get mailboxes in the container that you specify. You can use
either the OU or the domain name. If you use the OU, you must specify the
        canonical name of the OU.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest
and don't use this parameter, it's possible that the user information is
re
        ad from a global catalog with outdated information. If you use
this parameter, multiple reads might be necessary to get the information.
        By default, the recipient scope is set to the domain that hosts
your servers that run Exchange.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return. If you want to return all mailboxes that match the query, use
        unlimited for the value of this parameter. The default value is
1000.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. You can sort by t
        he following attributes:
        * Alias
        * Display name
        * Name
        The results are sorted in ascending order.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns a list of all the mailboxes in your organization
in the Users OU.

    Get-ThrottlingPolicyAssociation -OrganizationalUnit Users




    -------------------------- EXAMPLE 2 --------------------------




    This example returns all the mailboxes that resolve from the
ambiguous name resolution search on the string "Chr" that are in the
domain DC01.
     This example returns mailboxes for users such as Chris Ashton,
Christian Hess, and Christa Geller.

       Get-ThrottlingPolicyAssociation -Anr Chr -DomainController DC01




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/45e1248f-
89c2-467c-8d5d-de1367111e08(EXCHG.141).aspx

NAME
       Get-ToolInformation

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    The Get-ToolInformation cmdlet is used by the CSV_Parser.ps1 Windows
PowerShell script to verify that the version of the script that you are r
    unning is the correct version for your cloud-based organization.

SYNTAX
    Get-ToolInformation -Identity <CSVParser> -Version <Version> [-
Organization <OrganizationIdParameter>] [<CommonParameters>]


DESCRIPTION
    You can download and use the CSV_Parser.ps1 script to add new users,
update existing users, or delete existing users in the cloud-based servic
    e. For more information, see Create and Configure Users and Contacts
with Windows PowerShell V2 (http://go.microsoft.com/fwlink/?LinkID=121809
    ).


PARAMETERS
    -Identity <CSVParser>
        The Identity parameter specifies the tool. Valid input for this
parameter is CSVParser.

          Required?                     true
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -Version <Version>
        The Version parameter specifies the version of the tool. Valid
input for this parameter is a number in the format 14.0.x.x.

          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Organization <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE --------------------------




     This example is generated by the CSV_Parser.ps1 script using the
version value 14.0.0.0. If you are using a version of the script that is
inco
     rrect for your cloud-based organization, the output will display the
minimum supported version of the script, the latest supported version of
     the script, and a download link to get the correct version of the
script for your cloud-based organization.

    Get-ToolInformation CSVParser -Version 14.0.0.0




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/d880b145-
f87b-45ba-95e8-d1c51e092edd(EXCHG.141).aspx
NAME
       Get-TransportConfig

SYNOPSIS
    Use the Get-TransportConfig cmdlet to view organization-wide e-mail
transport configuration settings on computers that have the Hub Transport
    server role or the Edge Transport server role installed.

SYNTAX
    Get-TransportConfig [-Identity <OrganizationIdParameter>] [-
DomainController <Fqdn>] [<CommonParameters>]


DESCRIPTION
    The Get-TransportConfig cmdlet displays configuration information for
global transport settings applied across the Microsoft Exchange Server 2
    010 organization when the cmdlet is run on a Hub Transport server.
When this cmdlet is run on an Edge Transport server, only the
transportatio
    n configuration settings for the local computer are shown.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Tran
    sport configuration" entry in the Transport Permissions topic.


PARAMETERS
     -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory. The DomainController parameter isn't supported on the
Edge Transport server role. The Edge Transport server role reads only
from
          the Active Directory Lightweight Directory Services (AD LDS)
instance.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Identity <OrganizationIdParameter>
           The Identity parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false
       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

       -------------------------- EXAMPLE 1 --------------------------




    This example lists the Exchange organization-wide e-mail
transportation settings on a Hub Transport server, or the local
transportation settin
    gs on an Edge Transport server.

       Get-TransportConfig




       -------------------------- EXAMPLE 2 --------------------------




    This example lists all delivery status notification-related (DSN)
configuration settings for your organization when run on a Hub Transport
ser
    ver. When run on an Edge Transport server, it displays the DSN-
related settings configured on that Edge Transport server.

       Get-TransportConfig | Format-List *DSN*




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/8f54a77c-
7a5c-446f-b661-022c7e53f5c0(EXCHG.141).aspx

NAME
       Get-TransportRule

SYNOPSIS
    Use the Get-TransportRule cmdlet to view transport rules configured
on a Hub Transport or Edge Transport server.
SYNTAX
    Get-TransportRule [-Identity <RuleIdParameter>] [-DomainController
<Fqdn>] [-Organization <OrganizationIdParameter>] [-State <Enabled |
Disabl
    ed>] [<CommonParameters>]


DESCRIPTION
    The Get-TransportRule cmdlet lets you view the configuration of
transport rules that are defined on a Hub Transport server or an Edge
Transpor
    t server. If you run this command on a Hub Transport server, all
transport rules configured in the organization, except for rules
configured o
    n an Edge Transport server, are displayed. If you run this command on
an Edge Transport server, only the rules configured on that Edge Transpo
    rt server are displayed.
    For information about how to configure transport rules in a Microsoft
Exchange Server 2010 organization, see Set-TransportRule. For informatio
    n about the Transport Rules agent, see Overview of Transport Rules.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Tran
    sport rules" entry in the Messaging Policy and Compliance Permissions
topic.


PARAMETERS
     -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory. The DomainController parameter isn't supported on the
Edge Transport server role. The Edge Transport server role reads only
from
          the Active Directory Lightweight Directory Services (AD LDS)
instance.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <RuleIdParameter>
        The Identity parameter specifies the transport rule to be viewed.
Enter either the GUID or the name of the rule. You can omit the paramete
        r label.

        Required?                     false
        Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   true

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -State <Enabled | Disabled>
        The State parameter specifies whether to filter the results of
the Get-TransportRule cmdlet. The following values are valid for this
param
        eter:
        * Enabled   Instructs the command to return only the rules that
are enabled and applied to e-mail messages if the conditions are met.
        * Disabled   Instructs the command to return only the rules that
are disabled and not applied to e-mail messages.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example returns a summary list of all transport rules configured
in an Exchange organization if the command is run on a Hub Transport ser
    ver, or the rules configured on the local computer if the command is
run on an Edge Transport server.

       Get-TransportRule




       -------------------------- EXAMPLE 2 --------------------------




     This example returns only the rule that matches the name "Block e-
mail messages between Sales and Brokerage Groups". The command is piped
to t
     he Format-List cmdlet to display the detailed configuration of the
specified transport rule.

    Get-TransportRule "Block e-mail messages between Sales and Brokerage
Groups" | Format-List

    For more information about pipelining, see Pipelining. For more
information about how to work with the output of a command, see Working
with C
    ommand Output.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/63a14c30-
331d-458b-91d1-71d28a6e3d5a(EXCHG.141).aspx

NAME
       Get-TransportRuleAction

SYNOPSIS
    Use the Get-TransportRuleAction cmdlet to retrieve a list of all
available transport rule actions that can be used with the Transport
Rules ag
    ent on a Hub Transport or an Edge Transport server.
SYNTAX
    Get-TransportRuleAction [-Name <String>] [<CommonParameters>]


DESCRIPTION
     The Get-TransportRuleAction cmdlet displays a list of available
actions that an e-mail administrator can use in transport rules that are
part
     of the Transport Rules agent in Microsoft Exchange Server 2010.
     The transport rule actions available for use on a Hub Transport
server and an Edge Transport server are slightly different. For a list of
tran
     sport rule actions included with the Get-TransportRuleAction cmdlet,
and to determine which actions are available on each of the server roles,
      see Transport Rule Actions.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Tran
     sport rules" entry in the Messaging Policy and Compliance Permissions
topic.


PARAMETERS
    -Name <String>
        The Name parameter specifies the action to display. For a list of
values that can be used with this parameter on the server role that you
        are administering, see Transport Rule Actions.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:
NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example returns all available transport rule actions for
transport rules used with the Transport Rules agent.

       Get-TransportRuleAction




       -------------------------- EXAMPLE 2 --------------------------




    This example retrieves a single transport rule action. The command is
piped to the Format-List command to display all properties of the transp
    ort rule action.

       Get-TransportRuleAction -Name DeleteMessage | Format-List

    For more information about pipelining, see Pipelining. For more
information about how to work with the output of a command, see Working
with C
    ommand Output.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/60829f04-
94a0-4228-a66c-f467aaca438b(EXCHG.141).aspx

NAME
       Get-TransportRulePredicate

SYNOPSIS
    Use the Get-TransportRulePredicate cmdlet to retrieve a list of all
available rule predicates that can be used with the Transport Rules agent
    on a Hub Transport server or an Edge Transport server.
SYNTAX
    Get-TransportRulePredicate [-Name <String>] [<CommonParameters>]


DESCRIPTION
    The Get-TransportRulePredicate cmdlet displays a list of available
rule predicates that you can use in transport rules that are part of the
Tr
    ansport Rules agent in Microsoft Exchange Server 2010.
    The predicates available for use on a Hub Transport server and an
Edge Transport server are slightly different. For a list of transport
rule p
    redicates included with the Get-TransportRulePredicate cmdlet, and to
determine which predicates are available on each server role, see Transp
    ort Rule Predicates.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Tran
    sport rules" entry in the Messaging Policy and Compliance Permissions
topic.


PARAMETERS
    -Name <String>
        The Name parameter specifies the predicate to display. For a list
of values that can be used with this parameter on the server role that y
        ou're administering, see Transport Rule Predicates.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:
NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- Example 1 --------------------------




    This example returns all available predicates for transport rules
used with the Transport Rules agent.

       Get-TransportRulePredicate




       -------------------------- Example 2 --------------------------




     This example retrieves the single predicate SubjectMatches. The
command is piped to the Format-List command to display detailed transport
rule
      predicate information.

       Get-TransportRulePredicate -Name SubjectMatches | Format-List

    For more information about pipelining, see Pipelining. For more
information about how to work with the output of a command, see Working
with C
    ommand Output.




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/3054220d-
0973-4832-840e-b9ef9e7c9064(EXCHG.141).aspx

NAME
       Get-UMAutoAttendant

SYNOPSIS
    Use the Get-UMAutoAttendant cmdlet to retrieve the properties and the
values for a Unified Messaging (UM) auto attendant.
SYNTAX
    Get-UMAutoAttendant [-Identity <UMAutoAttendantIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-
UMDialPlan
     <UMDialPlanIdParameter>] [<CommonParameters>]


DESCRIPTION
    The Get-UMAutoAttendant cmdlet retrieves the properties for a single
UM auto attendant or for a list of UM auto attendants.
    After this task is completed, if no parameter is supplied with the
cmdlet, the cmdlet returns all UM auto attendants in the Active Directory
f
    orest. Or, if the UM dial plan ID is supplied but no name is
supplied, the cmdlet returns all UM auto attendants linked to the UM dial
plan.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM a
    uto attendants" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <UMAutoAttendantIdParameter>
        The Identity parameter specifies the identifier for the UM auto
attendant that's being viewed. This is the directory object ID for the UM
        auto attendant.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   true

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -UMDialPlan <UMDialPlanIdParameter>
        The UMDialPlan parameter specifies whether to display all the UM
auto attendants that are associated with the UM dial plan that's specifie
        d.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns a formatted list of all UM auto attendants in
the Active Directory forest.

    Get-UMAutoAttendant | Format-List
       -------------------------- EXAMPLE 2 --------------------------




    This example displays the properties of the UM auto attendant
MyUMAutoAttendant.

       Get-UMAutoAttendant -Identity MyUMAutoAttendant




       -------------------------- EXAMPLE 3 --------------------------




    This examples displays all the UM auto attendants associated with the
UM dial plan MyUMDialPlan.

       Get-UMAutoAttendant -UMDialPlan MyUMDialPlan




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/7e577b3a-
184d-4533-b1c9-c2c8884a442a(EXCHG.141).aspx

NAME
       Get-UMCallDataRecord

SYNOPSIS
    Use the Get-UMCallDataRecord cmdlet to display Unified Messaging (UM)
call data records for a specific UM-enabled user's mailbox.

SYNTAX
    Get-UMCallDataRecord -Mailbox <MailboxIdParameter> [-DomainController
<Fqdn>] [-Organization <OrganizationIdParameter>] [<CommonParameters>]


DESCRIPTION
    The Get-UMCallDataRecord cmdlet displays UM call data records for the
last 90 days for a UM-enabled mailbox that you specify. Each UM call dat
    a record provides detailed information about all calls either placed
to or received by the specified user. The following table details each of
     the properties returned:
    After this task is completed, a report is generated that contains UM
call data records for a specific UM-enabled mailbox.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM c
    all data and summary reports" entry in the Unified Messaging
Permissions topic.


PARAMETERS
    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the UM-enabled mailbox that UM
call data records will be displayed.

          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )
       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example displays the UM call data records for the UM-enabled
user Tony.

       Get-UMCallDataRecord -Mailbox tony@contoso.com




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/7b75c817-
820e-4863-9865-e17ad9ade903(EXCHG.141).aspx

NAME
       Get-UMCallSummaryReport

SYNOPSIS
    Use the Get-UMCallSummaryReport cmdlet to return statistics about all
calls received or placed by Unified Messaging (UM) servers in an organiz
    ation.

SYNTAX
    Get-UMCallSummaryReport -GroupBy <Day | Month | Total> [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-
UMDialPlan <UMDi
    alPlanIdParameter>] [-UMIPGateway <UMIPGatewayIdParameter>]
[<CommonParameters>]


DESCRIPTION
    The Get-UMCallSummaryReport cmdlet displays the aggregated statistics
about all calls received or placed by Unified Messaging servers in an or
    ganization including voice messages, missed calls, subscriber access,
auto attendant, or fax calls. The data returned by running this cmdlet i
    ncludes audio quality metrics for the sample calls such as the
following:
    After this task is completed, a summary report will be displayed for
all calls that are processed by Unified Messaging servers in your organiz
    ation.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM c
    all data and summary reports" entry in the Unified Messaging
Permissions topic.


PARAMETERS
    -GroupBy <Day | Month | Total>
        The GroupBy parameter displays the daily statistics for the last
90 days, monthly statistics for the last 12 months, or a summary of all c
        all statistics for your Unified Messaging servers in your
organization.

          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -UMDialPlan <UMDialPlanIdParameter>
         The UMDialPlan parameter specifies the Unified Messaging (UM)
dial plan to show statistics for. If you don't specify a dial plan,
statisti
         cs are included for all dial plans in the organization.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false
    -UMIPGateway <UMIPGatewayIdParameter>
        The UMIPGateway parameter specifies the UM IP gateway to show
statistics for. If you don't specify a UM IP gateway, statistics are
include
        d for all UM IP gateways for a selected dial plan, or, if no dial
plan is selected, results will be returned for all UM IP gateways in the
         organization.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example displays the statistics for all calls received or placed
by Unified Messaging servers in the organization.

    Get-UMCallSummaryReport -GroupBy Total




    -------------------------- EXAMPLE 2 --------------------------




    This example displays the statistics for all calls received or placed
by Unified Messaging servers in the organization over the last 12 months
    .
       Get-UMCallSummaryReport -GroupBy Month




       -------------------------- EXAMPLE 3 --------------------------




    This example displays the statistics for all calls received or placed
by Unified Messaging servers in the organization over the last 90 days.

       Get-UMCallSummaryReport -GroupBy Day




       -------------------------- EXAMPLE 4 --------------------------




    This example displays the statistics for calls received or placed by
Unified Messaging servers for the UM dial plan MyUMDialPlan.

       Get-UMCallSummaryReport -GroupBy Month -UMDialplan MyUMDialPlan




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/fb22cc49-
03b7-47f1-9cfb-e05acdcc93d6(EXCHG.141).aspx

NAME
       Get-UMDialplan

SYNOPSIS
    Use the Get-UMDialplan cmdlet to display the properties of a single
Unified Messaging (UM) dial plan or to return a list of all UM dial plans
    associated with a Unified Messaging server.

SYNTAX
    Get-UMDialPlan [-Identity <UMDialPlanIdParameter>] [-DomainController
<Fqdn>] [-Organization <OrganizationIdParameter>] [<CommonParameters>]


DESCRIPTION
    The Get-UMDialplan cmdlet displays all properties for a UM dial plan.
    After this task is completed, when you specify the Identity
parameter, you can view the values set. When the Get-UMDialplan cmdlet is
run, if
    no parameter is supplied, the cmdlet returns all UM dial plans in the
Active Directory forest.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM d
    ial plans" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <UMDialPlanIdParameter>
        The Identity parameter specifies the UM dial plan ID. This
parameter specifies the directory object identifier for the UM dial plan.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   true

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS
OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example displays a list of all the UM dial plans in the Active
Directory forest.

       Get-UMDialplan




       -------------------------- EXAMPLE 2 --------------------------




    This example displays a formatted list of properties for a UM dial
plan named MyUMDialPlan.

       Get-UMDialplan -Identity MyUMDialPlan | Format-List




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/23a33037-
1572-424e-adc8-3edc26e1a895(EXCHG.141).aspx

NAME
       Get-UMHuntGroup
SYNOPSIS
    Use the Get-UMHuntGroup cmdlet to display the properties and values
for an existing Unified Messaging (UM) hunt group.

SYNTAX
    Get-UMHuntGroup [-Identity <UMHuntGroupIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-
UMDialPlan <UMDial
    PlanIdParameter>] [<CommonParameters>]


DESCRIPTION
    The Get-UMHuntGroup cmdlet retrieves the properties for a single UM
hunt group or a list of UM hunt groups. When you're using the Get-
UMHuntGr
    oup cmdlet, you can't only enter the name of the UM hunt group. You
must also include the name of the UM IP gateway that's associated with
the
     UM hunt group. For example, Get-UMHuntGroup
MyUMIPGateway\MyUMHuntGroup1.
    After this task is completed, if the Identity parameter is specified,
the properties for the UM hunt group are returned. If neither the Identi
    ty nor the UMDialPlan parameter is specified, all UM hunt groups in
the Active Directory forest are returned.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM h
    unt groups" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <UMHuntGroupIdParameter>
        The Identity parameter specifies the identifier for the UM hunt
group being viewed. This is the directory object ID for the UM hunt
group.

        Required?                     false
        Position?                     1
        Default value
          Accept pipeline input?        True
          Accept wildcard characters?   true

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -UMDialPlan <UMDialPlanIdParameter>
        The UMDialPlan parameter specifies the UM dial plan associated
with a UM hunt group.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------
    This example displays all the UM hunt groups in the Active Directory
forest.

       Get-UMHuntGroup




       -------------------------- EXAMPLE 2 --------------------------




    This example displays the details of the UM hunt group MyUMHuntGroup
in a formatted list.

       Get-UMHuntGroup -identity MyUMIPGateway\MyUMHuntGroup | Format-List




       -------------------------- EXAMPLE 3 --------------------------




    This example displays all of the UM hunt groups that are associated
with the UM dial plan MyUMDialPlan.

       Get-UMHuntGroup -UMDialPlan MyUMDialPlan




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/89471543-
4fae-42b0-a807-fd15bec97307(EXCHG.141).aspx

NAME
       Get-UMIPGateway

SYNOPSIS
    Use the Get-UMIPGateway cmdlet to return a list of properties and
values for a specified Unified Messaging (UM) IP gateway or a list of UM
IP
    gateways.

SYNTAX
    Get-UMIPGateway [-Identity <UMIPGatewayIdParameter>] [-
DomainController <Fqdn>] [-IncludeSimulator <SwitchParameter>] [-
Organization <Organiza
    tionIdParameter>] [<CommonParameters>]


DESCRIPTION
    The Get-UMIPGateway cmdlet displays the properties and values for a
specified UM IP gateway, such as the display name, the IP address,
status,
     and outcall settings. If no parameter is specified, all UM IP
gateways in the Active Directory forest are returned.
    When you're using the Get-UMIPGateway cmdlet, you can't enter the IP
address that's configured on the UM IP gateway. You must use the name of
    the UM IP gateway. The name that's specified on the Identity
parameter with the Get-UMIPGateway cmdlet can be the same as or different
from th
    e host name of the UM IP gateway. For example, Get-UMIPGateway
MyUMIPGateway.
    After this task is completed, you can see the list of properties and
values for a specific UM IP gateway. Or, if the Identity parameter isn't
    used, the cmdlet returns a list of all UM IP gateways in the forest.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM I
    P gateways" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -Identity <UMIPGatewayIdParameter>
         The Identity parameter specifies the identifier for the UM IP
gateway being viewed. This parameter is the directory object ID for the
UM I
         P gateway.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true
    -IncludeSimulator <SwitchParameter>
        The IncludeSimulator parameter retrieves the simulator of the UM
IP gateway being viewed. A simulator allows a client to connect to the Un
        ified Messaging server.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------
    This example displays a formatted list of all the UM IP gateways in
the Active Directory forest.

       Get-UMIPGateway |Format-List




       -------------------------- EXAMPLE 2 --------------------------




    This example displays the properties for a UM IP gateway named
MyUMIPGateway.

       Get-UMIPGateway -Identity MyUMIPGateway




       -------------------------- EXAMPLE 3 --------------------------




    This example displays all the UM IP gateways including IP gateway
simulators in the Active Directory forest.

       Get-UMIPGateway -IncludeSimulator $true




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/d7f8c7d0-
6ed7-4b74-91de-8b0ed2377946(EXCHG.141).aspx

NAME
       Get-UMMailbox

SYNOPSIS
    Use the Get-UMMailbox cmdlet to display the Unified Messaging (UM)
properties for a recipient who is UM-enabled.

SYNTAX
    Get-UMMailbox [-Identity <MailboxIdParameter>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-
IgnoreDefaultScope
     <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-
OrganizationalUnit <OrganizationalUnitIdParameter>] [-
ReadFromDomainController
     <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<CommonParameters>]

    Get-UMMailbox [-Anr <String>] [-Credential <PSCredential>] [-
DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope
<SwitchParameter
    >] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter
    >] [-ResultSize <Unlimited>] [-SortBy <String>] [<CommonParameters>]


DESCRIPTION
    The Get-UMMailbox cmdlet retrieves the UM properties for a single UM
mailbox. It can also return a list of UM-enabled mailboxes.
    After this task is completed, you can see the properties and values
configured on a single UM mailbox. Or, if the Identity parameter isn't
use
    d, the cmdlet returns a list of all the UM-enabled mailboxes in a
forest.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM m
    ailbox" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects that have an attribute that matches that
string. The following default attributes are searched:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter filters the results returned by the cmdlet.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxIdParameter>
        The Identity parameter specifies the user to enable for Unified
Messaging. The values for this parameter include the following:
        * ADObjectID
        * GUID
        * DN
        * Domain\Account
        * UPN
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the distinguished name for the Identity
parameter. Other forms of identification, such as alias or GUID, aren't
accepte
          d.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies an organizational unit
(OU) and is used to limit the results. If you use this parameter, you re
        trieve only mailboxes in the container you specify. You can use
the OU or the domain name. If you use the OU, you must specify the
canonic
        al name of the OU.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -ReadFromDomainController <SwitchParameter>
         The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
h
         ave set the recipient scope to include all recipients in the
forest and if you don't use this parameter, the user information may be
read
         from a global catalog whose information is outdated. If you do
use this parameter, multiple reads may be necessary to get the
information.
          By default, the recipient scope is set to the domain that hosts
your Exchange servers.
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies a maximum number of results to
be returned. Otherwise, a maximum number isn't specified, and the comman
        d returns all results.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. You can sort by t
        he following attributes:
        * Alias
        * DisplayName
        * Name
        The results are sorted in ascending order.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS
    @{Text=}



OUTPUTS
    @{Text=}



NON-TERMINATING ERRORS
    (Category: )


    Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example displays a list of all the UM-enabled mailboxes in the
Active Directory forest in a formatted list.

       Get-UMMailbox | Format-List




       -------------------------- EXAMPLE 2 --------------------------




    This example displays the UM mailbox properties for
tonysmith@contoso.com.

       Get-UMMailbox -Identity tonysmith@contoso.com




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/4c652c1a-
2f0e-45ff-99ca-d194057f1550(EXCHG.141).aspx

NAME
       Get-UMMailboxPIN

SYNOPSIS
    Use the Get-UMMailboxPIN cmdlet to return information from a Unified
Messaging (UM)-enabled user's mailbox.

SYNTAX
    Get-UMMailboxPin [-Identity <MailboxIdParameter>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope
<SwitchParamete
    r>] [-IgnoreErrors <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-ReadFromDomainController <SwitchParameter>]
[-ResultSize <Un
    limited>] [<CommonParameters>]


DESCRIPTION
    The Get-UMMailboxPIN cmdlet returns information that's calculated
from the PIN data stored in encrypted form in the user's mailbox. This
cmdle
    t also shows whether the mailbox or user access has been locked out.
    After this task is completed, you can view information on a user's
mailbox.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM m
    ailbox" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -Credential <PSCredential>
        The Credential parameter specifies the user name and password to
use to access Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxIdParameter>
        The Identity parameter specifies the identifier that can be used
to retrieve information about the mailbox. The values for this parameter
        include the following:
        * ADObjectID
        * GUID
        * DN
        * Domain\Account
        * UPN
        * LegacyExchangeDN
        * SmtpAddress
        * Alias
          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the distinguished name (DN) for the Identity
parameter. Other forms of identification, such as alias or GUID, aren't
ac
          cepted.
        * You can't use the Organization and Identity parameters
together.
        * You can't use the Credential parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -IgnoreErrors <SwitchParameter>
        The IgnoreErrors parameter specifies whether errors that may
occur when running this cmdlet are written as warnings.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
h
        ave set the recipient scope to include all recipients in the
forest and if you don't use this parameter, the user information may be
read
        from a global catalog whose information is outdated. If you use
this parameter, multiple reads may be necessary to get the information.
By
         default, the recipient scope is set to the domain that hosts
your Exchange servers.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies a maximum number of results to
be returned. If a maximum number isn't specified, the cmdlet returns all
         results.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
    This example displays the UM mailbox PIN-related properties for all
UM-enabled users.

       Get-UMMailboxPIN




       -------------------------- EXAMPLE 2 --------------------------




    This example displays the UM mailbox PIN-related properties for
tonysmith@contoso.com.

       Get-UMMailboxPIN -Identity tonysmith@contoso.com




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/93924584-
5955-4e54-8b74-bf00cf269317(EXCHG.141).aspx

NAME
       Get-UMMailboxPlan

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Get-UMMailboxPlan cmdlet to view information about the
Unified Messaging (UM) mailbox plans in the organization.

SYNTAX
    Get-UMMailboxPlan [-Identity <MailboxPlanIdParameter>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-
IgnoreDefa
    ultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainCo
    ntroller <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy
<String>] [<CommonParameters>]


DESCRIPTION
    The Unified Messaging (UM) mailbox plan controls UM settings for user
accounts in the organization.
PARAMETERS
    -Credential <PSCredential>
        The Credential parameter specifies the user name and password for
viewing the object. The default is the current user's credentials.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter syntax used to
filter the results.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxPlanIdParameter>
        The Identity parameter specifies the UM mailbox plan. Typically,
the name of the UM mailbox plan is the same as the mailbox plan, for exam
        ple, DefaultMailboxPlan.
        You can use any value that uniquely identifies the UM mailbox
plan, for example:
        * Distinguished name (DN)
        * Name
        * Display Name
        * GUID

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Organization <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ResultSize <Unlimited>
         The ResultSize parameter specifies the total number of items to
display.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SortBy <String>
        The SortBy parameter specifies the attribute by which to sort the
results. You can sort by only one attribute at a time. You can sort by t
        he following attributes:
        * Display name
        * Name
        The results are sorted in ascending order.
           Required?                     false
           Position?                     Named
           Default value
           Accept pipeline input?        False
           Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




       This example lists all the UM mailbox plans in the organization.

       Get-UMMailboxPlan




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/49b482c3-
62e1-4dcb-af0d-a2231557aee3(EXCHG.141).aspx

NAME
       Get-UMMailboxPolicy

SYNOPSIS
    Use the Get-UMMailboxPolicy cmdlet to display the properties and
values of a Unified Messaging (UM) mailbox policy.

SYNTAX
    Get-UMMailboxPolicy [-Identity <MailboxPolicyIdParameter>] [-
DomainController <Fqdn>] [-Organization <OrganizationIdParameter>] [-
UMDialPlan <
    UMDialPlanIdParameter>] [<CommonParameters>]


DESCRIPTION
    The Get-UMMailboxPolicy cmdlet retrieves the configuration properties
and values for a UM mailbox policy or returns a list of UM mailbox polic
    ies.
    After this task is completed, if the Identity parameter is supplied,
the properties and values for the specified UM mailbox policy object are
    returned. If no parameter is specified at the command prompt, all UM
mailbox policies in the Active Directory forest are returned.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM m
    ailbox policies" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Identity <MailboxPolicyIdParameter>
        The Identity parameter specifies the identifier for the UM
mailbox policy being viewed. This is the directory object ID for the UM
mailbox
         policy.

          Required?                     false
          Position?                     1
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   true

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -UMDialPlan <UMDialPlanIdParameter>
        The UMDialPlan parameter displays all the UM mailbox policies
that are associated with the UM dial plan that's specified.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example returns a formatted list of all UM mailbox policies in
the Active Directory forest.

    Get-UMMailboxPolicy | Format-List
       -------------------------- EXAMPLE 2 --------------------------




    This example returns the properties and values for the UM mailbox
policy MyUMMailboxPolicy.

       Get-UMMailboxPolicy -Identity MyUMMailboxPolicy




       -------------------------- Example 3 --------------------------




    This examples displays all the UM mailbox policies that are
associated with the UM dial plan MyUMDialPlan.

       Get-UMMailboxPolicy -UMDialPlan MyUMDialPlan




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/f3a09cda-
c1b9-4d7c-b1a5-eefc3603ebe7(EXCHG.141).aspx

NAME
       Get-User

SYNOPSIS
    Use the Get-User cmdlet to retrieve all users in the forest that
match the specified conditions.

SYNTAX
    get-User [-Identity <UserIdParameter>] [-Arbitration
<SwitchParameter>] [-Credential <PSCredential>] [-DomainController
<Fqdn>] [-Filter <Stri
    ng>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [
    -ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails
<RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<C
    ommonParameters>]
    get-User [-Anr <String>] [-Arbitration <SwitchParameter>] [-
Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>]
[-IgnoreD
    efaultScope <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomai
    nController <SwitchParameter>] [-RecipientTypeDetails
<RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
[<CommonParameter
    s>]


DESCRIPTION
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Reci
    pient Provisioning Permissions" section in the Mailbox Permissions
topic.


PARAMETERS
    -Anr <String>
        The Anr parameter specifies a string on which to perform an
ambiguous name resolution (ANR) search. You can specify a partial string
and s
        earch for objects with an attribute that matches that string. The
default attributes searched are:
        * CommonName (CN)
        * DisplayName
        * FirstName
        * LastName
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Arbitration <SwitchParameter>
        The Arbitration parameter specifies that the mailbox for which
you are executing the command is an arbitration mailbox. Arbitration
mailbo
        xes are used for managing approval workflow. For example, an
arbitration mailbox is used for handling moderated recipients and
distributio
        n group membership approval.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Credential <PSCredential>
        The Credential parameter specifies the account used to read
Active Directory.
        This parameter requires the creation and passing of a credential
object. This credential object is created by using the Get-Credential cmd
        let. For more information, see Get-Credential
(http://go.microsoft.com/fwlink/?LinkId=142122).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Filter <String>
        The Filter parameter indicates the OPath filter used to filter
recipients.
        For more information about the filterable properties, see
Filterable Properties for the -Filter Parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <UserIdParameter>
        The Identity parameter specifies one of the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * Legacy Exchange DN
        * SMTP address
        * Alias

        Required?                     false
        Position?                     1
        Default value
          Accept pipeline input?        True
          Accept wildcard characters?   true

    -IgnoreDefaultScope <SwitchParameter>
        The IgnoreDefaultScope parameter instructs the command to ignore
the default recipient scope setting for the Exchange Management Shell ses
        sion and use the entire forest as the scope. This allows the
command to access Active Directory objects that aren't currently in the
defau
        lt scope. Using the IgnoreDefaultScope parameter introduces the
following restrictions:
        * You can't use the DomainController parameter. The command uses
an appropriate global catalog server automatically.
        * You can only use the DN for the Identity parameter. Other forms
of identification, such as alias or GUID, aren't accepted.
        * You can't use the OrganizationalUnit and Identity parameters
together.
        * You can't use the Credential parameter.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter returns objects only from the
specified organizational unit (OU).

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ReadFromDomainController <SwitchParameter>
        The ReadFromDomainController parameter specifies that the user
information is read from a domain controller in the user's domain. If you
s
        et the recipient scope to include all recipients in the forest,
and if you don't use this parameter, it's possible that the user
informati
        on is read from a global catalog with outdated information. If
you use this parameter, multiple reads might be necessary to get the
inform
        ation.
        By default, the recipient scope is set to the domain that hosts
your servers running Exchange.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientTypeDetails <RecipientTypeDetails[]>
        The RecipientTypeDetails parameter specifies the type of
recipients returned. Recipient types are divided into recipient types and
subtype
        s. Each recipient type contains all common properties for all
subtypes. For example, the type UserMailbox represents a user account in
Act
        ive Directory that has an associated mailbox. Because there are
several mailbox types, each mailbox type is identified by the
RecipientTyp
        eDetails parameter. For example, a conference room mailbox has
RecipientTypeDetails set to ConferenceRoomMailbox, whereas a user mailbox
h
        as RecipientTypeDetails set to UserMailbox.
        You can select from the following values:
        * ArbitrationMailbox
        * ConferenceRoomMailbox
        * Contact
        * DiscoveryMailbox
        * DynamicDistributionGroup
        * EquipmentMailbox
        * ExternalManagedContact
        * ExternalManagedDistributionGroup
        * LegacyMailbox
        * LinkedMailbox
        * MailboxPlan
        * MailContact
        * MailForestContact
        * MailNonUniversalGroup
        * MailUniversalDistributionGroup
        * MailUniversalSecurityGroup
        * MailUser
        * PublicFolder
        * RoleGroup
        * RoomList
        * RoomMailbox
        * SharedMailbox
        * SystemAttendantMailbox
        * SystemMailbox
        * User
        * UserMailbox
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -ResultSize <Unlimited>
        The ResultSize parameter specifies the maximum number of results
to return.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Sortby <String>
        The SortBy parameter specifies the attribute to sort by. This
parameter sorts by a single attribute in ascending order.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
       This example retrieves information about users in the Marketing OU.

       Get-User -OrganizationalUnit "Marketing"




       -------------------------- EXAMPLE 2 --------------------------




    This example uses the Filter parameter to retrieve information about
all users that have the word Manager at the end of their title.

       Get-User -Filter "Title -like '*Manager'"




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2a33c9e6-
33da-438c-912d-28ce3f4c9afb(EXCHG.141).aspx

Get-Verb [[-verb] <String[]>] [-Verbose] [-Debug] [-ErrorAction
<ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable
<String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer
<Int32>]

H:

NAME
       Get-Help

SYNOPSIS
    Displays information about Windows PowerShell commands and concepts.

SYNTAX
    Get-Help [-Full] [[-Name] <string>] [-Category <string[]>] [-
Component <string[]>] [-Functionality <string[]>] [-Online] [-Path
<string>] [-Ro
    le <string[]>] [<CommonParameters>]

    Get-Help [-Detailed] [[-Name] <string>] [-Category <string[]>] [-
Component <string[]>] [-Functionality <string[]>] [-Online] [-Path
<string>]
    [-Role <string[]>] [<CommonParameters>]
    Get-Help [-Examples] [[-Name] <string>] [-Category <string[]>] [-
Component <string[]>] [-Functionality <string[]>] [-Online] [-Path
<string>]
    [-Role <string[]>] [<CommonParameters>]

    Get-Help [-Parameter <string>] [[-Name] <string>] [-Category
<string[]>] [-Component <string[]>] [-Functionality <string[]>] [-Online]
[-Path
    <string>] [-Role <string[]>] [<CommonParameters>]


DESCRIPTION
    The Get-Help cmdlet displays information about Windows PowerShell
concepts and commands, including cmdlets, providers, functions and
scripts.
    To get a list of all cmdlet help topic titles, type "get-help *".

    If you type "Get-Help" followed by the exact name of a help topic, or
by a word unique to a help topic, Get-Help displays the topic contents.
    If you enter a word or word pattern that appears in several help
topic titles, Get-Help displays a list of the matching titles. If you
enter a
     word that does not appear in any help topic titles, Get-Help
displays a list of topics that include that word in their contents.

    In addition to "get-help", you can also type "help" or "man", which
displays one screen of text at a time, or "<cmdlet-name> -?", which is
ide
    ntical to Get-Help but works only for cmdlets.

    You can display the entire help file or selected parts of the file,
such as the syntax, parameters, or examples. You can also use the Online
p
    arameter to display an online version of a help file in your Internet
browser. These parameters have no effect on conceptual help topics.

    Conceptual help topics in Windows PowerShell begin with "about_",
such as "about_Comparison_Operators". To see all "about_" topics, type
"get-
    help about_*". To see a particular topic, type "get-help
about_<topic-name>", such as "get-help about_Comparison_Operators".


PARAMETERS
    -Category <string[]>
        Displays help for items in the specified category. Valid values
are Alias, Cmdlet, Provider, and HelpFile. Conceptual topics are in the
He
        lpFile category.

        Category is a property of the MamlCommandHelpInfo object that
Get-Help returns. This parameter has no effect on displays of conceptual
("a
        bout_") help.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -Component <string[]>
        Displays a list of tools with the specified component value, such
as "Exchange." Enter a component name. Wildcards are permitted.

        Component is a property of the MamlCommandHelpInfo object that
Get-Help returns. This parameter has no effect on displays of conceptual
("
        About_") help.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -Detailed [<SwitchParameter>]
         Adds parameter descriptions and examples to the basic help
display.

        This parameter has no effect on displays of conceptual ("About_")
help.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -Examples [<SwitchParameter>]
        Displays only the name, synopsis, and examples. To display only
the examples, type "(get-help <cmdlet-name>).examples".

        This parameter has no effect on displays of conceptual ("About_")
help.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -Full [<SwitchParameter>]
        Displays the entire help file for a cmdlet, including parameter
descriptions and attributes, examples, input and output object types, and
        additional notes.
        This parameter has no effect on displays of conceptual ("About_")
help.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -Functionality <string[]>
        Displays help for items with the specified functionality. Enter
the functionality. Wildcards are permitted.

        Functionality is a property of the MamlCommandHelpInfo object
that Get-Help returns. This parameter has no effect on displays of
conceptua
        l ("About_") help.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -Name <string>
        Requests help about the specified tool or conceptual topic. Enter
a cmdlet, provider, script, or function name, such as Get-Member, a conc
        eptual topic name, such as "about_Objects", or an alias, such as
"ls". Wildcards are permitted in cmdlet and provider names, but you canno
        t use wildcards to find the names of function help and script
help topics.

        To get help for a script that is not located in a path that is
listed in the Path environment variable, type the path and file name of
the
         script .

        If you enter the exact name of a help topic, Get-Help displays
the topic contents. If you enter a word or word pattern that appears in
sev
        eral help topic titles, Get-Help displays a list of the matching
titles. If you enter a word that does not match any help topic titles, Ge
        t-Help displays a list of topics that include that word in their
contents.

        The names of conceptual topics, such as about_Objects, must be
entered in English, even in non-English versions of Windows PowerShell.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        true (ByPropertyName)
        Accept wildcard characters?   false
    -Online [<SwitchParameter>]
        Displays the online version of a help topic in the default
Internet browser. This parameter is valid only for cmdlet, function, and
script
         help topics.

        Get-Help uses the Internet address (Uniform Resource Identifier
[URI]) that appears in the first item of the Related Links section of a
cm
        dlet, function, or script help topic. This parameter works only
when the help topic includes a URI that begins with "Http" or "Https" and
        an Internet browser is installed on the system.

        For information about supporting this feature in help topics that
you write, see about_Comment_Based_Help, and see "How to Write Cmdlet He
        lp" in the MSDN (Microsoft Developer Network) library at
http://go.microsoft.com/fwlink/?LinkID=123415.

        Required?                     false
        Position?                     named
        Default value                 None
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -Parameter <string>
        Displays only the detailed descriptions of the specified
parameters. Wildcards are permitted.

        This parameter has no effect on displays of conceptual ("About_")
help.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -Path <string>
        Gets help that explains how the cmdlet works in the specified
provider path. Enter a Windows PowerShell provider path.

        This parameter gets a customized version of a cmdlet help topic
that explains how the cmdlet works in the specified Windows PowerShell
pro
        vider path. This parameter is effective only for help about a
provider cmdlet and only when the provider includes a custom version of
the
        provider cmdlet help topic.

        To see the custom cmdlet help for a provider path, go to the
provider path location and enter a Get-Help command or, from any path
locatio
        n, use the Path parameter of Get-Help to specify the provider
path. For more information, see about_Providers.
           Required?                     false
           Position?                     named
           Default value
           Accept pipeline input?        false
           Accept wildcard characters?   false

    -Role <string[]>
        Displays help customized for the specified user role. Enter a
role. Wildcards are permitted.

         Enter the role that the user plays in an organization. Some
cmdlets display different text in their help files based on the value of
this
         parameter. This parameter has no effect on help for the core
cmdlets.

           Required?                     false
           Position?                     named
           Default value
           Accept pipeline input?        false
           Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS
    None
           You cannot pipe objects to this cmdlet.


OUTPUTS
    System.String or MamlCommandHelpInfo
        If you request a conceptual topic, Get-Help returns it as a
string. If you specify the name of a cmdlet,, function, or script, it
returns
        a MamlCommandHelpInfo object. Otherwise, Get-Help returns one of
the formatted views that are specified in the Help.Format.ps1xml file in
        the $pshome directory.


NOTES


        Without parameters, "Get-Help" displays information about the
Windows PowerShell help system.

        The full view of help (-full) includes a table of information
about the parameters. The table includes the following fields:
        -- Required:   Indicates whether the parameter is required (true)
or optional (false).

         -- Position: Indicates whether the parameter is named or
positional (numbered). Positional parameters must appear in a specified
place in
          the command.

        -- "Named" indicates that the parameter name is required, but
that the parameter can appear anywhere in the command.

        -- <Number> indicates that the parameter name is optional, but
when the name is omitted, the parameter must be in the place specified by
t
        he number. For example, "2" indicates that when the parameter
name is omitted, the parameter must be the second (2) or only unnamed
parame
        ter in the command. When the parameter name is used, the
parameter can appear anywhere in the command.

        -- Default value: The parameter value that Windows PowerShell
uses if you do not include the parameter in the command.

        -- Accepts pipeline input: Indicates whether you can (true) or
cannot (false) send objects to the parameter through a pipeline. "By
Proper
        ty Name" means that the pipelined object must have a property
with the same name as the parameter name.

        -- Accepts wildcard characters: Indicates whether the value of a
parameter can include wildcard characters, such as * and ?.


    -------------------------- EXAMPLE 1 --------------------------

    C:\PS>get-help


    Description
    -----------
    This command displays help about the Windows PowerShell help system.




    -------------------------- EXAMPLE 2 --------------------------

    C:\PS>get-help *


    Description
    -----------
    This command displays a list of all help files in the Windows
PowerShell help system.




    -------------------------- EXAMPLE 3 --------------------------

    C:\PS>get-help get-alias

    C:\PS>help get-alias

    C:\PS>get-alias -?


    Description
    -----------
    These commands display basic information about the get-alias cmdlet.
The "Get-Help" and "-?" commands display the information on a single page
    . The "Help" command displays the information one page at a time.




    -------------------------- EXAMPLE 4 --------------------------

    C:\PS>get-help about_*


    Description
    -----------
    This command displays a list of the conceptual topics included in
Windows PowerShell help. All of these topics begin with the characters
"abou
    t_". To display a particular help file, type "get-help <topic-name>,
for example, "get-help about_signing".




    -------------------------- EXAMPLE 5 --------------------------

    C:\PS>get-help ls -detailed


    Description
    -----------
    This command displays detailed help for the Get-ChildItem cmdlet by
specifying one of its aliases, "ls." The Detailed parameter requests the
d
    etailed view of the help file, which includes parameter descriptions
and examples. To see the complete help file for a cmdlet, use the Full pa
    rameter.




    -------------------------- EXAMPLE 6 --------------------------

    C:\PS>get-help format-string -full


    Description
    -----------
    This command displays the full view help for the Format-String
cmdlet. The full view of help includes parameter descriptions, examples,
and a
    table of technical details about the parameters.




    -------------------------- EXAMPLE 7 --------------------------

    C:\PS>get-help start-service -examples


    Description
    -----------
    This command displays examples of using start-service in Windows
PowerShell commands.




    -------------------------- EXAMPLE 8 --------------------------

    C:\PS>get-help get-childitem -parameter f*


     Description
     -----------
     This command displays descriptions of the parameters of the Get-
ChildItem cmdlet that begin with "f" (filter and force). For descriptions
of a
     ll parameters, type "get-help get-childitem parameter*".
    -------------------------- EXAMPLE 9 --------------------------

    C:\PS>(get-help write-output).syntax


    Description
    -----------
    This command displays only the syntax of the Write-Output cmdlet.

    Syntax is one of many properties of help objects; others are
description, details, examples, and parameters. To find all properties
and method
    s of help objects, type "get-help <cmdlet-name> | get-member"; for
example, "get-help start-service | get member".




    -------------------------- EXAMPLE 10 --------------------------

    C:\PS>(get-help trace-command).alertset


    Description
    -----------
    This command displays the notes about the cmdlet. The notes are
stored in the alertSet property of the help object.

    The notes include conceptual information and tips for using the
cmdlet. By default, the notes are displayed only when you use the Full
paramet
    er of Get-Help, but you can also display them by using the alertSet
property.




    -------------------------- EXAMPLE 11 --------------------------

    C:\PS>get-help add-member -full | out-string -stream | select-string
-pattern clixml


    Description
    -----------
    This example shows how to search for a word in particular cmdlet help
topic. This command searches for the word "clixml" in the full version o
    f the help topic for the Add-Member cmdlet.

    Because the Get-Help cmdlet generates a MamlCommandHelpInfo object,
not a string, you need to use a command that transforms the help topic
con
    tent into a string, such as Out-String or Out-File.




    -------------------------- EXAMPLE 12 --------------------------

    C:\PS>get-help get-member -online


    Description
    -----------
    This command displays the online version of the help topic for the
Get-Member cmdlet.




    -------------------------- EXAMPLE 13 --------------------------

    C:\PS>get-help remoting


    Description
    -----------
    This command displays a list of topics that include the word
"remoting" in their contents.

    When you enter a word that does not appear in any topic title, Get-
Help displays a list of topics that include that word.




    -------------------------- EXAMPLE 14 --------------------------

    C:\PS>get-help get-item -path SQLSERVER:\DataCollection

    NAME
           Get-Item

    SYNOPSIS
        Gets a collection of Server objects for the local computer and
any computers to which you have made a SQL Server PowerShell connection.

    ...

    C:\PS> cd SQLSERVER:\DataCollection
    C:\PS> SQLSERVER:\DataCollection> get-help get-item
    NAME
           Get-Item

    SYNOPSIS
        Gets a collection of Server objects for the local computer and
any computers to which you have made a SQL Server PowerShell connection.

    ...


    C:\PS> Get-Item

    NAME
           Get-Item

    SYNOPSIS
        Gets the item at the specified location.

    ...


    Description
    -----------
    This example shows how to get help for the Get-Item cmdlet that
explains how to use the cmdlet in the DataCollection node of the Windows
Power
    Shell SQL Server provider.

    The example shows two ways of getting the custom help for Get-Item.

    The first command uses the Path parameter of Get-Help to specify the
provider path. This command can be entered at any path location.

    The second command uses the Set-Location cmdlet (alias = "cd") to go
to the provider path. From that location, even without the Path parameter
    , the Get-Help command gets the custom help for the provider path.

     The third command shows that a Get-Help command in a file system
path, and without the Path parameter, gets the standard help for the Get-
Item
      cmdlet.




    -------------------------- EXAMPLE 15 --------------------------

    C:\PS>get-help c:\ps-test\MyScript.ps1


    Description
    -----------
    This command gets help for the MyScript.ps1 script. For information
about writing help for your functions and scripts, see
about_Comment_Based
    _Help.




RELATED LINKS
    Online version: http://go.microsoft.com/fwlink/?LinkID=113316

       about_Comment_Based_Help
       Get-Command
       Get-PSDrive
       Get-Member

I:

NAME
       Import-ContactList

SYNOPSIS
    Use the Import-ContactList cmdlet and a CSV file to import a user's
mail contacts to a cloud-based mailbox. Users can use an e-mail client to
    export their contacts to a CSV file that is formatted for Microsoft
Office Outlook.

SYNTAX
    Import-ContactList -Identity <MailboxIdParameter> -CSV
<SwitchParameter> -CSVData <Byte[]> [-Confirm [<SwitchParameter>]] [-
DomainController <
    Fqdn>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

    Import-ContactList -Identity <MailboxIdParameter> -CSV
<SwitchParameter> -CSVStream <Stream> [-Confirm [<SwitchParameter>]] [-
DomainController
     <Fqdn>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The Import-ContactList cmdlet submits a request to import a list of
mail contacts that are contained in a CSV file to a cloud-based mailbox.
M
    any MAPI and Web-based e-mail clients allow users to export contacts
to a Microsoft Office Outlook CSV format. Users can then provide that CSV
     file to you to import contacts to their cloud-based mailbox. During
the import process, Microsoft Exchange matches the column names in the he
    ader row of the CSV file to the property names of an Exchange
contact.


PARAMETERS
    -CSV <SwitchParameter>
        The CSV parameter simply specifies that the contacts will be
imported from a CSV file.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -CSVData <Byte[]>
        The CSVData parameter specifies the CSV file you want to import.
Use the following syntax for this parameter: ([System.IO.File]::ReadAllBy
        tes("<file name and path>")). For example,
([System.IO.File]::ReadAllBytes("C:\My Documents\Contacts.csv")).

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -CSVStream <Stream>
        This parameter is reserved for internal Microsoft use.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Identity <MailboxIdParameter>
        The Identity parameter specifies the target mailbox to which the
contacts are imported. You can use any value that uniquely identifies the
         mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
          nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE --------------------------
    This example imports a list of contacts in a CSV file named
TerryAdams.csv to a mailbox for a user whose e-mail address is
terrya@contoso.edu.

    Import-ContactList -CSV -CSVData
([System.IO.File]::ReadAllBytes("D:\Users\Administrator\Desktop\TerryAdam
s.csv")) -Identity terrya@contoso.ed
    u




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2a354fe4-
34ed-4f8a-bc21-e092b27e133d(EXCHG.141).aspx

NAME
       Import-RMSTrustedPublishingDomain

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the Import-RMSTrustedPublishingDomain cmdlet to import a trusted
publishing domain (TPD) from an on-premises server running Microsoft Acti
    ve Directory Rights Management Services (AD RMS) into your cloud-
based organization.

SYNTAX
    Import-RMSTrustedPublishingDomain -Name <String> -
ExtranetLicensingUrl <Uri> -FileData <Byte[]> -IntranetLicensingUrl <Uri>
-Password <SecureS
    tring> [-Confirm [<SwitchParameter>]] [-Default <SwitchParameter>] [-
DomainController <Fqdn>] [-ExtranetCertificationUrl <Uri>] [-IntranetCert
    ificationUrl <Uri>] [-Organization <OrganizationIdParameter>] [-
WhatIf [<SwitchParameter>]] [<CommonParameters>]

    Import-RMSTrustedPublishingDomain -Name <String> -FileData <Byte[]> -
Password <SecureString> [-Confirm [<SwitchParameter>]] [-Default <SwitchP
    arameter>] [-DomainController <Fqdn>] [-ExtranetCertificationUrl
<Uri>] [-IntranetCertificationUrl <Uri>] [-Organization
<OrganizationIdParame
    ter>] [-RefreshTemplates <SwitchParameter>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    A trusted publishing domain (TPD) contains the settings needed to use
RMS features in your organization. For example, users can apply RMS temp
    lates to e-mail messages. After you export the TPD from an on-
premises AD RMS server to an XML file, you can import the XML file into
your clo
    ud-based organization.
    Note   You can import trusted publishing domains from AD RMS servers
running on all versions of Windows Server 2003 and Windows Server 2008.
    If the InternalLicensingEnabled parameter is $true on the Set-
IRMConfiguration cmdlet, all trusted publishing domains require a private
key. I
    f InternalLicensingEnabled is $false, trusted publishing domains
don't require a private key. However, the only RMS feature available to
the o
    rganization is Outlook protection rules. Typically, trusted
publishing domains without private keys are created when the AD RMS
server uses a
    hardware-based cryptography services provider (CSP) or a custom CSP.


PARAMETERS
    -ExtranetLicensingUrl <Uri>
         The ExtranetLicensingUrl specifies the external licensing URL of
the on-premises AD RMS server that's stamped into the publishing license.
          The publishing license specifies the users that can open the
rights-protected content, under which conditions the content may be
opened b
         y the user, and the rights that each user will have to the
rights-protected content.
         By default, the value of the ExtranetCertificationUrl parameter
is https://<FQDN>/_wmcs/licensing.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -FileData <Byte[]>
        The FileData parameter specifies the XML file you want to import.
The XML file contains the trusted publishing domain you exported from th
        e on-premises AD RMS server.
        You need to read the file to a byte-encoded object using the Get-
Content cmdlet, for example, ([byte[]](Get-Content -Encoding byte -Path "
        C:\My Documents\contoso.xml" -ReadCount 0)).

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IntranetLicensingUrl <Uri>
         The IntranetLicensingUrl specifies the internal licensing URL of
the on-premises AD RMS server that's stamped into the publishing license.
          The publishing license specifies the users that can open the
rights-protected content, under which conditions the content may be
opened b
         y the user, and the rights that each user will have to the
rights-protected content.
        By default, the value of the IntranetLicensingUrl parameter is
https://<server name>/_wmcs/licensing.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Name <String>
        The Name parameter specifies the name of the trusted publishing
domain. If you use the RefreshTemplates parameter, the value must match
th
        e name of the previously imported trusted publishing domain.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Password <SecureString>
        The Password parameter specifies the password of the trusted
publishing domain that you want to import. You must specify the value for
thi
        s parameter in a secure format, for example, (ConvertTo-
SecureString -String '<password>' -AsPlainText -Force).
        The password value must match the password in the XML file when
you exported the trusted publishing domain from the on-premises AD RMS
ser
        ver.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Default <SwitchParameter>
         The Default parameter specifies this is the default trusted
publishing domain. The default trusted publishing domain displays RMS
template
        s and provides rights protection to all new content. There can be
only one default trusted publishing domain in an organization.
        The first trusted publishing domain you import into your
organization is automatically set as the default.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExtranetCertificationUrl <Uri>
        The ExtranetCertificationUrl specifies the external certification
URL of the on-premises AD RMS server that's stamped into the rights acco
        unt certificate (RAC). The RAC establishes a user's identity in
the AD RMS system, and is used to decrypt content.
        By default, the value of the ExtranetCertificationUrl parameter
is https://<FQDN>/_wmcs/certification/servercertification.asmx.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IntranetCertificationUrl <Uri>
        The IntranetCertificationUrl specifies the internal certification
URL of the on-premises AD RMS server that's stamped into the rights acco
        unt certificate (RAC). The RAC establishes a user's identity in
the AD RMS system, and is used to decrypt content.
        By default, the value of the IntranetCertificationUrl parameter
is https://<server name>/_wmcs/certification/servercertification.asmx.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Organization <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -RefreshTemplates <SwitchParameter>
         The RefreshTemplates parameter allows you to update the RMS
templates in previously imported trusted publishing domain. When you add,
modi
         fy, or remove RMS templates in a trusted publishing domain on the
AD RMS server, you export the updated trusted publishing domain to a new
          XML file, and import the new XML file in your cloud-based
organization. The RefreshTemplates parameter uses the following rules:
         * Only the FileData, Password, and Name parameters are required.
The value of the Name parameter must match the name of the previously imp
           orted trusted publishing domain.
         * If the new XML file doesn't contain an RMS template that was
defined in the previously imported trusted publishing domain, the RMS
templ
           ate is removed from the cloud-based organization.
         * If the new XML file contains an updated RMS template that was
defined in the previously imported trusted publishing domain, the RMS
temp
           late settings are updated in the cloud-based organization.
However, the RMS template isn't changed from Archived to Distributed or
vice-
           versa.
         * If the new XML file contains a RMS template that wasn't
imported in the original trusted publishing domain, the RMS template is
added to
            the cloud-based organization in the Archived state. To make
the new RMS template usable, you must change its state from Archived to
Dis
           tributed using the Set-RMSTemplate cmdlet.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
           "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example imports a trusted publishing domain from an AD RMS
server into a cloud-based organization. The trusted publishing domain
uses the
     following values:

       Path to exported XML file    C:\My Documents\Contoso.xml
       Password of exported XML file    Pa$$word1
       External licensing URL    https://rms.contoso.com/_wmcs/licensing
       Internal licensing URL    https://RMS01/_wmcs/licensing
       Trusted publishing domain name    "Contoso TPD"

     Import-RMSTrustedPublishingDomain -Name "Contoso TPD" -FileData
$([byte[]](Get-Content -Encoding byte -Path "C:\My Documents\Contoso.xml"
-Rea
     dCount 0)) -Password (ConvertTo-SecureString -String 'Pa$$word1' -
AstPlainText -Force)-ExtranetLicensingUrl https://rms.contoso.com -
IntranetL
     icensingUrl https://RMS01/_wmcs/licensing




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/7c5e7a0f-
9c9d-4863-bab8-bcc729cc16a6(EXCHG.141).aspx

ImportSystemModules

NAME
       Import-UMPrompt
SYNOPSIS
    Use the Import-UMPrompt cmdlet to copy or upload a custom audio file
to be used by Unified Messaging (UM) dial plans and auto attendants.

SYNTAX
    Import-UMPrompt -PromptFileData <Byte[]> -PromptFileName <String> -
UMDialPlan <UMDialPlanIdParameter> [-Confirm [<SwitchParameter>]] [-
DomainC
    ontroller <Fqdn>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

    Import-UMPrompt -PromptFileData <Byte[]> -PromptFileName <String> -
UMAutoAttendant <UMAutoAttendantIdParameter> [-Confirm
[<SwitchParameter>]]
     [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    Import-UMPrompt -PromptFileName <String> -PromptFileStream <Stream> -
UMAutoAttendant <UMAutoAttendantIdParameter> [-Confirm [<SwitchParameter>
    ]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    Import-UMPrompt -PromptFileName <String> -PromptFileStream <Stream> -
UMDialPlan <UMDialPlanIdParameter> [-Confirm [<SwitchParameter>]] [-Domai
    nController <Fqdn>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]


DESCRIPTION
    The Import-UMPrompt cmdlet imports custom greeting audio files into
UM dial plans and auto attendants. There are many custom greetings used
by
     UM dial plans and auto attendants including welcome greetings for
dial plans and after hours welcome greetings and menus, business hours
and
    non-business hours welcome greetings and menus, and key mappings for
UM auto attendants.
    After this task is completed, the custom audio file can be used by a
UM dial plan or auto attendant.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"UM m
    ailbox" entry in the Unified Messaging Permissions topic.


PARAMETERS
    -PromptFileData <Byte[]>
        The PromptFileData parameter specifies the byte array of the
custom prompt.
        For more information about the syntax required to use this
parameter, see Understanding Importing and Exporting Files in the
Exchange Mana
        gement Shell.
        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -PromptFileName <String>
        The PromptFileName parameter specifies the name of the custom
prompt.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -PromptFileStream <Stream>
        The PromptFileStream parameter specifies whether the audio file
will be uploaded or imported as an audio stream and not a byte array. The
        default setting is for the audio file to imported as a byte
array.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -UMAutoAttendant <UMAutoAttendantIdParameter>
        The UMAutoAttendant parameter specifies the UM auto attendant ID.
This parameter specifies the directory object identifier for the UM auto
         attendant.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -UMDialPlan <UMDialPlanIdParameter>
        The UMDialPlan parameter specifies the UM dial plan ID. This
parameter specifies the directory object identifier for the UM dial plan.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch can be used to suppress the confirmation
prompt that appears by default when this cmdlet is run. To suppress the
confir
        mation prompt, use the syntax -Confirm:$False. You must include a
colon ( : ) in the syntax.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- Example 1 --------------------------
    This example imports the welcome greeting file welcomegreeting.wav
from d:\UMPrompts into the UM dial plan MyUMDialPlan.

    [byte[]]$c = Get-content -Path "d:\UMPrompts\welcomegreeting.wav" -
Encoding Byte -ReadCount 0
    Import-UMPrompt -UMDialPlan MyUMDialPlan -PromptFileName
"welcomegreeting.wav" -PromptFileData $c




    -------------------------- Example 2 --------------------------




    This example imports the welcome greeting file welcomegreeting.wav
from d:\UMPrompts into the UM auto attendant MyUMAutoAttendant.

    [byte[]]$c = Get-content -Path "d:\UMPrompts\welcomegreeting.wav" -
Encoding Byte -ReadCount 0
    Import-UMPrompt -UMAutoAttendant MyUMAutoAttendant -PromptFileName
"welcomegreeting.wav" -PromptFileData $c




    -------------------------- Example 3 --------------------------




    This example imports the welcome greeting file
AfterHoursWelcomeGreeting.wav from d:\UMPrompts into the UM auto
attendant MyUMAutoAttendant.

    [byte[]]$c = Get-content -Path
"d:\UMPrompts\AfterHoursWelcomeGreeting.wav" -Encoding Byte -ReadCount 0
    Import-UMPrompt -UMAutoAttendant MyUMAutoAttendant -PromptFileName
"AfterHoursWelcomeGreeting.wav" -PromptFileData $c




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/6a91a841-
a054-4b30-a899-2c51c997f527(EXCHG.141).aspx
J:

K:

L:

M:

NAME
       New-Item

SYNOPSIS
    Creates a new item.

SYNTAX
    New-Item [-Path] <string[]> [-Credential <PSCredential>] [-Force] [-
ItemType <string>] [-Value <Object>] [-Confirm] [-WhatIf] [-
UseTransaction
    ] [<CommonParameters>]

    New-Item -Name <string> [[-Path] <string[]>] [-Credential
<PSCredential>] [-Force] [-ItemType <string>] [-Value <Object>] [-
Confirm] [-WhatIf]
     [-UseTransaction] [<CommonParameters>]


DESCRIPTION
    The New-Item cmdlet creates a new item and sets its value. The types
of items that can be created depend upon the location of the item. For ex
    ample, in the file system, New-Item is used to create files and
folders. In the registry, New-Item creates registry keys and entries.

    New-Item can also set the value of the items that it creates. For
example, when creating a new file, New-Item can add initial content to
the f
    ile.


PARAMETERS
    -Credential <PSCredential>
        Specifies a user account that has permission to perform this
action. The default is the current user.

        Type a user name, such as "User01" or "Domain01\User01", or enter
a PSCredential object, such as one generated by the Get-Credential cmdle
        t. If you type a user name, you will be prompted for a password.

        This parameter is not supported by any providers installed with
Windows PowerShell

           Required?                 false
           Position?                 named
           Default value
        Accept pipeline input?        true (ByPropertyName)
        Accept wildcard characters?   false

    -Force [<SwitchParameter>]
        Allows the cmdlet to create an item that writes over an existing
read-only item. Implementation varies from provider to provider. For more
         information, see about_Providers. Even using the Force
parameter, the cmdlet cannot override security restrictions.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -ItemType <string>
        Specifies the provider-specified type of the new item.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        true (ByPropertyName)
        Accept wildcard characters?   false

    -Name <string>
        Specifies the name of the new item. You can use this parameter to
specify the name of the new item, or include the name in the value of th
        e Path parameter.

        Required?                     true
        Position?                     named
        Default value
        Accept pipeline input?        true (ByPropertyName)
        Accept wildcard characters?   false

    -Path <string[]>
        Specifies the path to the location of the new item. Wildcards are
permitted.

        You can specify the name of the new item in the Name parameter,
or include it in the Path parameter.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        true (ByPropertyName)
        Accept wildcard characters?   false

    -Value <Object>
        Specifies the value of the new item. You can also pipe a value to
New-Item.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        true (ByValue, ByPropertyName)
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        Prompts you for confirmation before executing the command.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -WhatIf [<SwitchParameter>]
        Describes what would happen if you executed the command without
actually executing the command.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    -UseTransaction [<SwitchParameter>]
        Includes the command in the active transaction. This parameter is
valid only when a transaction is in progress. For more information, see
        about_Transactions.

        Required?                     false
        Position?                     named
        Default value
        Accept pipeline input?        false
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS
    System.Object
        You can pipe a value for the new item to the New-Item cmdlet.


OUTPUTS
    System.Object
        New-Item returns the item that it creates.


NOTES
        The New-Item cmdlet is designed to work with the data exposed by
any provider. To list the providers available in your session, type "Get-
        PsProvider". For more information, see about_Providers.


    -------------------------- EXAMPLE 1 --------------------------

    C:\PS>new-item -path . -name testfile1.txt -type "file" -value "This
is a text string."


    Description
    -----------
    This command creates a text file named testfile1.txt in the current
directory. The dot (.) in the value of the Path parameter indicates the
cu
    rrent directory. The quoted text that follows the Value parameter is
added to the file as content.




    -------------------------- EXAMPLE 2 --------------------------

    C:\PS>new-item -path c:\ -name logfiles -type directory


    Description
    -----------
    This command creates a directory named Logfiles in the C: drive. The
Type parameter specifies that the new item is a directory, not a file or
    other file system object.




    -------------------------- EXAMPLE 3 --------------------------

    C:\PS>new-item -path $profile -type file -force


    Description
    -----------
    This command creates a Windows PowerShell profile in the path that is
specified by the $profile variable.

    You can use profiles to customize Windows PowerShell. $Profile is an
automatic (built-in) variable that stores the path and file name of the C
    urrentUser/CurrentHost profile. By default, the profile does not
exist, even though Windows PowerShell stores a path and file name for it.
    In this command, the $profile variable represents the path to the
file. The Type parameter (or InfoType) specifies that the command creates
a
    file. The Force parameter lets you create a file in the profile path,
even when the directories in the path do not exist (Windows PowerShell c
    reates them).

    After you use this command to create a profile, you can enter
aliases, functions, and scripts in the profile to customize your shell.

    For more information, see about_Automatic_Variables and
about_Profiles.




       -------------------------- EXAMPLE 4 --------------------------

       C:\PS>new-item -type directory -path c:\ps-test\scripts


    Description
    -----------
    This command creates a new Scripts directory in the C:\PS-Test
directory.

    The name of the new directory item, Scripts, is included in the value
of the Path parameter, instead of being specified in the value of the Na
    me parameter. As indicated by the syntax, either command form is
valid.




RELATED LINKS
    Online version: http://go.microsoft.com/fwlink/?LinkID=113353
    about_Providers
    Get-Item
    Set-Item
    Remove-Item
    Clear-Item
    Invoke-Item
    Rename-Item
    Move-Item
    Copy-Item

more

N:

NAME
    New-ActiveSyncDeviceAccessRule

SYNOPSIS
    Use the New-ActiveSyncDeviceAccessRule cmdlet to define an access
group of Exchange mobile devices along with their access level.

SYNTAX
    New-ActiveSyncDeviceAccessRule -AccessLevel <Allow | Block |
Quarantine> -Characteristic <DeviceType | DeviceModel> -QueryString
<String> [-Co
    nfirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Organization
<OrganizationIdParameter>] [-WhatIf [<SwitchParameter>]] [<CommonParamete
    rs>]


DESCRIPTION
    You can create multiple groups of devices: allowed devices, blocked
devices, and quarantined devices.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Exch
    ange ActiveSync settings" entry in the Client Access Permissions
topic.


PARAMETERS
    -AccessLevel <Allow | Block | Quarantine>
        The AccessLevel parameter specifies the state of all devices.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Characteristic <DeviceType | DeviceModel>
        The Characterisic parameter specifies the device characteristic
that the query string is to be compared to.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -QueryString <String>
        The QueryString parameter specifies which devices this rule
applies to.

        Required?                     true
        Position?                     Named
        Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       <CommonParameters>
           This cmdlet supports the common parameters: Verbose, Debug,
           ErrorAction, ErrorVariable, WarningAction, WarningVariable,
           OutBuffer and OutVariable. For more information, type,
          "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE 1 --------------------------




    This example creates a device access rule that applies to devices
defined with the QueryString parameter set to PocketPC for the device
model
    and blocks those devices.

    New-ActiveSyncDeviceAccessRule -QueryString PocketPC -Characteristic
DeviceModel -AccessLevel Block




       -------------------------- EXAMPLE 2 --------------------------




     This example creates a device access rule that applies to devices
defined with the QueryString parameter set to SmartPhone for the device
mode
     l and allows those devices.

    New-ActiveSyncDeviceAccessRule -QueryString SmartPhone -
Characteristic DeviceModel -AccessLevel Allow




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/a33c69d8-
4d19-4e9d-b5cf-27727b7c4a8f(EXCHG.141).aspx

NAME
    New-ActiveSyncMailboxPolicy

SYNOPSIS
    Use the New-ActiveSyncMailboxPolicy cmdlet to create a new Microsoft
Exchange ActiveSync mailbox policy object.

SYNTAX
     new-ActiveSyncMailboxPolicy -Name <String> [-AllowBluetooth <Disable
| HandsfreeOnly | Allow>] [-AllowBrowser <$true | $false>] [-AllowCamera
     <$true | $false>] [-AllowConsumerEmail <$true | $false>] [-
AllowDesktopSync <$true | $false>] [-AllowExternalDeviceManagement <$true
| $false>
     ] [-AllowHTMLEmail <$true | $false>] [-AllowInternetSharing <$true |
$false>] [-AllowIrDA <$true | $false>] [-AllowMobileOTAUpdate <$true | $f
     alse>] [-AllowNonProvisionableDevices <$true | $false>] [-
AllowPOPIMAPEmail <$true | $false>] [-AllowRemoteDesktop <$true |
$false>] [-AllowSi
     mpleDevicePassword <$true | $false>] [-
AllowSMIMEEncryptionAlgorithmNegotiation <BlockNegotiation |
OnlyStrongAlgorithmNegotiation | AllowAnyA
     lgorithmNegotiation>] [-AllowSMIMESoftCerts <$true | $false>] [-
AllowStorageCard <$true | $false>] [-AllowTextMessaging <$true | $false>]
[-Al
     lowUnsignedApplications <$true | $false>] [-
AllowUnsignedInstallationPackages <$true | $false>] [-AllowWiFi <$true |
$false>] [-AlphanumericDe
     vicePasswordRequired <$true | $false>] [-ApprovedApplicationList
<ApprovedApplicationCollection>] [-AttachmentsEnabled <$true | $false>]
[-Con
     firm [<SwitchParameter>]] [-DeviceEncryptionEnabled <$true | $false>]
[-DevicePasswordEnabled <$true | $false>] [-DevicePasswordExpiration <Un
     limited>] [-DevicePasswordHistory <Int32>] [-
DevicePolicyRefreshInterval <Unlimited>] [-DomainController <Fqdn>] [-
IrmEnabled <$true | $false>
     ] [-IsDefaultPolicy <$true | $false>] [-MaxAttachmentSize
<Unlimited>] [-MaxCalendarAgeFilter <All | TwoWeeks | OneMonth |
ThreeMonths | SixMo
     nths>] [-MaxDevicePasswordFailedAttempts <Unlimited>] [-
MaxEmailAgeFilter <All | OneDay | ThreeDays | OneWeek | TwoWeeks |
OneMonth>] [-MaxEma
     ilBodyTruncationSize <Unlimited>] [-MaxEmailHTMLBodyTruncationSize
<Unlimited>] [-MaxInactivityTimeDeviceLock <Unlimited>] [-
MinDevicePassword
     ComplexCharacters <Int32>] [-MinDevicePasswordLength <Int32>] [-
MobileOTAUpdateMode <MajorVersionUpdates | MinorVersionUpdates |
BetaVersionUp
     dates>] [-Organization <OrganizationIdParameter>] [-
PasswordRecoveryEnabled <$true | $false>] [-RequireDeviceEncryption
<$true | $false>] [-Re
     quireEncryptedSMIMEMessages <$true | $false>] [-
RequireEncryptionSMIMEAlgorithm <TripleDES | DES | RC2128bit | RC264bit |
RC240bit>] [-Require
     ManualSyncWhenRoaming <$true | $false>] [-RequireSignedSMIMEAlgorithm
<SHA1 | MD5>] [-RequireSignedSMIMEMessages <$true | $false>] [-RequireSt
    orageCardEncryption <$true | $false>] [-
UnapprovedInROMApplicationList <MultiValuedProperty>] [-UNCAccessEnabled
<$true | $false>] [-WhatIf [<
    SwitchParameter>]] [-WSSAccessEnabled <$true | $false>]
[<CommonParameters>]


DESCRIPTION
    The New-ActiveSyncMailboxPolicy cmdlet creates an Exchange ActiveSync
policy for mailboxes accessed by mobile phones.
    Some Exchange ActiveSync policy settings require the mobile phone to
have certain built-in features that enforce these security and device man
    agement settings. If your organization allows all devices, you must
set the AllowNonProvisionableDevices parameter to $true. This allows
devic
    es that can't enforce all policy settings to synchronize with your
server.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Exch
    ange ActiveSync mailbox policy settings" entry in the Client Access
Permissions topic.


PARAMETERS
    -Name <String>
        The Name parameter specifies the name of the policy.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowBluetooth <Disable | HandsfreeOnly | Allow>
        The AllowBluetooth parameter specifies whether the Bluetooth
capabilities of the mobile phone are allowed. The available options are
Disab
        le, HandsfreeOnly, and Allow. The default value is Allow.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowBrowser <$true | $false>
        The AllowBrowser parameter indicates whether Microsoft Pocket
Internet Explorer is allowed on the mobile phone. The default value is
$true
        . This parameter doesn't affect third-party browsers.
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowCamera <$true | $false>
        The AllowCamera parameter indicates whether the mobile phone's
camera is allowed. The default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowConsumerEmail <$true | $false>
        The AllowConsumerEmail parameter indicates whether the mobile
phone user can configure a personal e-mail account on the device. The
defaul
        t value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowDesktopSync <$true | $false>
        The AllowDesktopSync parameter specifies whether the mobile phone
can synchronize with a desktop computer through a cable. The default val
        ue is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowExternalDeviceManagement <$true | $false>
        The AllowExternalDeviceManagement parameter specifies whether an
external device management program is allowed to manage the device.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowHTMLEmail <$true | $false>
        The AllowHTMLEmail parameter specifies whether HTML e-mail is
enabled on the device. The default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowInternetSharing <$true | $false>
        The AllowInternetSharing parameter specifies whether the mobile
phone can be used as a modem to connect a computer to the Internet. The
de
        fault value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowIrDA <$true | $false>
        The AllowIrDA parameter specifies whether infrared connections
are allowed to the mobile phone. The default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowMobileOTAUpdate <$true | $false>
        The AllowMobileOTAUpdate parameter specifies whether certain
updates are seen by devices that implemented support for this restricting
fun
        ctionality. Further control can be specified via the
MobileOTAUpdateMode parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowNonProvisionableDevices <$true | $false>
        When set to $true, the AllowNonProvisionableDevices parameter
enables all devices to synchronize with the computer running Exchange,
regar
        dless of whether the device can enforce all the specific settings
established in the Exchange ActiveSync policy. This also includes device
        s managed by a separate device management system. When set to
$false, this parameter blocks these devices that aren't provisioned from
syn
        chronizing with the server running Exchange. The default value is
$false.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowPOPIMAPEmail <$true | $false>
        The AllowPOPIMAPEmail parameter specifies whether the user can
configure a POP3 or IMAP4 e-mail account on the device. The default value
i
        s $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowRemoteDesktop <$true | $false>
        The AllowRemoteDesktop parameter specifies whether the mobile
phone can initiate a remote desktop connection. The default value is
$true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -AllowSimpleDevicePassword <$true | $false>
         The AllowSimpleDevicePassword parameter specifies whether a
simple device password is allowed. A simple device password is a password
that
          has a specific pattern, such as 1111 or 1234. The default value
is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowSMIMEEncryptionAlgorithmNegotiation <BlockNegotiation |
OnlyStrongAlgorithmNegotiation | AllowAnyAlgorithmNegotiation>
        The AllowSMIMEEncryptionAlgorithmNegotiation parameter specifies
whether the messaging application on the device can negotiate the encrypt
        ion algorithm in case a recipient's certificate doesn't support
the specified encryption algorithm.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowSMIMESoftCerts <$true | $false>
        The AllowSMIMESoftCerts parameter specifies whether S/MIME
software certificates are allowed. The default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowStorageCard <$true | $false>
        The AllowStorageCard parameter specifies whether the device can
access information stored on a storage card. The default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowTextMessaging <$true | $false>
        The AllowTextMessaging parameter specifies whether text messaging
is allowed from the device. The default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowUnsignedApplications <$true | $false>
         The AllowUnsignedApplications parameter specifies whether
unsigned applications can be installed on the device. The default value
is $true
         .

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowUnsignedInstallationPackages <$true | $false>
        The AllowUnsignedInstallationPackages parameter specifies whether
unsigned installation packages can be run on the device. The default val
        ue is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AllowWiFi <$true | $false>
        The AllowWiFi parameter specifies whether wireless Internet
access is allowed on the device. The default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AlphanumericDevicePasswordRequired <$true | $false>
        The AlphanumericDevicePasswordRequired parameter specifies that
the device password must be alphanumeric. The default value is $false.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ApprovedApplicationList <ApprovedApplicationCollection>
        The ApprovedApplicationList parameter contains a list of approved
applications for the device.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -AttachmentsEnabled <$true | $false>
        The AttachmentsEnabled parameter specifies whether the user can
download attachments. When set to $false, the user is blocked from
downloa
        ding attachments. The default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DeviceEncryptionEnabled <$true | $false>
        The DeviceEncryptionEnabled parameter, when set to $true, enables
device encryption on the mobile phone. The default value is $false. Curr
        ently, only the storage card can be encrypted on devices running
Windows Mobile 6.0 or later. We recommend that you don't use this setting
         and use the RequireStorageCardEncryption parameter instead.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DevicePasswordEnabled <$true | $false>
        When set to $true, the DevicePasswordEnabled parameter requires
that the user set a password for the device. The default value is $false.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DevicePasswordExpiration <Unlimited>
        The DevicePasswordExpiration parameter specifies the length of
time, in days, that a password can be used. After this length of time, a
ne
        w password must be created. The format of the parameter is
dd.hh.mm:ss, for example, 24.00:00 = 24 hours.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DevicePasswordHistory <Int32>
        The DevicePasswordHistory parameter specifies the number of
previously used passwords to store. When a user creates a new password,
the us
        er can't reuse a stored password that was previously used.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DevicePolicyRefreshInterval <Unlimited>
        The DevicePolicyRefreshInterval parameter specifies how often the
policy is sent from the server to the mobile phone

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IrmEnabled <$true | $false>
        The IrmEnabled parameter specifies whether Information Rights
Management (IRM) is enabled for the mailbox policy.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IsDefaultPolicy <$true | $false>
        The IsDefaultPolicy parameter specifies whether this policy is
the default Exchange ActiveSync mailbox policy. The default value is
$false
        . If another policy is currently set as the default, setting this
parameter replaces the old default policy with this policy.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MaxAttachmentSize <Unlimited>
        The MaxAttachmentSize parameter specifies the maximum size of
attachments that can be downloaded to the mobile phone. The default value
is
         Unlimited.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MaxCalendarAgeFilter <All | TwoWeeks | OneMonth | ThreeMonths |
SixMonths>
        The MaxCalendarAgeFilter parameter specifies the maximum range of
calendar days that can be synchronized to the device. Possible values ar
        e:
        * All
        * TwoWeeks
        * OneMonth
        * ThreeMonths
        * SixMonths

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MaxDevicePasswordFailedAttempts <Unlimited>
        The MaxDevicePasswordFailedAttempts parameter specifies the
number of attempts a user can make to enter the correct password for the
devic
        e. You can enter any number from 4 through 16. The default value
is 8.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MaxEmailAgeFilter <All | OneDay | ThreeDays | OneWeek | TwoWeeks |
OneMonth>
        The MaxEmailAgeFilter parameter specifies the maximum number of
days of e-mail items to synchronize to the device.
        Possible values are:
        * All
        * OneDay
        * ThreeDays
        * OneWeek
        * TwoWeeks
        * OneMonth
        * ThreeMonths
        * SixMonths

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MaxEmailBodyTruncationSize <Unlimited>
        The MaxEmailBodyTruncationSize parameter specifies the maximum
size at which e-mail messages are truncated when synchronized to the
device
        . The value is specified in kilobytes (KB).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MaxEmailHTMLBodyTruncationSize <Unlimited>
        The MaxEmailHTMLBodyTruncationSize parameter specifies the
maximum size at which HTML-formatted e-mail messages are synchronized to
the de
        vice. The value is specified in KB.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MaxInactivityTimeDeviceLock <Unlimited>
        The MaxInactivityTimeDeviceLock parameter specifies the length of
time that the device can be inactive before the password is required to
        reactivate the device. You can enter any interval between 30
seconds and 1 hour. The default value is 15 minutes. The format of the
parame
        ter is hh.mm:ss, for example, 15:00 = 15 minutes.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MinDevicePasswordComplexCharacters <Int32>
        The MinDevicePasswordComplexCharacters parameter specifies the
minimum number of complex characters required in a device password. A
compl
        ex character isn't a letter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MinDevicePasswordLength <Int32>
         The MinDevicePasswordLength parameter specifies the minimum
number of characters in the device password. You can enter any number
from 1 t
         hrough 16. The maximum length a password can be is 16 characters.
The default value is 4.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -MobileOTAUpdateMode <MajorVersionUpdates | MinorVersionUpdates |
BetaVersionUpdates>
        The MobileOTAUpdateMode parameter specifies which updates can be
seen by the devices that implemented support for this restricting functio
        nality. It must be used in conjunction with the
AllowMobileOTAUpdate parameter to function properly.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -PasswordRecoveryEnabled <$true | $false>
        The PasswordRecoveryEnabled parameter specifies whether you can
store the recovery password for the device on an Exchange server. When
set
         to $true, you can store the recovery password for the device on
an Exchange server. The default value is $false. The recovery password ca
        n be viewed from either Microsoft Office Outlook Web App or the
Exchange Management Console.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -RequireDeviceEncryption <$true | $false>
        The RequireDeviceEncryption parameter specifies whether
encryption is required on the device. The default value is $false.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -RequireEncryptedSMIMEMessages <$true | $false>
        The RequireEncryptedSMIMEMessages parameter specifies whether you
must encrypt S/MIME messages. The default value is $false.

          Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RequireEncryptionSMIMEAlgorithm <TripleDES | DES | RC2128bit |
RC264bit | RC240bit>
        The RequireEncryptionSMIMEAlgorithm parameter specifies what
required algorithm must be used when encrypting a message.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RequireManualSyncWhenRoaming <$true | $false>
        The RequireManualSyncWhenRoaming parameter specifies whether the
device must synchronize manually while roaming. The default value is $fal
        se.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RequireSignedSMIMEAlgorithm <SHA1 | MD5>
        The RequireSignedSMIMEAlgorithm parameter specifies what required
algorithm must be used when signing a message.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RequireSignedSMIMEMessages <$true | $false>
        The RequireSignedSMIMEMessages parameter specifies whether the
device must send signed S/MIME messages.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RequireStorageCardEncryption <$true | $false>
        The RequireStorageCardEncryption parameter specifies whether
encryption of a storage card is required. The default value is $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -UnapprovedInROMApplicationList <MultiValuedProperty>
        The UnapprovedInROMApplicationList parameter specifies a list of
applications that can't be run in ROM.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -UNCAccessEnabled <$true | $false>
         The UNCAccessEnabled parameter specifies whether access to
Microsoft Windows file shares is enabled. Access to specific shares is
configur
         ed on the Exchange ActiveSync virtual directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -WSSAccessEnabled <$true | $false>
        The WSSAccessEnabled parameter specifies whether access to
Microsoft Windows SharePoint Services is enabled. Access to specific
shares is
        configured on the Exchange ActiveSync virtual directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
          "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example creates a new Exchange ActiveSync policy named
SalesPolicy that has several preconfigured values.

    New-ActiveSyncMailboxPolicy -Name:"SalesPolicy" -
DevicePasswordEnabled:$true -AlphanumericDevicePasswordRequired:$true -
PasswordRecoveryEnable
    d:$true -IsDefaultPolicy:$false -AttachmentsEnabled:$false -
AllowStorageCard: $true




    -------------------------- EXAMPLE 2 --------------------------




    This example creates a new Exchange ActiveSync policy named
Management that has several preconfigured values. Users assigned to this
policy sh
    ould have an Enterprise client access license (CAL) to use many of
these features.

    New-ActiveSyncMailboxPolicy -Name:"Management" -AllowBluetooth:$true
-AllowBrowser:$true -AllowCamera:$true -AllowPOPIMAPEmail:$false -DeviceP
    asswordEnabled:$true -AlphanumericDevicePasswordRequired:$true -
PasswordRecoveryEnabled:$true -MaxEmailAgeFilter:10 -AllowWiFi:$true -
AllowSto
    rageCard:$true -AllowPOPIMAPEmail:$false




       -------------------------- EXAMPLE 3 --------------------------




    This example creates a new Exchange ActiveSync policy named Contoso
that has several preconfigured values. This policy is configured to be
the
     default policy for the organization. The default policy will be
assigned to all new users.

    New-ActiveSyncMailboxPolicy -Name:"Contoso" -
DevicePasswordEnabled:$true -AlphanumericDevicePasswordRequired:$true -
PasswordRecoveryEnabled:$t
    rue -MinDevicePasswordComplexCharacters:3 -IsDefaultPolicy:$true -
DevicePasswordHistory:10




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/90d6872e-
8e2b-4e53-9554-a2120e99cc20(EXCHG.141).aspx

NAME
       New-AdminAuditLogSearch

SYNOPSIS
    Use the New-AdminAuditLogSearch cmdlet to search the contents of the
administrator audit log and send the results to one or more mailboxes tha
    t you specify.

SYNTAX
    New-AdminAuditLogSearch [-Organization <OrganizationIdParameter>] -
EndDate <ExDateTime> -StartDate <ExDateTime> -StatusMailRecipients
<MultiVa
    luedProperty> [-Cmdlets <MultiValuedProperty>] [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-
ObjectIds <MultiVa
    luedProperty>] [-Parameters <MultiValuedProperty>] [-UserIds
<MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
DESCRIPTION
    After the New-AdminAuditLogSearch cmdlet is run, the report is
delivered to the mailboxes you specify within 15 minutes. The log is
included a
    s an XML attachment on the report e-mail message. The maximum size of
the log that can be generated is 10 MB.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"View
    -only administrator audit logging" entry in the Exchange and Shell
Infrastructure Permissions topic.


PARAMETERS
    -EndDate <ExDateTime>
        The EndDate parameter specifies the scope of the administrator
audit log results to log entries that occurred on or before the specified
d
        ate.
        Specify the day, month, and year in the format specified in your
regional settings.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -StartDate <ExDateTime>
        The StartDate parameter specifies the scope of the administrator
audit log results to log entries that occurred on or after the specified
        date.
        Specify the day, month, and year in the format specified in your
regional settings.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -StatusMailRecipients <MultiValuedProperty>
        The StatusMailRecipients parameter specifies the recipients that
should receive the administrator audit log report. The recipients must be
         valid mailboxes, contacts, or distribution groups in your
Exchange organization.
        You can use the following values:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * Legacy Exchange DN
        * SMTP address
        * Alias

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Cmdlets <MultiValuedProperty>
        The Cmdlets parameter specifies the cmdlets you want to search
for in the administrator audit log. Only the log entries that contain the
c
        mdlets you specify are returned.
        If you want to specify more than one cmdlet, separate each cmdlet
with a comma.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
         The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that retrieves data from
Active D
         irectory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Name <String>
        The Name parameter specifies the name of the administrator audit
log search. The name is shown in the subject line of the audit log report
         e-mail message.
        If the name of the report contains spaces, enclose the name in
quotation marks (").
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ObjectIds <MultiValuedProperty>
        The ObjectIds parameter specifies that only administrator audit
log entries that contain the specified changed objects should be
returned.
         This parameter accepts a variety of objects, such as mailboxes,
aliases, Send connector names, and so on.
        If you want to specify more than one object ID, separate each ID
with a comma.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Organization <OrganizationIdParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     1
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false

    -Parameters <MultiValuedProperty>
        The Parameters parameter specifies the parameters you want to
search for in the administrator audit log. Only the log entries that
contain
         the parameters you specify are returned. You can only use this
parameter if you use the Cmdlets parameter.
        If you want to specify more than one parameter, separate each
parameter with a comma.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -UserIds <MultiValuedProperty>
        The UserIds parameter specifies that only the administrator audit
log entries that contain the specified ID of the user who ran the cmdlet
         should be returned.
        If you want to specify more than one user ID, separate each ID
with a comma.

        Required?                     false
        Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example finds all of the administrator audit log entries that
contain either the New-RoleGroup or New-ManagementRoleAssignment cmdlet
and
     sends the results to the mailbox David Strome.

    New-AdminAuditLogSearch -Name "Role Group Change Audit" -Cmdlets New-
RoleGroup, New-ManagementRoleAssignment -StatusMailRecipients "David Stro
    me"




    -------------------------- EXAMPLE 2 --------------------------
    This example finds all of the administrator audit log entries that
match the following criteria and sends the results to the Compliance
Group
    distribution group and the chrisd alias:

    Cmdlets    Set-Mailbox
    Parameters    UseDatabaseQuotaDefaults, ProhibitSendReceiveQuota,
ProhibitSendQuota
    StartDate    01/24/2010
    EndDate    02/12/2010

    New-AdminAuditLogSearch -Name "Mailbox Quota Change Audit" -Cmdlets
Set-Mailbox -Parameters UseDatabaseQuotaDefaults,
ProhibitSendReceiveQuota
    , ProhibitSendQuota -StartDate 01/24/2010 -EndDate 02/12/2010 -
StatusMailRecipients "Compliance Group", chrisd




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/52a221e0-
ded1-44dc-a626-ca264eca4113(EXCHG.141).aspx

NAME
       New-DistributionGroup

SYNOPSIS
    Use the New-DistributionGroup cmdlet to create a distribution group.

SYNTAX
     New-DistributionGroup -Name <String> [-Alias <String>] [-
ArbitrationMailbox <MailboxIdParameter>] [-BypassNestedModerationEnabled
<$true | $fa
     lse>] [-Confirm [<SwitchParameter>]] [-CopyOwnerToMember
<SwitchParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-
ExternalDirec
     toryObjectId <String>] [-IgnoreNamingPolicy <SwitchParameter>] [-
ManagedBy <RecipientIdParameter[]>] [-MemberDepartRestriction <Closed |
Open
     | ApprovalRequired>] [-MemberJoinRestriction <Closed | Open |
ApprovalRequired>] [-Members <RecipientIdParameter[]>] [-ModeratedBy
<MultiValue
     dProperty>] [-ModerationEnabled <$true | $false>] [-Notes <String>]
[-Organization <OrganizationIdParameter>] [-OrganizationalUnit
<Organizati
     onalUnitIdParameter>] [-OverrideRecipientQuotas <SwitchParameter>] [-
PartnerObjectId <Guid>] [-PrimarySmtpAddress <SmtpAddress>] [-RoomList <S
    witchParameter>] [-SamAccountName <String>] [-
SendModerationNotifications <Never | Internal | Always>] [-Type
<Distribution | Security>] [-Wha
    tIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    You can use the New-DistributionGroup cmdlet to create Active
Directory group objects of the following types:
    * Mail-enabled universal security group
    * Universal distribution group
    Distribution groups are used to consolidate groups of recipients into
a single point of contact for e-mail messages. Distribution groups can't
     be used to assign permissions to network resources in Active
Directory.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Dist
    ribution groups" entry in the Mailbox Permissions topic.


PARAMETERS
    -Name <String>
        The Name parameter specifies the name for the new distribution
group. The value specified in the Name parameter is also used for the
Displ
        ayName parameter if the DisplayName parameter isn't specified.
        The Name parameter value can't exceed 64 characters.
        If a group naming policy is enforced, you need to follow the
naming constraints specified in the DistributionGroupNameBlockedWordList
and
        the DistributionGroupNamingPolicy parameters of the Set-
OrganizationConfig cmdlet.
        If the values of the Name and DisplayName parameters are
different:
        * The Name parameter specifies the distribution group name in
Active Directory Users and Computers and also in the Group Name field in
the
            Exchange Management Console.
        * The DisplayName parameter specifies the distribution group name
in the Exchange Management Console and in the Exchange global address li
           st (GAL).

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Alias <String>
        The Alias parameter specifies the alias of the distribution
group. The Alias parameter is then used to generate the primary SMTP e-
mail ad
        dress of the object. The value of the Alias parameter can't
contain spaces. If the Alias parameter isn't specified, the value of the
SamAc
        countName parameter is used to generate the primary SMTP e-mail
address, with any spaces converted to underscores.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ArbitrationMailbox <MailboxIdParameter>
        The ArbitrationMailbox parameter specifies the mailbox that's
used to manage the moderation process.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -BypassNestedModerationEnabled <$true | $false>
        The BypassNestedModerationEnabled parameter specifies whether to
allow the parent group moderators to provide approval for any nested grou
        ps that are also moderated. If you set this parameter to $true,
after a moderator approves a message sent to this distribution group, the
        message is automatically approved for any other moderated
recipients that are members of this distribution group. The default value
is $fa
        lse.
        This parameter can be set only by top-level organization and
tenant administrators.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch can be used to suppress the confirmation
prompt that appears by default when this cmdlet is run. To suppress the
confir
        mation prompt, use the syntax -Confirm:$False. You must include a
colon ( : ) in the syntax.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -CopyOwnerToMember <SwitchParameter>
        The CopyOwnerToMember parameter specifies that a recipient
specified in the ManagedBy parameter is also a member of the distribution
group
        .

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DisplayName <String>
        The DisplayName parameter specifies the name of the distribution
group in the Exchange Management Console and in the Exchange GAL. If the
        DisplayName parameter isn't specified, the value of the Name
parameter is used for the DisplayName parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExternalDirectoryObjectId <String>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IgnoreNamingPolicy <SwitchParameter>
        The IgnoreNamingPolicy parameter specifies that the naming policy
defined in the DistributionGroupNamingPolicy parameter of the Set-Organi
        zationConfig cmdlet can be ignored. You don't need to specify a
value with this parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ManagedBy <RecipientIdParameter[]>
        The ManagedBy parameter specifies the name of the mailbox
recipient that appears in the Managed by tab of the Active Directory
object. If
        this parameter isn't specified, the creator of the group is the
owner. You can use any of the following values for this parameter:
        * Distinguished name (DN)
        * Canonical name
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * Primary SMTP e-mail address
        The recipients specified with the ManagedBy parameter aren't
members of the distribution group. If you want recipients specified in
this p
        arameter to be added as members of the distribution group, use
the CopyOwnerToMember parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MemberDepartRestriction <Closed | Open | ApprovalRequired>
        The MemberDepartRestriction parameter specifies the restrictions
that you can put on recipients who want to depart the group membership. T
        his parameter can take one of the following values:
        * Open
        * Closed
        * ApprovalRequired
        Universal security groups can't use the Open value. By default,
they're set to Closed.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -MemberJoinRestriction <Closed | Open | ApprovalRequired>
         The MemberJoinRestriction parameter specifies the restrictions
that you can put on recipients who want to join the group membership.
This
         parameter can take one of the following values:
         * Open
         * Closed
         * ApprovalRequired
        Universal security groups can't use the Open value. By default,
they're set to Closed.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Members <RecipientIdParameter[]>
        The Members parameter adds the initial list of members who are a
part of this distribution group. You can use any of the following values
        for this parameter:
        * DN
        * Canonical name
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * Primary SMTP e-mail address

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ModeratedBy <MultiValuedProperty>
        The ModeratedBy parameter specifies the users who are responsible
for moderating the messages sent to this distribution group. To designat
        e more than one user, separate the users by commas.
        The ModeratedBy parameter is required if you set the
ModerationEnabled parameter to $true. If you leave this parameter blank
and there is
        a user already specified as the manager of this distribution
group, the ModeratedBy field is automatically set to the ManagedBy
parameter
        of the distribution group. Otherwise, an error is returned.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ModerationEnabled <$true | $false>
         The ModerationEnabled parameter specifies whether to enable
moderation for the distribution group. To ensure moderation, set this
paramete
         rs to $true. To disable moderation, set this parameter to $false.
         The default value is $false.

        Required?                     false
        Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Notes <String>
        The Notes parameter specifies additional information about the
distribution group.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -OrganizationalUnit <OrganizationalUnitIdParameter>
        The OrganizationalUnit parameter specifies the container where
the distribution group is created.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -OverrideRecipientQuotas <SwitchParameter>
           This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -PartnerObjectId <Guid>
           This parameter is reserved for internal Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -PrimarySmtpAddress <SmtpAddress>
        The PrimarySmtpAddress parameter specifies the primary return
SMTP e-mail address for the distribution group. This parameter has
meaning o
        nly if the distribution group has multiple SMTP e-mail addresses.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RoomList <SwitchParameter>
        The RoomList parameter specifies that all members of the
distribution group are room resource mailboxes. You can create a
distribution lis
        t for an office building in your organization and add all the
rooms in that building to the distribution group. Room list distribution
gro
        ups are then used to generate a list of building locations in
Microsoft Outlook 2010 so the user can select a building and get
information
         about when rooms are available in that building, without having
to add the rooms in that building individually.
        You can't use the RoomList parameter in conjunction with the
ExternalManaged parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SamAccountName <String>
        The SamAccountName parameter specifies the name for clients of
the object running older operating systems. The SamAccountName parameter
is
         displayed in Active Directory and the Exchange Management
Console in the Group name (pre-Windows 2000) field. If the Alias
parameter isn'
        t specified, the following conditions are true:
        * The value of the SamAccountName parameter is used for the value
of the Alias parameter, with any spaces converted to underscores.
        * The SamAccountName parameter, with any spaces converted to
underscores, is used to generate the primary SMTP e-mail address of the
objec
          t.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SendModerationNotifications <Never | Internal | Always>
        The SendModerationNotifications parameter specifies whether
status notifications are sent to users when they send a message to the
moderat
        ed distribution group. You can specify one of the following
values:
        * Always
        * Internal
        * Never
        Set this parameter to Always if you want notifications to be sent
to all senders.
        Set this parameter to Internal if you want notifications to be
sent only to the senders who are internal to your organization.
        Set this parameter to Never to disable all status notifications.
        The senders are always notified if their message is rejected by
the moderators, regardless of the value of the parameter.
        The default value is Never.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Type <Distribution | Security>
        The Type parameter specifies the group type that's created in
Active Directory. The group's scope is always Universal. Valid values are
Di
        stribution or Security.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".
INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example creates a mail-enabled universal security group that has
the following parameters:

    The group   name is Managers.
    The group   is created in the Users container in the domain
contoso.com.
    The group   SamAccountName parameter value is Managers.
    The group   type is Security.

    New-DistributionGroup -Name "Managers" -OrganizationalUnit
"contoso.com/Users" -SamAccountName "Managers" -Type "Security"




    -------------------------- EXAMPLE 2 --------------------------




    This example creates the distribution group ITDepartment and ignores
the naming policy.

    New-DistributionGroup -Name "ITDepartment" -IgnoreNamingPolicy
RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/7446962a-
cf07-47a1-90d8-45df44057065(EXCHG.141).aspx

NAME
       New-DynamicDistributionGroup

SYNOPSIS
    Use the New-DynamicDistributionGroup cmdlet to create a dynamic
distribution group.

SYNTAX
    New-DynamicDistributionGroup -Name <String> -IncludedRecipients <None
| MailboxUsers | Resources | MailContacts | MailGroups | MailUsers | All
    Recipients> [-Alias <String>] [-ArbitrationMailbox
<MailboxIdParameter>] [-ConditionalCompany <MultiValuedProperty>] [-
ConditionalCustomAttrib
    ute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10
<MultiValuedProperty>] [-ConditionalCustomAttribute11
<MultiValuedProperty>] [-Cond
    itionalCustomAttribute12 <MultiValuedProperty>] [-
ConditionalCustomAttribute13 <MultiValuedProperty>] [-
ConditionalCustomAttribute14 <MultiVal
    uedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>]
[-ConditionalCustomAttribute2 <MultiValuedProperty>] [-
ConditionalCustomAt
    tribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4
<MultiValuedProperty>] [-ConditionalCustomAttribute5
<MultiValuedProperty>] [-Co
    nditionalCustomAttribute6 <MultiValuedProperty>] [-
ConditionalCustomAttribute7 <MultiValuedProperty>] [-
ConditionalCustomAttribute8 <MultiValu
    edProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-
ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince
    <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName
<String>] [-DomainController <Fqdn>] [-ExternalDirectoryObjectId
<String>]
     [-ModeratedBy <MultiValuedProperty>] [-ModerationEnabled <$true |
$false>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit
<Or
    ganizationalUnitIdParameter>] [-OverrideRecipientQuotas
<SwitchParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-
RecipientContainer <Organizat
    ionalUnitIdParameter>] [-SendModerationNotifications <Never |
Internal | Always>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

    New-DynamicDistributionGroup -Name <String> -RecipientFilter <String>
[-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-Confirm [
    <SwitchParameter>]] [-DisplayName <String>] [-DomainController
<Fqdn>] [-ExternalDirectoryObjectId <String>] [-ModeratedBy
<MultiValuedPropert
    y>] [-ModerationEnabled <$true | $false>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-Ov
    errideRecipientQuotas <SwitchParameter>] [-PrimarySmtpAddress
<SmtpAddress>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-
SendModer
    ationNotifications <Never | Internal | Always>] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    A dynamic distribution group queries Active Directory mail-enabled
objects and builds the group membership based on the results. The group
mem
    bership is recalculated whenever an e-mail message is sent to the
group. The query filters provided with Microsoft Exchange are limited to
any
     combination of the following parameters:
    * ConditionalCompany
    * ConditionalCustomAttribute
                  N (where N is a value from 1 through 15)
    * ConditionalDepartment
    * ConditionalStateOrProvince
    * IncludedRecipients
    You can also create any custom query using the RecipientFilter
parameter.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Dyna
    mic distribution groups" entry in the Mailbox Permissions topic.


PARAMETERS
    -IncludedRecipients <None | MailboxUsers | Resources | MailContacts |
MailGroups | MailUsers | AllRecipients>
        The IncludedRecipients parameter filters the recipient types used
to build the dynamic distribution group. The IncludedRecipients paramete
        r can't be used if the RecipientFilter parameter is specified.
You can use the following values:
        * AllRecipients
        * MailboxUsers
        * Resources
        * MailContacts
        * MailGroups
        * MailUsers
        * None
        AllRecipients can be used only by itself. When multiple values in
the IncludedRecipients parameter are separated by commas, the OR Boolean
         operator is applied.

        Required?                   true
        Position?                   Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -Name <String>
         The Name parameter specifies the name of the dynamic distribution
group. If the DisplayName parameter isn't specified, the value of the Na
         me parameter is also used for the DisplayName parameter.
         The Name parameter value can't exceed 64 characters.
         If the values of the Name and DisplayName parameters are
different:
         * The Name parameter specifies the dynamic distribution group
name in Active Directory Users and Computers and also in the Group Name
fiel
           d in the Exchange Management Console.
         * The DisplayName parameter specifies the dynamic distribution
group name in the Exchange Management Console and in the Exchange global
ad
           dress list (GAL).

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientFilter <String>
        The RecipientFilter parameter filters the mail-enabled recipients
used to build the dynamic distribution group. The RecipientFilter parame
        ter can't be used if any of the following parameters are
specified:
        * IncludedRecipients
        * ConditionalCompany
        * ConditionalCustomAttribute
                            N (where N is a value from 1 through 15)
        * ConditionalDepartment
        * ConditionalStateOrProvince
        The RecipientFilter parameter uses OPath syntax to query Active
Directory and filter recipients.
        For more information about the filterable properties, see
Filterable Properties for the -RecipientFilter Parameter.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Alias <String>
        The Alias parameter specifies the alias of the dynamic
distribution group. The value of the Alias parameter is used to generate
the primar
        y SMTP e-mail address for the dynamic distribution group. The
value of the Alias parameter can't contain spaces. If the Alias parameter
is
        n't specified, the value of the Name parameter is used for the
value of the Alias parameter, with any spaces in the Name parameter
convert
        ed to underscore characters (_).

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ArbitrationMailbox <MailboxIdParameter>
        The ArbitrationMailbox parameter specifies the mailbox used to
manage the moderation process.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ConditionalCompany <MultiValuedProperty>
        The ConditionalCompany parameter filters the mailbox users or
mail-enabled contacts used to build the dynamic distribution group.
        When multiple values of the ConditionalCompany parameter are
separated by commas, the OR Boolean operator is applied.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute1 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
     -ConditionalCustomAttribute10 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute11 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute12 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
     -ConditionalCustomAttribute13 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute14 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute15 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
     -ConditionalCustomAttribute2 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute3 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute4 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
     -ConditionalCustomAttribute5 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute6 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute7 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
     -ConditionalCustomAttribute8 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -ConditionalCustomAttribute9 <MultiValuedProperty>
         The ConditionalCustomAttribute1 to ConditionalCustomAttribute15
parameters specify filters for recipients' custom attributes. For
example,
          if you set the ConditionalCustomAttribute1 value to Marketing,
all included recipients whose CustomAttribute1 value is Marketing are
incl
         uded in this filter. You must use the IncludedRecipients
parameter if you use a Conditional parameter. You can't use this
parameter if you
          use the RecipientFilter parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ConditionalDepartment <MultiValuedProperty>
        The ConditionalDepartment parameter filters the mailbox users or
mail-enabled contacts used to build the dynamic distribution group. The C
        onditionalDepartment parameter can't be used if the
RecipientFilter parameter is specified.
        When multiple values of the ConditionalDepartment parameter are
separated by commas, the OR Boolean operator is applied.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ConditionalStateOrProvince <MultiValuedProperty>
        The ConditionalStateOrProvince parameter filters mailbox users or
mail-enabled contacts used to build the dynamic distribution group. The
        ConditionalStateOrProvince parameter can't be used if the
RecipientFilter parameter is specified.
        When multiple values of the ConditionalStateOrProvince parameter
are separated by commas, the OR Boolean operator is applied.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

     -DisplayName <String>
         The DisplayName parameter specifies the name of the dynamic
distribution group in the Exchange Management Console and in the Exchange
GAL.
          If the DisplayName parameter isn't specified, the value of the
Name parameter is used for the DisplayName parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExternalDirectoryObjectId <String>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -ModeratedBy <MultiValuedProperty>
         The ModeratedBy parameter specifies the users who are responsible
for moderating the messages sent to this dynamic distribution group. To
         designate more than one user, separate the users with commas.
         This parameter is required if you set the ModerationEnabled
parameter to $true. If you leave this parameter blank and there's a user
who's
          already specified as the manager of this dynamic distribution
group, the ModeratedBy parameter is automatically set to the ManagedBy
para
         meter of the dynamic distribution group. Otherwise, an error is
returned.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -ModerationEnabled <$true | $false>
         The ModerationEnabled parameter specifies whether to enable
moderation for the dynamic distribution group. To enable moderation, set
this
         parameter to $true. To disable moderation, set this parameter to
$false.
         The default value is $false.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -OrganizationalUnit <OrganizationalUnitIdParameter>
         The OrganizationalUnit parameter specifies where to create the
dynamic distribution group in Active Directory by using canonical name
synt
         ax.

          Required?                     false
          Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -OverrideRecipientQuotas <SwitchParameter>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -PrimarySmtpAddress <SmtpAddress>
        The PrimarySmtpAddress parameter specifies the primary return
SMTP e-mail address for the dynamic distribution group. This parameter
has m
        eaning only if the dynamic distribution group has multiple SMTP
e-mail addresses.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientContainer <OrganizationalUnitIdParameter>
        The RecipientContainer parameter filters the recipients used to
build the dynamic distribution group based on their location in Active
Dir
        ectory. The value of the RecipientContainer parameter can be the
canonical name of an organizational unit (OU) or a domain. If you don't s
        pecify a value for the RecipientContainer parameter, the default
search filter is the location of the dynamic distribution group in Active
         Directory. This location is specified by using the
OrganizationalUnit parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SendModerationNotifications <Never | Internal | Always>
        The SendModerationNotifications parameter specifies whether
status notifications are sent to users when they send a message to the
moderat
        ed dynamic distribution group. You can specify one of the
following values:
        * Always
        * Internal
        * Never
        If you want notifications to be sent to all senders, set this
parameter to Always.
        If you want notifications to be sent only to the senders internal
to your organization, set this parameter to Internal.
        To disable all status notifications, set this parameter to Never.
        Senders are always notified if their message is rejected by the
moderators, regardless of the value of this parameter.
        The default value is Never.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------
     This example creates the dynamic distribution group Marketing Group
in the Users container in the contoso.com domain. The Marketing Group
dyna
     mic distribution group contains all mailbox users or mail-enabled
contacts found anywhere in the contoso.com domain who have a Department
fiel
     d that equals the strings "Marketing" or "Sales".

    New-DynamicDistributionGroup -Name "Marketing Group" -Alias
"Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -
OrganizationalU
    nit "contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -
RecipientContainer "contoso.com"




       -------------------------- EXAMPLE 2 --------------------------




    This example uses the RecipientFilter parameter to create the dynamic
distribution group Pacific Northwest in the Users container in the conto
    so.com domain. The Pacific Northwest dynamic distribution group
contains all mailbox users found anywhere in the contoso.com domain who
have a
     State/Province field that equals "Washington" or "Oregon".

    New-DynamicDistributionGroup -Name "Pacific Northwest" -Alias
"Pacific_Northwest" -OrganizationalUnit "contoso.com/Users" -
RecipientFilter {((
    RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq
'Washington' -or StateOrProvince -eq 'Oregon')))} -RecipientContainer
"contoso.com
    "




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/e9920bd1-
06c1-4f75-992f-dd7fc98a5c2b(EXCHG.141).aspx

NAME
       New-HotmailSubscription

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the New-HotmailSubscription cmdlet to add a Hotmail account
subscription to a user's mailbox.

SYNTAX
    New-HotmailSubscription -Name <String> -EmailAddress <SmtpAddress> -
Password <SecureString> [-Confirm [<SwitchParameter>]] [-DisplayName
<Stri
    ng>] [-DomainController <Fqdn>] [-Mailbox <MailboxIdParameter>] [-
WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The New-HotmailSubscription cmdlet creates a connection between a
user's mailbox in the cloud-based service and a remote Hotmail mailbox.
The
    cloud-based mailbox periodically polls the Hotmail mailbox for new
messages.


PARAMETERS
    -EmailAddress <SmtpAddress>
        The EmailAddress parameter specifies the e-mail address of the
Hotmail mailbox.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Name <String>
        The Name parameter specifies the name of the Hotmail
subscription. The name of the subscription doesn't have to be globally
unique. The na
        me must be unique compared to other subscriptions that exist in
the same mailbox.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Password <SecureString>
        The Password parameter specifies the password used to sign in to
the Hotmail mailbox. You must specify the value for this parameter in a s
        ecure format, for example, (ConvertTo-SecureString -String
'<password>' -AsPlainText -Force).

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DisplayName <String>
        The DisplayName parameter specifies the friendly name of the
Hotmail subscription. If you don't specify a value for the DisplayName
parame
        ter, the value of the EmailAddress parameter is used.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the cloud-based mailbox that will
contain the Hotmail subscription. You can use any value that uniquely id
        entifies the mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        True
        Accept wildcard characters?   false
     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE --------------------------




    This example creates a Hotmail subscription named "Ayla's Hotmail" in
the mailbox of a user named "Ayla Kol". The Hotmail account has the foll
    owing details:

    E-mail address: ayla@fabrikam.com
    Password: Pa$$word1

    New-HotmailSubscription -Name "Ayla's Hotmail" -Mailbox "Ayla Kol" -
EmailAddress ayla@fabrikam.com -Password (ConvertTo-SecureString -String
'
    Pa$$word1' -AsPlainText -Force)




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/04990a05-
da71-43e7-9ba8-859a088891d4(EXCHG.141).aspx

NAME
       New-ImapSubscription

SYNOPSIS
    This cmdlet is available only in the cloud-based service.
    Use the New-ImapSubscription cmdlet to add an IMAP subscription to a
user's cloud-based mailbox.

SYNTAX
     New-ImapSubscription -Name <String> -EmailAddress <SmtpAddress> -
IncomingPassword <SecureString> -IncomingServer <Fqdn> -IncomingUserName
<Str
     ing> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-
DomainController <Fqdn>] [-Force <SwitchParameter>] [-IncomingAuth <Basic
| Ntlm
     >] [-IncomingPort <Int32>] [-IncomingSecurity <None | Ssl | Tls>] [-
Mailbox <MailboxIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParame
     ters>]


DESCRIPTION
    The New-ImapSubscription cmdlet creates a connection between a user's
cloud-based mailbox and a remote IMAP mailbox. The cloud-based mailbox p
    eriodically polls the IMAP mailbox for new messages.


PARAMETERS
    -EmailAddress <SmtpAddress>
        The EmailAddress parameter specifies the e-mail address of the
IMAP mailbox.

          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -IncomingPassword <SecureString>
        The IncomingPassword parameter specifies the password used to
sign in to the IMAP mailbox. You must specify the value for this
parameter i
        n a secure format, for example, (ConvertTo-SecureString -String
'<password>' -AsPlainText -Force).

          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false
    -IncomingServer <Fqdn>
        The IncomingServer parameter specifies the FQDN of the IMAP
server, for example, incoming.contoso.com.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IncomingUserName <String>
        The IncomingUserName parameter specifies the user name used to
sign in to the IMAP mailbox.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Name <String>
        The Name parameter specifies the name of the IMAP subscription.
The name of the subscription doesn't have to be globally unique. The name
        must be unique compared to other subscriptions that exist in the
same mailbox.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DisplayName <String>
        The DisplayName parameter specifies the friendly name of the IMAP
subscription. If you don't specify a value for the DisplayName parameter
        , the value of the EmailAddress parameter is used.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -DomainController <Fqdn>
        This parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Force <SwitchParameter>
        The Force parameter instructs the command to create the
subscription even if those settings can't be verified by the remote IMAP
server.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IncomingAuth <Basic | Ntlm>
        The IncomingAuth parameter sets the authentication method used by
IMAP clients to access the IMAP server. Valid values are Basic or Ntlm.
        If you don't specify a value for the IncomingAuth parameter, the
value Basic is used.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IncomingPort <Int32>
         The IncomingPort parameter specifies the TCP port number used by
IMAP clients to connect to the IMAP server. Typical values are 143 for un
         encrypted connections and 993 for encrypted connections. By
default, the value of the IncomingPort parameter is set to 143 if you
don't se
         t the IncomingSecurity parameter to Ssl or Tls. If you set the
IncomingSecurity parameter to Ssl or Tls, the value of the IncomingPort
par
         ameter is set to 993. You can override the default values by
specifying an integer for the IncomingPort parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -IncomingSecurity <None | Ssl | Tls>
        The IncomingSecurity parameter specifies the encryption method
used by IMAP clients to connect to the IMAP server. Valid values are
None,
        Ssl, or Tls. If you don't specify a value for the
IncomingSecurity parameter, the value None is used.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the cloud-based mailbox that will
contain the IMAP subscription. You can use any value that uniquely ident
        ifies the mailbox.
        For example:
        * Alias
        * Distinguished name (DN)
        * GUID
        * Name
        * Display name
        * LegacyExchangeDN
        * E-mail address

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        True
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS
NON-TERMINATING ERRORS
    (Category: )


       Type:
       Target Object Type:
       Suggested Action:

       -------------------------- EXAMPLE --------------------------




    This example creates an IMAP subscription named "Contoso IMAP" in the
mailbox of a user named "Kim Akers". The remote IMAP mailbox has the fol
    lowing details:

       E-mail address: kakers@contoso.com
       User name: kakers
       Password: Pa$$word1
       IMAP server: imap.contoso.com
       Authentication method: SSL
       TCP port: 993

    New-ImapSubscription -Name "Contoso IMAP" -Mailbox "Kim Akers" -
EmailAddress kakers@contoso.com -IncomingUserName kakers -
IncomingPassword (Co
    nvertTo-SecureString -String 'Pa$$word1' -AsPlainText -Force) -
IncomingServer imap.contoso.com -IncomingSecurity Ssl -IncomingPort 993




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/cb002b53-
c307-40a6-aca2-a7f29dc740d8(EXCHG.141).aspx

NAME
       New-InboxRule

SYNOPSIS
    Use the New-InboxRule cmdlet to create an Inbox rule for a mailbox.
Inbox rules are used to process messages in the Inbox based on conditions
    specified and take actions such as moving a message to a specified
folder or deleting a message.
    You must have adequate permissions on the mailbox to create an Inbox
rule.

SYNTAX
    New-InboxRule -Name <String> [-AlwaysDeleteOutlookRulesBlob
<SwitchParameter>] [-ApplyCategory <MultiValuedProperty>] [-
BodyContainsWords <Mul
    tiValuedProperty>] [-Confirm [<SwitchParameter>]] [-CopyToFolder
<MailboxFolderIdParameter>] [-DeleteMessage <$true | $false>] [-
DomainControl
    ler <Fqdn>] [-ExceptIfBodyContainsWords <MultiValuedProperty>] [-
ExceptIfFlaggedForAction <Any | Call | DoNotForward | FollowUp |
ForYourInfor
    mation | Forward | NoResponseNecessary | Read | Reply | ReplyToAll |
Review>] [-ExceptIfFrom <RecipientIdParameter[]>] [-ExceptIfFromAddressCo
    ntainsWords <MultiValuedProperty>] [-ExceptIfFromSubscription
<AggregationSubscriptionIdentity[]>] [-ExceptIfHasAttachment <$true |
$false>] [
    -ExceptIfHasClassification <MessageClassificationIdParameter[]>] [-
ExceptIfHeaderContainsWords <MultiValuedProperty>] [-
ExceptIfMessageTypeMat
    ches <AutomaticReply | AutomaticForward | Encrypted | Calendaring |
CalendaringResponse | PermissionControlled | Voicemail | Signed |
Approval
    Request | ReadReceipt | NonDeliveryReport>] [-ExceptIfMyNameInCcBox
<$true | $false>] [-ExceptIfMyNameInToBox <$true | $false>] [-
ExceptIfMyNa
    meInToOrCcBox <$true | $false>] [-ExceptIfMyNameNotInToBox <$true |
$false>] [-ExceptIfReceivedAfterDate <ExDateTime>] [-
ExceptIfReceivedBefor
    eDate <ExDateTime>] [-ExceptIfRecipientAddressContainsWords
<MultiValuedProperty>] [-ExceptIfSentOnlyToMe <$true | $false>] [-
ExceptIfSentTo <
    RecipientIdParameter[]>] [-ExceptIfSubjectContainsWords
<MultiValuedProperty>] [-ExceptIfSubjectOrBodyContainsWords
<MultiValuedProperty>] [-E
    xceptIfWithImportance <Low | Normal | High>] [-
ExceptIfWithinSizeRangeMaximum <ByteQuantifiedSize>] [-
ExceptIfWithinSizeRangeMinimum <ByteQuan
    tifiedSize>] [-ExceptIfWithSensitivity <Normal | Personal | Private |
CompanyConfidential>] [-FlaggedForAction <Any | Call | DoNotForward | Fo
    llowUp | ForYourInformation | Forward | NoResponseNecessary | Read |
Reply | ReplyToAll | Review>] [-Force <SwitchParameter>] [-ForwardAsAttac
    hmentTo <RecipientIdParameter[]>] [-ForwardTo
<RecipientIdParameter[]>] [-From <RecipientIdParameter[]>] [-
FromAddressContainsWords <MultiValu
    edProperty>] [-FromSubscription <AggregationSubscriptionIdentity[]>]
[-HasAttachment <$true | $false>] [-HasClassification <MessageClassificat
    ionIdParameter[]>] [-HeaderContainsWords <MultiValuedProperty>] [-
Mailbox <MailboxIdParameter>] [-MarkAsRead <$true | $false>] [-
MarkImportanc
    e <Low | Normal | High>] [-MessageTypeMatches <AutomaticReply |
AutomaticForward | Encrypted | Calendaring | CalendaringResponse |
PermissionC
    ontrolled | Voicemail | Signed | ApprovalRequest | ReadReceipt |
NonDeliveryReport>] [-MoveToFolder <MailboxFolderIdParameter>] [-
MyNameInCcBo
    x <$true | $false>] [-MyNameInToBox <$true | $false>] [-
MyNameInToOrCcBox <$true | $false>] [-MyNameNotInToBox <$true | $false>]
[-Organizatio
    n <OrganizationIdParameter>] [-Priority <Int32>] [-ReceivedAfterDate
<ExDateTime>] [-ReceivedBeforeDate <ExDateTime>] [-RecipientAddressContai
    nsWords <MultiValuedProperty>] [-RedirectTo <RecipientIdParameter[]>]
[-SendTextMessageNotificationTo <MultiValuedProperty>] [-SentOnlyToMe <$
    true | $false>] [-SentTo <RecipientIdParameter[]>] [-
StopProcessingRules <$true | $false>] [-SubjectContainsWords
<MultiValuedProperty>] [-Sub
    jectOrBodyContainsWords <MultiValuedProperty>] [-WhatIf
[<SwitchParameter>]] [-WithImportance <Low | Normal | High>] [-
WithinSizeRangeMaximum
    <ByteQuantifiedSize>] [-WithinSizeRangeMinimum <ByteQuantifiedSize>]
[-WithSensitivity <Normal | Personal | Private | CompanyConfidential>] [<
    CommonParameters>]

     New-InboxRule -FromMessageId <MailboxStoreObjectIdParameter> -
ValidateOnly <SwitchParameter> [-AlwaysDeleteOutlookRulesBlob
<SwitchParameter>]
      [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-
ExceptIfFromSubscription <AggregationSubscriptionIdentity[]>] [-Force
<SwitchPara
     meter>] [-FromSubscription <AggregationSubscriptionIdentity[]>] [-
Mailbox <MailboxIdParameter>] [-Organization <OrganizationIdParameter>]
[-Wh
     atIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
     The New-InboxRule cmdlet exposes rule predicates and actions, in
addition to the parameters such as a rule name and the mailbox identity,
requ
     ired to create an Inbox rule.
     When you create, modify, remove, enable, or disable an Inbox rule on
Microsoft Exchange Server 2010, any client-side rules created by Microsof
     t Outlook are removed.
     Predicate parameters used for conditions, such as
SubjectOrBodyContainsWords, also have an exception parameter. When
conditions specified in a
     n exception are matched, the rule isn't applied to the message.
Exception parameters begin with ExceptIf. For example, the exception
parameter
      for SubjectOrBodyContainsWords is
ExceptIfSubjectOrBodyContainsWords.
     You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
     not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Inbo
     x rules" entry in the Mailbox Permissions topic.


PARAMETERS
    -FromMessageId <MailboxStoreObjectIdParameter>
        The FromMessageId parameter specifies a message ID to create an
Inbox rule based on the properties of that message. You must specify the
B
        ase64-encoded StoreObjectId of the message. Valid values include
one of the following:
        * MailboxId\StoreObjectId
        * StoreObjectId
        When you create an Inbox rule by specifying the FromMessageId
parameter, the following properties of that message are used to create
the r
        ule:
        * Subject   The message subject is added to the
SubjectContainsWords property of the rule.
        * From   The message sender is added to the From property of the
rule.
        * To and Cc recipients   Recipients in the To and Cc fields of
the message are added to the SentTo property of the rule.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Name <String>
         The Name parameter specifies a name for the Inbox rule being
created.

        Required?                     true
        Position?                     1
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ValidateOnly <SwitchParameter>
        The ValidateOnly switch tells the cmdlet to evaluate the
conditions and requirements necessary to perform the operation and then
reports w
        hether the operation will succeed or fail. No changes are made
when the ValidateOnly switch is used.

        Required?                     true
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ApplyCategory <MultiValuedProperty>
        The ApplyCategory parameter specifies one or more categories to
apply to a message.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -BodyContainsWords <MultiValuedProperty>
        The BodyContainsWords parameter specifies one or more words or
phrases to check in the message body.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch can be used to suppress the confirmation
prompt that appears by default when this cmdlet is run. To suppress the
confir
        mation prompt, use the syntax -Confirm:$False. You must include a
colon ( : ) in the syntax.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -CopyToFolder <MailboxFolderIdParameter>
        The CopyToFolder parameter specifies the name of an existing
mailbox folder to copy the message to.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DeleteMessage <$true | $false>
        The DeleteMessage parameter specifies that the message be sent to
the Deleted Items folder.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfBodyContainsWords <MultiValuedProperty>
        The ExceptIfBodyContainsWords parameter specifies one or more
words or phrases to check in the message body.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfFlaggedForAction <Any | Call | DoNotForward | FollowUp |
ForYourInformation | Forward | NoResponseNecessary | Read | Reply |
ReplyToA
    ll | Review>
         The ExceptIfFlaggedForAction parameter specifies one or more
message flags to check the message for. You can use the following values:
         * Any
         * Call
         * DoNotForward
         * FollowUp
         * ForYourInfo
         * Forward
         * NoResponseNecessary
         * Read
         * Reply
         * ReplyToAll
         * Review

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfFrom <RecipientIdParameter[]>
        The ExceptFrom parameter specifies a recipient to check in the
From field of the message.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfFromAddressContainsWords <MultiValuedProperty>
        The ExceptIfFromAddressContainsWords parameter specifies one or
more words to check in the sender's address.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfFromSubscription <AggregationSubscriptionIdentity[]>
         This parameter applies only to objects in the cloud-based
service.
         The ExceptIfFromSubscription parameter specifies an exception
when a message is received from a POP, IMAP, or Hotmail subscription.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfHasAttachment <$true | $false>
        The ExceptIfHasAttachment parameter specifies whether the rule
should apply to messages with attachments. We recommend that you set the
va
        lue to $true.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfHasClassification <MessageClassificationIdParameter[]>
        The ExceptIfHasClassification parameter checks messages for the
specified message classification.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfHeaderContainsWords <MultiValuedProperty>
        The ExceptIfHeaderContainsWords parameter specifies one or more
words to check for in the specified message header.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfMessageTypeMatches <AutomaticReply | AutomaticForward |
Encrypted | Calendaring | CalendaringResponse | PermissionControlled |
Voicem
    ail | Signed | ApprovalRequest | ReadReceipt | NonDeliveryReport>
        The ExceptIfMessageTypeMatches parameter specifies a message
type. You can use the following values:
        *   AutomaticReply
        *   AutomaticForward
        *   Encrypted
        *   Calendaring
        *   CalendaringResponse
        *   PermissionControlled
        *   Voicemail
        *   Signed
        *   ApprovalRequest
        *   ReadReceipt
        *   NonDeliveryReport

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfMyNameInCcBox <$true | $false>
        The ExceptIfMyNameInCcBox parameter specifies that the Cc field
of messages be checked for the mailbox owner's address.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfMyNameInToBox <$true | $false>
        The ExceptIfMyNameInToBox parameter specifies that the To field
of messages be checked for the mailbox owner's address.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfMyNameInToOrCcBox <$true | $false>
        The ExceptIfMyNameInToOrCcBox parameter specifies that the To or
Cc fields of messages be checked for the mailbox owner's address.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfMyNameNotInToBox <$true | $false>
        The ExceptIfMyNameNotInToBox parameter matches messages where the
mailbox owner isn't addressed in the To field of the message.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfReceivedAfterDate <ExDateTime>
        The ExceptIfReceivedAfterDate specifies a date.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfReceivedBeforeDate <ExDateTime>
        The ExceptIfReceivedBeforeData parameter specifies a date.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfRecipientAddressContainsWords <MultiValuedProperty>
        The ExceptIfRecipientAddressContainsWords parameter specifies one
or more words to check in a recipient address.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfSentOnlyToMe <$true | $false>
        The ExceptIfSentOnlyToMe parameter checks for messages where the
mailbox owner is the only recipient.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfSentTo <RecipientIdParameter[]>
        The ExceptIfSentTo parameter checks message recipients for the
recipient specified.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfSubjectContainsWords <MultiValuedProperty>
        The ExceptIfSubjectContainsWords parameter specifies one or more
words or phrases to check in the message subject.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfSubjectOrBodyContainsWords <MultiValuedProperty>
        The ExceptIfSubjectOrBodyContainsWords parameter specifies one or
more words or phrases to check in the message subject or body.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfWithImportance <Low | Normal | High>
        The ExceptIfWithImportance parameter specifies a message
importance level. Valid values include one of the following:
        * Low
        * Normal
        * High

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfWithinSizeRangeMaximum <ByteQuantifiedSize>
        The ExceptIfWithinSizeRangeMaximum parameter specifies the
maximum message size. When using this parameter, you must also specify a
minimu
        m message size value using the ExceptIfWithinSizeRangeMinimum
parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfWithinSizeRangeMinimum <ByteQuantifiedSize>
        The ExceptIfWithinSizeRangeMinimum parameter specifies the
minimum message size. When using this parameter, you must also specify a
maximu
        m message size value using the ExceptIfWithinSizeRangeMaximum
parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ExceptIfWithSensitivity <Normal | Personal | Private |
CompanyConfidential>
        The ExceptIfWithSensitivity parameter specifies a message
sensitivity level. You can use the following values:
        * Normal
        * Personal
        * Private
        * CompanyConfidential

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -FlaggedForAction <Any | Call | DoNotForward | FollowUp |
ForYourInformation | Forward | NoResponseNecessary | Read | Reply |
ReplyToAll | Rev
    iew>
         The FlaggedForAction parameter specifies one or more message
flags to check the message for. You can use the following values:
         * Any
         * Call
         * DoNotForward
         * FollowUp
         * ForYourInfo
         * Forward
         * NoResponseNecessary
         * Read
         * Reply
         * ReplyToAll
         * Review

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Force <SwitchParameter>
        The Force switch specifies whether the command suppresses the
confirmation prompt produced if rules created by Microsoft Outlook exist
on
        the mailbox. When taking an action using Inbox rules on Exchange
2010, any client-side rules are removed.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ForwardAsAttachmentTo <RecipientIdParameter[]>
        The ForwardAsAttachmentTo parameter specifies a recipient to
forward the message to as an attachment.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ForwardTo <RecipientIdParameter[]>
        The ForwardTo action specifies the identity of a recipient to
forward the message to.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -From <RecipientIdParameter[]>
        The From parameter specifies the identity of the sender as a rule
condition.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -FromAddressContainsWords <MultiValuedProperty>
        The FromAddressContainsWords parameter specifies one or more
words to check in the From field of the message.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -FromSubscription <AggregationSubscriptionIdentity[]>
         This parameter applies only to objects in the cloud-based
service.
         The FromSubscription parameter specifies the condition when a
message is received from a POP, IMAP, or Hotmail subscription.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
    -HasAttachment <$true | $false>
        The HasAttachment parameter checks for messages with an
attachment.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -HasClassification <MessageClassificationIdParameter[]>
        The HasClassification parameter checks messages for the specified
message classification.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -HeaderContainsWords <MultiValuedProperty>
        The HeaderContainsWords parameter specifies one or more words to
match in the specified message header.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Mailbox <MailboxIdParameter>
        The Mailbox parameter specifies the identity of the mailbox for
which the rule is being created. The following values can be used:
        * GUID
        * Distinguished name (DN)
        * Domain\Account
        * User principal name (UPN)
        * LegacyExchangeDN
        * SmtpAddress
        * Alias

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MarkAsRead <$true | $false>
        The MarkAsRead parameter specifies whether to mark the message as
read. When set to $true, the MarkAsRead parameter marks the message as r
        ead.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MarkImportance <Low | Normal | High>
        The MarkImportance parameter specifies that the message
importance be marked with one of the following values:
        * Low
        * Normal
        * High

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MessageTypeMatches <AutomaticReply | AutomaticForward | Encrypted |
Calendaring | CalendaringResponse | PermissionControlled | Voicemail | Si
    gned | ApprovalRequest | ReadReceipt | NonDeliveryReport>
        The MessageTypeMatches parameter specifies a message type. You
can use the following values:
        * AutomaticReply
        * AutomaticForward
        * Encrypted
        * Calendaring
        * CalendaringResponse
        * PermissionControlled
        * Voicemail
        * Signed
        * ApprovalRequest
        * ReadReceipt
        * NonDeliveryReport

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MoveToFolder <MailboxFolderIdParameter>
        The MoveToFolder parameter specifies an existing mailbox folder
to which the message is copied.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -MyNameInCcBox <$true | $false>
        The MyNameInCcBox parameter checks for the mailbox owner's name
in the Cc field. We recommend that you set the value to $true to use this
        predicate.
          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -MyNameInToBox <$true | $false>
        The MyNameInToBox parameter checks for the mailbox owner's name
in the To field. We recommend that you set the value to $true to use this
        predicate.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -MyNameInToOrCcBox <$true | $false>
         The MyNameInToOrCcBox specifies that the mailbox for which the
rule is being created should appear in the To or Cc fields of the
message.
         We recommend that you set the value to $true to add this
condition.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -MyNameNotInToBox <$true | $false>
        The MyNameNotInToBox parameter checks the mailbox owner's name in
the To box. We recommend that you set the value to $true to use this pre
        dicate.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Priority <Int32>
           The Priority parameter sets a priority for the Inbox rule.
        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReceivedAfterDate <ExDateTime>
        The ReceivedAfterDate parameter specifies a date. The rule is
applied to messages received after the specified date.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -ReceivedBeforeDate <ExDateTime>
        The ReceivedBeforeDate parameter specifies a date. The rule is
applied only to messages received before the specified date.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RecipientAddressContainsWords <MultiValuedProperty>
        The RecipientAddressContainsWords parameter specifies one or more
words to check for in a recipient address.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -RedirectTo <RecipientIdParameter[]>
        The RedirectTo parameter specifies a recipient to redirect the
message to.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SendTextMessageNotificationTo <MultiValuedProperty>
        The SendTextMessageNotificationTo parameter specifies one or more
text message recipients to send a notification to.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SentOnlyToMe <$true | $false>
        The SentOnlyToMe parameter specifies whether the mailbox owner is
specified as the only recipient. You can use the following values:
        * $true
        * $false

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SentTo <RecipientIdParameter[]>
        The SentTo parameter specifies the identity of a recipient as a
condition.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -StopProcessingRules <$true | $false>
        The StopProcessingRules parameter specifies that Exchange stop
processing additional rules if the conditions of this Inbox rule are met.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SubjectContainsWords <MultiValuedProperty>
        The SubjectContainsWords parameter specifies one or more keywords
to be matched in the subject field of a message.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -SubjectOrBodyContainsWords <MultiValuedProperty>
        The SubjectOrBodyContainsWords parameter specifies one or more
keywords to be matched in the message subject or body.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false
     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -WithImportance <Low | Normal | High>
        The WithImportance parameter checks messages with the specified
importance level. You can use the following values:
        * High
        * Normal
        * Low

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -WithinSizeRangeMaximum <ByteQuantifiedSize>
        The WithinSizeRangeMaximum parameter specifies the maximum
message size. When using this parameter, you must also specify a minimum
messag
        e size value using the WithinSizeRangeMinimum parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -WithinSizeRangeMinimum <ByteQuantifiedSize>
        The WithinSizeRangeMinimum parameter specifies the minimum
message size. When using this parameter, you must also specify a maximum
messag
        e size value using the WithinSizeRangeMaximum parameter.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -WithSensitivity <Normal | Personal | Private | CompanyConfidential>
        The WithSensitivity parameter specifies a message sensitivity
level. Valid values include one of the following:
          *   Normal
          *   Personal
          *   Private
          *   CompanyConfidential

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -AlwaysDeleteOutlookRulesBlob <SwitchParameter>

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example raises the message importance to High if the mailbox
owner is in the To field. In addition, the message is flagged for action.

    New-InboxRule "CheckActionRequired" -MyNameInToBox $true -
FlaggedForAction Any -MarkImportanceHigh




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/2c6b8ee8-
1ff0-4353-845c-f3ea9778abc3(EXCHG.141).aspx

NAME
       New-JournalRule

SYNOPSIS
    Use the NewJournalRule cmdlet to create a journal rule on a Hub
Transport server.

SYNTAX
    new-journalrule -Name <String> -JournalEmailAddress
<RecipientIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController
<Fqdn>] [-Enabled
     <$true | $false>] [-ExpiryDate <DateTime>] [-FullReport <$true |
$false>] [-LawfulInterception <SwitchParameter>] [-Organization
<Organizatio
    nIdParameter>] [-Recipient <SmtpAddress>] [-Scope <Internal |
External | Global>] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]


DESCRIPTION
    The New-JournalRule cmdlet creates a journal rule for use with the
Journaling agent.
    By default, new journal rules are disabled unless the Enabled
parameter is set to $true. For more information about how to enable a new
journa
    l rule that was created in a disabled state, see Enable-JournalRule.
    You need to be assigned permissions before you can run this cmdlet.
Although all parameters for this cmdlet are listed in this topic, you may
    not have access to some parameters if they're not included in the
permissions assigned to you. To see what permissions you need, see the
"Jour
    naling" entry in the Messaging Policy and Compliance Permissions
topic.


PARAMETERS
    -JournalEmailAddress <RecipientIdParameter>
        The JournalEmailAddress parameter specifies a recipient object to
which journal reports are sent.

          Required?                     true
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Name <String>
        The Name parameter specifies the name of the journal rule. The
name of the rule can be up to 64 characters long.

          Required?                     true
          Position?                     1
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Confirm [<SwitchParameter>]
        The Confirm switch causes the command to pause processing and
requires you to acknowledge what the command will do before processing
conti
        nues. You don't have to specify a value with the Confirm switch.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -DomainController <Fqdn>
        The DomainController parameter specifies the fully qualified
domain name (FQDN) of the domain controller that writes this
configuration ch
        ange to Active Directory.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Enabled <$true | $false>
        The Enabled parameter specifies whether the journal rule is
enabled or disabled. If the rule is disabled, it isn't applied to any e-
mail m
        essages. The default value is $false.

        Required?                     false
        Position?                     Named
        Default value
        Accept pipeline input?        False
        Accept wildcard characters?   false

    -Expiry <>
        The ExpiryDate parameter is reserved for internal Microsoft use.

        Required?
        Position?                     named
        Default value
        Accept pipeline input?
        Accept wildcard characters?   false

    -FullReport <$true | $false>
        The FullReport parameter is reserved for internal Microsoft use.

        Required?                     false
        Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -LawfulInterception <SwitchParameter>
        The LawfulInterception parameter is reserved for internal
Microsoft use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

       -Organization <OrganizationIdParameter>
           The Organization parameter is reserved for internal Microsoft
use.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    -Recipient <SmtpAddress>
        The Recipient parameter specifies the SMTP address of a mailbox,
contact, or distribution group to journal. If you specify a distribution
        group, all recipients in that distribution group are journaled.
All messages sent to or from a recipient are journaled.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -Scope <Internal | External | Global>
         The Scope parameter specifies the scope of e-mail messages to
which the journal rule is applied. Valid values for this parameter are as
fo
         llows:
         * Global   Global rules process all e-mail messages that pass
through a Hub Transport server. This includes e-mail messages that were
alre
           ady processed by the external and internal rules. The default
value is Global.
         * Internal   Internal rules process e-mail messages sent and
received by recipients in the Microsoft Exchange Server 2010
organization.
         * External   External rules process e-mail messages sent to
recipients or from senders outside the Exchange 2010 organization.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

     -WhatIf [<SwitchParameter>]
         The WhatIf switch instructs the command to simulate the actions
that it would take on the object. By using the WhatIf switch, you can
view
          what changes would occur without having to apply any of those
changes. You don't have to specify a value with the WhatIf switch.

          Required?                     false
          Position?                     Named
          Default value
          Accept pipeline input?        False
          Accept wildcard characters?   false

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

INPUTS

OUTPUTS

TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

NON-TERMINATING ERRORS
    (Category: )


    Type:
    Target Object Type:
    Suggested Action:

    -------------------------- EXAMPLE 1 --------------------------




    This example shows how to create a new enabled journal rule. The rule
applies to all e-mail messages that pass through the Hub Transport serve
    r and contain at least one recipient or sender who is a member of the
brokers@contoso.com distribution list.
    New-JournalRule -Name "Brokerage Communications" -JournalEmailAddress
"Brokers Journal Mailbox" -Scope Global -Recipient brokers@contoso.com -
    Enabled $true




RELATED LINKS
    Online Version http://technet.microsoft.com/EN-US/library/fcad9ef1-
b3f2-442d-a1a7-cd1bbe442054(EXCHG.141).aspx

NAME
       New-Mailbox

SYNOPSIS
    Use the New-Mailbox cmdlet to create a user in Active Directory and
mailbox-enable this new user.

SYNTAX
    New-Mailbox -Name <String> -Password <SecureString> -
UserPrincipalName <String> [-ActiveSyncMailboxPolicy
<MailboxPolicyIdParameter>] [-Alias
    <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-Archive
<SwitchParameter>] [-ArchiveDatabase <DatabaseIdParameter>] [-Confirm
[<SwitchP
    arameter>]] [-Database <DatabaseIdParameter>] [-DisplayName <String>]
[-DomainController <Fqdn>] [-ExternalDirectoryObjectId <String>] [-First
    Name <String>] [-Force <SwitchParameter>] [-ImmutableId <String>] [-
Initials <String>] [-LastName <String>] [-MailboxPlan
<MailboxPlanIdParame
    ter>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-
ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-ModeratedBy
<MultiValu
    edProperty>] [-ModerationEnabled <$true | $false>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParamet
    er>] [-OverrideRecipientQuotas <SwitchParameter>] [-PartnerObjectId
<Guid>] [-PrimarySmtpAddress <SmtpAddress>] [-
QueryBaseDNRestrictionEnable
    d <$true | $false>] [-RemoteAccountPolicy
<RemoteAccountPolicyIdParameter>] [-RemotePowerShellEnabled <$true |
$false>] [-ResetPasswordOnNextL
    ogon <$true | $false>] [-RetentionPolicy <MailboxPolicyIdParameter>]
[-RoleAssignmentPolicy <MailboxPolicyIdParameter>] [-SamAccountName <Stri
    ng>] [-SendModerationNotifications <Never | Internal | Always>] [-
SharingPolicy <SharingPolicyIdParameter>] [-SKUAssigned <$true | $false>]
[-
    SKUCapability <None | BPOS_S_Deskless | BPOS_S_Standard |
BPOS_S_Archive | BPOS_L_Standard | BPOS_B_Standard | TOU_Signed |
FederatedUser | Pa
    rtner_Managed | MasteredOnPremise | ResourceMailbox |
ExcludedFromBackSync | UMFeatureRestricted>] [-ThrottlingPolicy
<ThrottlingPolicyIdParam
    eter>] [-UsageLocation <CountryInfo>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

    New-Mailbox -Name <String> -Room <SwitchParameter> [-
ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-
ArbitrationMailbo
    x <MailboxIdParameter>] [-Archive <SwitchParameter>] [-
ArchiveDatabase <DatabaseIdParameter>] [-Confirm [<SwitchParameter>]] [-
Database <Datab
    aseIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>]
[-ExternalDirectoryObjectId <String>] [-FirstName <String>] [-Force
<Switc
    hParameter>] [-ImmutableId <String>] [-Initials <String>] [-LastName
<String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-Mana
    gedFolderMailboxPolicyAllowed <SwitchParameter>] [-ModeratedBy
<MultiValuedProperty>] [-ModerationEnabled <$true | $false>] [-Office
<String>]
     [-Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-OverrideRecipientQuotas
<SwitchParameter>]
    [-PartnerObjectId <Guid>] [-Password <SecureString>] [-Phone
<String>] [-PrimarySmtpAddress <SmtpAddress>] [-
QueryBaseDNRestrictionEnabled <$t
    rue | $false>] [-RemoteAccountPolicy
<RemoteAccountPolicyIdParameter>] [-RemotePowerShellEnabled <$true |
$false>] [-ResetPasswordOnNextLogon
    <$true | $false>] [-ResourceCapacity <Int32>] [-RetentionPolicy
<MailboxPolicyIdParameter>] [-RoleAssignmentPolicy
<MailboxPolicyIdParameter>]
     [-SamAccountName <String>] [-SendModerationNotifications <Never |
Internal | Always>] [-SharingPolicy <SharingPolicyIdParameter>] [-
Throttlin
    gPolicy <ThrottlingPolicyIdParameter>] [-UserPrincipalName <String>]
[-WhatIf [<SwitchParameter>]] [<CommonParameters>]

    New-Mailbox -Name <String> -ImportLiveId <SwitchParameter> -
WindowsLiveID <WindowsLiveId> [-ActiveSyncMailboxPolicy
<MailboxPolicyIdParameter>
    ] [-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>] [-
Archive <SwitchParameter>] [-ArchiveDatabase <DatabaseIdParameter>] [-
Confirm
     [<SwitchParameter>]] [-Database <DatabaseIdParameter>] [-DisplayName
<String>] [-DomainController <Fqdn>] [-ExternalDirectoryObjectId <String
    >] [-FirstName <String>] [-Force <SwitchParameter>] [-ImmutableId
<String>] [-Initials <String>] [-LastName <String>] [-MailboxPlan
<MailboxPl
    anIdParameter>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed
<SwitchParameter>] [-ModeratedBy
    <MultiValuedProperty>] [-ModerationEnabled <$true | $false>] [-
Organization <OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUni
    tIdParameter>] [-OverrideRecipientQuotas <SwitchParameter>] [-
PartnerObjectId <Guid>] [-PrimarySmtpAddress <SmtpAddress>] [-
QueryBaseDNRestric
    tionEnabled <$true | $false>] [-RemoteAccountPolicy
<RemoteAccountPolicyIdParameter>] [-RemotePowerShellEnabled <$true |
$false>] [-RemovedMai
    lbox <RemovedMailboxIdParameter>] [-ResetPasswordOnNextLogon <$true |
$false>] [-RetentionPolicy <MailboxPolicyIdParameter>] [-RoleAssignmentP
    olicy <MailboxPolicyIdParameter>] [-SamAccountName <String>] [-
SendModerationNotifications <Never | Internal | Always>] [-SharingPolicy
<Shari
    ngPolicyIdParameter>] [-SKUAssigned <$true | $false>] [-SKUCapability
<None | BPOS_S_Deskless | BPOS_S_Standard | BPOS_S_Archive | BPOS_L_Stan
    dard | BPOS_B_Standard | TOU_Signed | FederatedUser | Partner_Managed
| MasteredOnPremise | ResourceMailbox | ExcludedFromBackSync | UMFeature
    Restricted>] [-ThrottlingPolicy <ThrottlingPolicyIdParameter>] [-
UsageLocation <CountryInfo>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters
    >]

    New-Mailbox -Name <String> -RemovedMailbox
<RemovedMailboxIdParameter> [-ActiveSyncMailboxPolicy
<MailboxPolicyIdParameter>] [-Alias <String>]
     [-ArbitrationMailbox <MailboxIdParameter>] [-Archive
<SwitchParameter>] [-ArchiveDatabase <DatabaseIdParameter>] [-Confirm
[<SwitchParameter>
    ]] [-Database <DatabaseIdParameter>] [-DisplayName <String>] [-
DomainController <Fqdn>] [-ExternalDirectoryObjectId <String>] [-
FirstName <Str
    ing>] [-Force <SwitchParameter>] [-ImmutableId <String>] [-Initials
<String>] [-LastName <String>] [-MailboxPlan <MailboxPlanIdParameter>] [-
M
    anagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-
ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-ModeratedBy
<MultiValuedPropert
    y>] [-ModerationEnabled <$true | $false>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-Ov
    errideRecipientQuotas <SwitchParameter>] [-PartnerObjectId <Guid>] [-
Password <SecureString>] [-PrimarySmtpAddress <SmtpAddress>] [-QueryBaseD
    NRestrictionEnabled <$true | $false>] [-RemoteAccountPolicy
<RemoteAccountPolicyIdParameter>] [-RemotePowerShellEnabled <$true |
$false>] [-Re
    setPasswordOnNextLogon <$true | $false>] [-RetentionPolicy
<MailboxPolicyIdParameter>] [-RoleAssignmentPolicy
<MailboxPolicyIdParameter>] [-Sa
    mAccountName <String>] [-SendModerationNotifications <Never |
Internal | Always>] [-SharingPolicy <SharingPolicyIdParameter>] [-
SKUAssigned <$
    true | $false>] [-SKUCapability <None | BPOS_S_Deskless |
BPOS_S_Standard | BPOS_S_Archive | BPOS_L_Standard | BPOS_B_Standard |
TOU_Signed |
    FederatedUser | Partner_Managed | MasteredOnPremise | ResourceMailbox
| ExcludedFromBackSync | UMFeatureRestricted>] [-ThrottlingPolicy <Throt
    tlingPolicyIdParameter>] [-WhatIf [<SwitchParameter>]]
[<CommonParameters>]

     New-Mailbox -Name <String> -UseExistingLiveId <SwitchParameter> -
WindowsLiveID <WindowsLiveId> [-ActiveSyncMailboxPolicy
<MailboxPolicyIdParam
     eter>] [-Alias <String>] [-ArbitrationMailbox <MailboxIdParameter>]
[-Archive <SwitchParameter>] [-ArchiveDatabase <DatabaseIdParameter>] [-
By
     passLiveId <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-
Database <DatabaseIdParameter>] [-DisplayName <String>] [-
DomainController <Fqd
     n>] [-ExternalDirectoryObjectId <String>] [-FirstName <String>] [-
Force <SwitchParameter>] [-ImmutableI