Add-AvailabilityAddressSpace
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
Use the Add-AvailabilityAddressSpace cmdlet to define the access method and associated credentials that are used to exchange free/busy data across forests.
Syntax
Add-AvailabilityAddressSpace -AccessMethod <PerUserFB | OrgWideFB | PublicFolder | InternalProxy> -ForestName <String> [-Confirm [<SwitchParameter>]] [-Credentials <PSCredential>] [-DomainController <Fqdn>] [-ProxyUrl <Uri>] [-TemplateInstance <PSObject>] [-UseServiceAccount <$true | $false>] [-WhatIf [<SwitchParameter>]]
Detailed Description
The Add-AvailabilityAddressSpace cmdlet defines the access method and associated credentials that are used to exchange free/busy data across forests. To effectively use the command, run it on a computer that has the Client Access server role installed.
To run the Add-AvailabilityAddressSpace cmdlet, the account you use must be delegated the following:
- Exchange Organization Administrator role
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 |
|---|---|---|---|
AccessMethod |
Required |
Microsoft.Exchange.Data.Directory.SystemConfiguration.AvailabilityAccessMethod |
Use the AccessMethod parameter and PerUserFB to access the free/busy data in the defined per-user free/busy proxy account or group, or in the All Exchange Servers group. PerUserFB requires trust between the two forests. You must use either the UseServiceAccount parameter or Credentials parameter. Use OrgWideFB 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 PublicFolder to access free/busy data on servers that are running Microsoft Exchange Server 2003 or Exchange 2000 Server. 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 cmdlet once for each SMTP domain. |
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 do not have to specify a value with the Confirm parameter. |
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 |
To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command. |
ProxyUrl |
Optional |
System.Uri |
The ProxyUrl parameter is used to direct an Exchange 2007 Client Access server to proxy its free/busy requests through an Exchange 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 and New-SharingRelationship. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
When an existing object is supplied to the TemplateInstance parameter, the command uses the configuration of that object to create an identical copy of the object on a local or target server. |
UseServiceAccount |
Optional |
System.Boolean |
When the UseServiceAccount parameter is assigned a value of |
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
The first example of the Add-AvailabilityAddressSpace command is useful with untrusted cross-forest availability service, or if detailed cross-forest free/busy service is not desired. When you are prompted by the command, type a user name and password. For untrusted cross-forest configuration, make sure that the user does not have a mailbox.
The second example of the Add-AvailabilityAddressSpace command is useful with 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.
The third example of the Add-AvailabilityAddressSpace command is useful with 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.
The fourth example of the Add-AvailabilityAddressSpace command is useful for interoperability between Exchange Server 2007 and earlier versions of Exchange.
Add-AvailabilityAddressSpace -ForestName <example.contoso.com> -AccessMethod OrgWideFB -Credentials <ExampleCredential>
Add-AvailabilityAddressSpace -ForestName <example.contoso.com> -AccessMethod PerUserFB -Credentials <ExampleCredential>
Add-AvailabilityAddressSpace -ForestName <example.contoso.com> -AccessMethod PerUserFB -UseServiceAccount <$true>
Add-AvailabilityAddressSpace -ForestName <example.contoso.com> -AccessMethod PublicFolder