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.
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.
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.
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.
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.
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.
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
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 |
|
|