The name of a destination, defined in a local saprfc.ini or sapnwrfc.ini file. When this connection property is set, the connection details embedded in this destination are used to connect.

Syntax

Connect-SAPERP -Destination string

Data Type

cstr

Default Value

""

Remarks

As an alternative to describing your connection details to the 本製品 via connection properties, setting this connection property to the name of a destination (the value of the "DEST" parameter from a local saprfc.ini or sapnwrfc.ini file) causes the 本製品 to instead use the configuration found in that .ini file to connect.

Take the following .ini file for example (the contents of the .ini file vary depending on your specific connection configuration):

DEST=MYSAPDEST
TYPE=A
CLIENT=001
LANG=EN
ASHOST=10.0.1.123
SYSNR=00

To use this .ini's configuration to connect, you would set this connection property to "MYSAPDEST".

Note: This connection property is not supported when ConnectionType is set to Soap.

The name and the location of the .ini file varies depending on the ConnectionType specified:

• For the CLASSIC type, the file is named saprfc.ini and the file path can be found in the RFC_INI environment variable.
• For the Netweaver type, the file is named sapnwrfc.ini. Place this file in the current execution directory. For example, if you are creating an application that incorporates the 本製品, place sapnwrfc.ini next to that project's executable file.

Note that values absent from the .ini (such as User and Password) still need to be set using connection properties.

See the SAP RFC SDK for more information about using .ini files with the RFC library.