Set-ClientAccessServer (RTM)
Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.
Applies to: Exchange Server 2007
The Set-ClientAccessServer command sets properties on specified Client Access server objects.
Syntax
Set-ClientAccessServer -Identity <ClientAccessServerIdParameter> [-AutoDiscoverServiceInternalUri <Uri>] [-AutoDiscoverSiteScope <MultiValuedProperty>] [-DomainController <Fqdn>]
Set-ClientAccessServer [-AutoDiscoverServiceInternalUri <Uri>] [-AutoDiscoverSiteScope <MultiValuedProperty>] [-DomainController <Fqdn>] [-Instance <ClientAccessServer>]
Detailed Description
The Set-ClientAccessServer command lets you set properties on specified Client Access server objects. You can run this command for a single Client Access server or all Exchange 2007 computers that have the Client Access server role installed in your organization.
To run the Set-ClientAccessServer 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 |
|---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.ClientAccessServerIdParameter |
This parameter specifies an individual Client Access server. |
AutoDiscoverServiceInternalUri |
Optional |
System.Uri |
This parameter specifies the internal URL of the Autodiscover service. |
AutoDiscoverSiteScope |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
This parameter specifies the site for which the Autodiscover service is authoritative. Clients that connect to the Autodiscover service by using the Internal URL should belong to a site listed here. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
This parameter specifies the fully qualified domain name of the domain controller that writes this configuration change to Active Directory. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.Management.ClientAccessServer |
This parameter specifies an instance of a Client Access server. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
The following code example sets two properties on the Client Access server that is named CAS-01.
Set-ClientAccessServer -Identity "CAS-01" -AutodiscoverServiceInternalURI "cas.mail.contoso.com" -AutodiscoverServiceSiteScope "Mail"