Removes the Active Directory service control point for the Microsoft Communications central management database.
Syntax
Remove-CsConfigurationStoreLocation [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Report |
Optional |
String |
Enables you to specify a file path for the log file created when the cmdlet runs. For example: -Report "C:\Logs\ConfigurationStore.html" |
|
GlobalSettingsDomainController |
Optional |
String |
Fully qualified domain name of a domain controller where global settings are stored If global settings are stored in the System container in Active Directory then this parameter must point to the root domain controller. If global settings are stored in the Configuration container then any domain controller can be used and this parameter can be omitted. |
|
Force |
Optional |
Switch Parameter |
Suppresses the display of any non-fatal error message that might arise when running the command. |
|
WhatIf |
Optional |
Switch Parameter |
Describes what would happen if you executed the command without actually executing the command. |
|
Confirm |
Optional |
Switch Parameter |
Prompts you for confirmation before executing the command. |
Detailed Description
Active Directory uses service control points (SCP) to help computers locate services. For example, when you install Microsoft Communications Server “14” a service control point is created that provides location information for the Central Management Database used to maintain Communications Server data. Computers that need access to the database connect to Active Directory and use the information contained in the service control point to help them locate the correct computer and the correct instance of SQL Server.
As noted, when you install Microsoft Communications Server an SCP for the Central Management Database is automatically created for you. Typically, you do not want to delete that service control point; if you do, computers will not be able to locate the database. However, there might be times (perhaps when troubleshooting a problem) where you will be required to delete the SCP. To delete the service control point, use the cmdlet Remove-CsConfigurationStoreLocation. After the SCP has been deleted, you can recreate it (or create a new service control point) by using the Set-CsConfigurationStoreLocation cmdlet.
Return Types
Remove-CsConfigurationStoreLocation does not return any objects or values.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Remove-CsConfigurationStoreLocation |
|
The command shown in Example 1 removes the Active Directory service control point for the Microsoft Communications central management database. To restore this service control point (or to create a new service control point) you must run the Set-CsConfigurationStoreLocation cmdlet.
-------------------------- Example 1 ------------------------
| Copy Code |
|
|---|---|
Remove-CsConfigurationStoreLocation -Report C:\Store_Location.html |
|
Example 2 also removes the Active Directory service control point for the Microsoft Communications central management database. In addition to deleting the service control point, this command records information about the success (or failure) of the operation to the log file C:\Store_Location.html. To create this log file, the command uses the -Report parameter followed by the path to the log file where information should be recorded. If this file already exists, the contents will be overwritten when the command runs. If the file does not exist, it will be created when the command runs.