Tapicfg
Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2
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
tapicfg remove
tapicfg publishscp
tapicfg removescp
tapicfg show
tapicfg makedefault
Creates a TAPI application directory partition.
tapicfg install /directory: PartitionName[/server:DCName] [/forcedefault]
- 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.
Removes a TAPI application directory partition.
tapicfg remove /directory: PartitionName
- 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.
Creates a service connection point to publish a TAPI application directory partition.
tapicfg publishscp /directory: PartitionName[/domain:DomainName] [/forcedefault]
- 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.
Removes a service connection point for a TAPI application directory partition.
tapicfg removescp /directory: PartitionName[**/domain:**DomainName]
- 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.
Displays the names and locations of the TAPI application directory partitions in the domain.
tapicfg show [/defaultonly][**/domain:**DomainName]
- /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.
Sets the default TAPI application directory partition for the domain.
tapicfg makedefault /directory: PartitionName[**/domain:**DomainName]
- 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.
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).
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
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 |
Command shell overview
Command-line reference A-Z
Create a TAPI application directory partition
Remove a TAPI application directory partition