[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Imports the Microsoft Communications Server “14” topology to a computer. This enables topology information to be passed to a computer without waiting for replication to take place.


Import-CsConfiguration -ByteInput <Byte[]> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
Import-CsConfiguration -FileName <String> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]


Parameter Required Type Description



Byte array

Reads topology information from a byte array stored in a variable. This byte array is created by using the –AsBytes parameter when calling Export-CsConfiguration.




Path to the .ZIP file created by Export-CsConfiguration. For example: -FileName "C:\Config.zip". Note that you must include either the –FileName or the –ByteInput parameter, but not both, when calling Import-CsConfiguration.



Switch Parameter

Suppresses the display of any non-fatal error message that might arise when running the command.



Switch Parameter

Detailed Description

Computers that run Microsoft Communications Server “14” services or server roles must have a copy of the current topology before they can function in their appointed role. When you set up a new Communications Server computer (for example, a new Monitoring or Archiving server) you typically wait for the regular replication cycle to transmit the current topology to the new computer. Alternatively, you can use the Export-CsConfiguration and Import-CsConfiguration cmdlets to manually replicate the topology to the new computer. Export-CsConfiguration enables you to retrieve the current topology and store it either as a .ZIP file or in a variable; that .ZIP file or variable can then be read in on the new computer by using Import-CsConfiguration. The net effect: topology information will be copied to the new computer, without having to wait for replication.

Return Types

Import-CsConfiguration does not return any values or objects.


-------------------------- Example 1 ------------------------

Copy Code
Import-CsConfiguration -FileName "C:\Config.zip"

The preceding command imports the current topology from a file named C:\Config.zip. The .ZIP file contains a copy of the current topology in XML format.

-------------------------- Example 2 ------------------------

Copy Code
$x = Export-CsConfiguration -AsBytes
Import-CsConfiguration -ByteInput $x

The two commands shown in Example 2 export and import the current topology without using a .ZIP file. To do this, the first command uses Export-CsConfiguration and the –AsBytes parameter to return the current topology as a byte array; this byte array is stored in a variable named $x. In the second command, Import-CsConfiguration and the –ByteInput parameter are used to read in the topology information stored in $x.