Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-05
Use the Set-AvailabilityConfig cmdlet to set the access level for free/busy information.
Syntax
Set-AvailabilityConfig [-DomainController <Fqdn>]
[-Instance <AvailabilityConfig>] [-OrgWideAccount
<SecurityPrincipalIdParameter>] [-PerUserAccount
<SecurityPrincipalIdParameter>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
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. |
|
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.AvailabilityConfig |
The Instance parameter enables you to pass an entire object to the command to be processed. It is mainly used in scripts where an entire object must be passed to the command. |
|
OrgWideAccount |
Optional |
Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter |
The OrgWideAccount parameter specifies an account or security group that has permission to issue proxy availability service requests on an organization-wide basis. |
|
PerUserAccount |
Optional |
Microsoft.Exchange.Configuration.Tasks.SecurityPrincipalIdParameter |
The PerUserAccount parameter specifies an account or security group that has permission to issue proxy availability service requests on a per-user basis. |
Detailed Description
The Set-AvailabilityConfig cmdlet defines two accounts or security groups: a per-user free/busy proxy account or group, and an organization-wide free/busy proxy account or group. These accounts and groups are trusted by all availability services in the current organization for availability proxy requests.
For cross-forest availability services to retrieve free/busy information in the current forest, they must be using one of the specified accounts, belong to one of the specified security groups, or have a user name and password for one of the specified accounts or security groups.
To run the Set-AvailabilityConfig 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.
Input Types
Return Types
Errors
| Error | Description |
|---|---|
Exceptions
| Exceptions | Description |
|---|---|
Example
The first example of the Set-AvailabilityConfig command is useful with trusted cross-forest availability service. If the remote forest is trusted, and per-user free/busy proxy account or group in the remote forest is configured to use the service account, the configuration is added to the current forest to authorize the ActiveSync request from the remote forest.
The second example of the Set-AvailabilityConfig command is useful if the remote forest is not trusted. When you are prompted, type the user name and password. Because this account is used for a cross-forest free/busy proxy account or group, minimize security vulnerabilities by using the credentials of a user who does not have an Exchange mailbox.
 Copy Code |
|
|---|---|
Set-AvailabilityConfig -PerUserAccount <domain name of servers group in remote forest> Set-AvailabilityConfig -OrgWideAccount <ExampleCredentials> |
|