Computer and Software Support


Tapicfg

This page is from Microsoft

Updated: January 21, 2005

Creates, removes, or displays a TAPI application directory partition, or sets a default TAPI application directory partition. TAPI 3.1 clients can use the information in this application directory partition with the directory service locator service to find and communicate with TAPI directories.

You can also use Tapicfg to create or remove service connection points, which enable TAPI clients to efficiently locate TAPI application directory partitions in a domain. For more information, see Remarks.

To view the command syntax, click a command.

tapicfg install

Creates a TAPI application directory partition.
Syntax
tapicfg install /directory:PartitionName[/server:DCName] [/forcedefault]
Parameters
install /directory:PartitionName
Required. Specifies the DNS name of the TAPI application directory partition to be created. This name must be a fully qualified domain name.
/server:DCName
Specifies the DNS name of the domain controller on which the TAPI application directory partition is created. If the domain controller name is not specified, the name of the local computer is used.
/forcedefault
Specifies that this directory is the default TAPI application directory partition for the domain. There can be multiple TAPI application directory partitions in a domain. If this directory is the first TAPI application directory partition created on the domain, it is automatically set as the default, regardless of whether you use the /forcedefault option.

tapicfg remove

Removes a TAPI application directory partition.
Syntax
tapicfg remove /directory:PartitionName
Parameters
remove /directory:PartitionName
Required. Specifies the DNS name of the TAPI application directory partition to be removed. Note that this name must be a fully qualified domain name.

tapicfg publishscp

Creates a service connection point to publish a TAPI application directory partition.
Syntax
tapicfg publishscp /directory:PartitionName[/domain:DomainName] [/forcedefault]
Parameters
publishscp /directory:PartitionName
Required. Specifies the DNS name of the TAPI application directory partition that the service connection point will publish.
/domain:DomainName
Specifies the DNS name of the domain in which the service connection point is created. If the domain name is not specified, the name of the local domain is used.
/forcedefault
Specifies that this directory is the default TAPI application directory partition for the domain. There can be multiple TAPI application directory partitions in a domain.

tapicfg removescp

Removes a service connection point for a TAPI application directory partition.
Syntax
tapicfg removescp /directory:PartitionName[/domain:DomainName]
Parameters
removescp /directory:PartitionName
Required. Specifies the DNS name of the TAPI application directory partition for which a service connection point is removed.
/domain:DomainName
Specifies the DNS name of the domain from which the service connection point is removed. If the domain name is not specified, the name of the local domain is used.

tapicfg show

Displays the names and locations of the TAPI application directory partitions in the domain.
Syntax
tapicfg show [/defaultonly][/domain:DomainName]
Parameters
/defaultonly
Displays the names and locations of only the default TAPI application directory partition in the domain.
/domain:DomainName
Specifies the DNS name of the domain for which the TAPI application directory partitions are displayed. If the domain name is not specified, the name of the local domain is used.

tapicfg makedefault

Sets the default TAPI application directory partition for the domain.
Syntax
tapicfg makedefault /directory:PartitionName[/domain:DomainName]
Parameters
makedefault /directory:PartitionName
Required. Specifies the DNS name of the TAPI application directory partition set as the default partition for the domain. Note that this name must be a fully qualified domain name. Specifies the DNS name of the domain for which the TAPI application directory partition is set as the default. If the domain name is not specified, the name of the local domain is used.
tapicfg /?
Displays Help at the command prompt.
Remarks
You must be a member of the Enterprise Admins group in Active Directory to run either tapicfg install (to create a TAPI application directory partition) or tapicfg remove (to remove a TAPI application directory partition).

This command-line tool can be run on any computer that is a member of the domain.

User-supplied text (such as the names of TAPI application directory partitions, servers, and domains) with International or Unicode characters are only displayed correctly if appropriate fonts and language support are installed.

You can still use Internet Locator Service (ILS) servers in your organization, if ILS is needed to support certain applications, because TAPI clients running Windows XP or a Windows Server 2003 operating system can query either ILS servers or TAPI application directory partitions.

You can use Tapicfg to create or remove service connection points. If the TAPI application directory partition is renamed for any reason (for example, if you rename the domain in which it resides), you must remove the existing service connection point and create a new one that contains the new DNS name of the TAPI application directory partition to be published. Otherwise, TAPI clients are unable to locate and access the TAPI application directory partition. You can also remove a service connection point for maintenance or security purposes (for example, if you do not want to expose TAPI data on a specific TAPI application directory partition).

Examples
To create a TAPI application directory partition named tapifiction.testdom.microsoft.com on a server named testdc.testdom.microsoft.com and then set it as the default TAPI application directory partition for the new domain, type:

tapicfg install /directory:tapifiction.testdom.microsoft.com /server:testdc.testdom.microsoft.com /forcedefault

To display the name of the default TAPI application directory partition for the new domain, type:

tapicfg show /defaultonly

Formatting legend


 
Format Meaning
Italic Information that the user must supply
Bold Elements that the user must type exactly as shown
Ellipsis (...) Parameter that can be repeated several times in a command line
Between brackets ([]) Optional items
Between braces ({}); choices separated by pipe (|). Example: {even|odd} Set of choices from which the user must choose only one
Courier font Code or program output