Detailed
Description

To effectively use the command, run it on a computer
that has the Client Access 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 "Availability address space settings"
entry in the Client Access
Permissions topic.

Parameters

The AccessMethod parameter, when assigned the PerUserFB
value, causes the command to access the free/busy data in the
defined per-user free/busy proxy account or group, or in the All
Exchange Servers group. The PerUserFB value requires trust between
the two forests. You must use either the UseServiceAccount
parameter or Credentials parameter.

Use the OrgWideFB value to access the free/busy data in the
per-user free/busy proxy account or group in the target forest. You
must use either the UseServiceAccount parameter or
Credentials parameter.

Use the PublicFolder value to access free/busy data on servers
running Microsoft Exchange Server 2003. The Exchange
Inter-Organization Replication tool must be running between the two
forests.

ForestName

Required

System.String

The ForestName parameter specifies the SMTP domain name
of the target forest for users whose free/busy data must be
retrieved. If your users are distributed among multiple SMTP
domains in the target forest, run the
Add-AvailabilityAddressSpace command once for each SMTP
domain.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch 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 switch.

Credentials

Optional

System.Management.Automation.PSCredential

The Credentials parameter specifies the credentials for
an account that has permission to access the Availability services
in the target forest.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully
qualified domain name (FQDN) of the domain controller that writes
this configuration change to Active Directory.

ProxyUrl

Optional

System.Uri

The ProxyUrl parameter specifies whether to direct a
Microsoft Exchange Server 2007 Client Access server to proxy its
free/busy requests through an Exchange Server 2010 Client Access
server when requesting federated free/busy data for a user in
another organization.

Before you can configure this setting, you must create the
proper trust relationships and sharing relationships. For more
information, see New-FederationTrust.

UseServiceAccount

Optional

System.Boolean

The UseServiceAccount parameter, when assigned a value of
$true, uses the local Availability service account for
authorization.

WhatIf

Optional

System.Management.Automation.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.

Input Types

To see the input types that this cmdlet accepts, see
Cmdlet Input and Output Types. If the Input
Type field for a cmdlet is blank, the cmdlet doesn’t accept input
data.

Return Types

To see the return types, which are also known as output
types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type
field is blank, the cmdlet doesn’t return data.

Examples

EXAMPLE
1

This example is useful with an untrusted cross-forest
Availability service, or if detailed cross-forest free/busy service
isn't desired. When you're prompted by the command, type a user
name and password. For an untrusted cross-forest configuration,
make sure that the user doesn't have a mailbox.

EXAMPLE
2

This example is useful with a trusted cross-forest
Availability service. The contoso.com forest trusts the current
forest, and the specified account connects to the contoso.com
forest. The specified account must be an existing account in the
contoso.com forest.

EXAMPLE
3

This example is useful with a trusted cross-forest
Availability service. The contoso.com forest trusts the current
forest and uses the service account (typically the local system
account or the computer account) to connect to the contoso.com
forest. Because the service is trusted, there is no issue with
authorization when the current forest tries to retrieve free/busy
information from contoso.com.