Update-FileDistributionService

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

Use the Update-FileDistributionService cmdlet to use the File Distribution Service to poll for offline address book (OAB) and Unified Messaging (UM) configuration and data.

Syntax

Update-FileDistributionService -Identity <ServerIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Type <String>] [-WhatIf [<SwitchParameter>]]

Detailed Description

This cmdlet will force the File Distribution Service to reload its configuration and poll for new data associated with OAB and UM configuration.

To run the Update-FileDistributionService cmdlet, the account you use must be delegated the following:

  • Exchange Server Administrator role and local Administrators group for the target server

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Use the Identity parameter to specify the GUID or Server name that represents a specific server.

You can omit the parameter label Identity so that only the server name or GUID is supplied.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm parameter.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name of the domain controller that retrieves data from Active Directory, include the DomainController parameter in the command.

Type

Optional

System.String

This parameter specifies whether to reload OAB data, UM data, or both.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, 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 parameter.

Input Types

Return Types

Errors

Error Description

Exceptions

Exceptions Description

Example

This example polls Server1 to check for updated offline address book files for OABs that are associated with Server1.

Update-FileDistributionService -Identity Server1 -Type "OAB"