如何配置文件适配器、读取安全建议并查看所需的权限。
可以使用 BizTalk Server 管理或以编程方式创建接收位置和发送端口。 本主题重点介绍 BizTalk Server 管理控制台。 有关编程步骤，请转到 “创建接收位置”或以编程方式发送端口。
重要
从 BizTalk Server 2016 开始，可以使用文件适配器连接到 Azure 文件共享。 必须在 BizTalk Server 上装载 Azure 存储帐户。 Windows 上的 Azure 文件存储入门 列出了装载步骤。
安全建议
文件适配器将文件从 BizTalk Server 传入和传出目录。 建议遵循以下准则来保护和部署环境中的文件适配器：
不要打开端口以连接到外围网络中的文件共享。 应在具有较高信任级别（例如 Intranet）的环境中使用文件适配器。
在接收位置的投放目录中设置强自主访问控制列表（DACL）。 例如，必须将读取、写入、删除文件，以及删除子文件夹和文件的权限设置为文件接收位置的目录，这样只有经过授权的用户才能在此位置投放消息。
在使用文件适配器选取关键数据时，建议使用互联网协议安全（IPSec）。
所需的权限
适配器处理程序在为适配器处理程序选择的主机实例的安全上下文下运行。 主机实例使用Logon主机名中的属性 - BizTalk 管理中的主机实例属性。 此 Logon 帐户必须具有对文件适配器使用的任何文件夹或共享的特定权限。
处理程序使用的主机实例用户帐户需要以下权限。 ✔表示需要权限。 空白条目表示不需要权限。
| 权限 | 接收处理程序 | 发送处理程序 |
|---|---|---|
| 完全控制 | ✔ 在共享级别（如果访问文件共享） |
|
| 遍历文件夹/执行文件 | ✔ 在文件级别 |
|
| 列出文件夹/读取数据 | ✔ 在文件层级 |
✔ 在文件级别 |
| 读取属性 | ✔ 在文件级别 |
|
| 读取扩展属性 | ✔ 在文件级别 |
|
| 创建文件/写入数据 | ✔ 在文件级别 |
|
| 创建文件夹/追加数据 | ✔ 在文件级别 |
|
| 删除子文件夹和文件 | ✔ 在文件级别 |
✔ 在文件级别 |
| 读取权限 | ✔ 在文件级别 |
|
| 改变 | ✔ 在共享级别（如果访问文件共享） |
小窍门
在文件级别，打开文件或文件夹 的高级权限 以查看这些权限。
注释
每个主机只能与一个接收处理程序相关联。
配置接收位置
注释
在完成以下过程之前，必须已添加单向接收端口。 请参阅 如何创建接收端口。
在 BizTalk Server 管理控制台中，依次展开 BizTalk Server 管理、BizTalk 组、应用程序，然后展开要创建接收位置的应用程序。
在左窗格中，单击 “接收端口 ”节点。 然后在右窗格中，右键单击与现有接收位置关联的接收端口或要与新接收位置关联的接收端口，然后单击“ 属性”。
在 “接收端口属性 ”对话框的左窗格中，选择“ 接收位置”，然后在右窗格中双击现有接收位置，或单击“ 新建 ”创建新的接收位置。
在 “接收位置属性 ”对话框中的“ 传输 ”部分中，从下拉列表中选择 “文件类型 ”，然后单击“ 配置 ”以配置接收位置的传输属性。
在“ 常规 ”选项卡中执行以下作：
用这个 要执行的操作 接收文件夹 必填。 输入文件系统、网络共享或 Azure 文件共享中文件接收处理程序读取文件的文件夹路径。 可以直接在 “接收”文件夹 文本框中输入路径，或使用 “浏览 ”按钮从文件系统中选择该路径。 浏览文件夹时，还可以使用 “新建文件夹”创建新文件夹。
如果使用 Azure 文件共享，请输入\\yourfilestoragename.file.core.windows.net\yourfilesharename。
类型： 字符串
注意： 不要将 Receive 文件夹 属性设置为使用带符号链接的 NT 分布式文件系统的文件夹。 如果使用 NT 分布式文件系统，则只能在文件适配器接收位置中使用具有直接网络路径的文件夹。
有关此属性的限制，请参阅 配置文件适配器时的限制。
注意： 发送端口或接收位置的 URI 不能超过 256 个字符。文件掩码 必填。 指定文件的掩码。 此掩码可以包含标准通配符值“*”。
默认值： *.xml
类型：字符串
有关此属性的限制，请参阅 配置文件适配器时的限制。公共地址 指定此位置的公共地址。 BizTalk Server 向外部合作伙伴公开此地址。
如果未指定此属性，运行时引擎会将其替换为：
< file:// Receive 文件夹>/<文件掩码>
此属性的值需要适配器前缀。
类型：字符串
最小长度： 0
最大长度：256重试计数 指定在网络共享暂时不可用时尝试访问接收位置的次数。
默认值： 5
类型： 长
最小值： 0
最大值： MAX_LONG重试间隔（最小值） 如果网络共享暂时不可用，请在尝试访问网络共享上的接收位置之间指定重试间隔时间（以分钟为单位）。
默认值： 5 分钟
类型： 长
最小值： 0
最大值： MAX_LONG在 “身份验证 ”选项卡上执行以下作：
用这个 要执行的操作 当主机无权访问网络共享时使用这些凭据 仅当使用网络共享或 Azure 文件共享时才是必需的。
默认值： 假
类型： 布尔用户名 如果使用网络共享，请输入有权访问共享的用户名。
如果使用 Azure 文件共享，请输入存储帐户的名称。
类型： 字符串
注意： 如果将映射到同一网络共享的多个接收位置配置为备用凭据，则必须对所有接收位置使用相同的凭据。 如果你尝试使用多个凭据集，Windows 不允许从同一台计算机与共享网络服务器建立多个连接。密码 如果使用网络共享，请输入有权访问网络共享的帐户的密码。
如果使用 Azure 文件共享，请输入存储帐户访问密钥;Azure 门户中列出了该列表。
类型：字符串在 “批处理” 选项卡中执行以下操作：
用这个 要执行的操作 批处理中的消息数 指定要在批处理中提交的最大消息数。
默认值： 5
类型： Int
最小值： 1
最大值： 256最大批大小（以字节为单位） 指定批处理的最大总字节数。
默认值： 102400
类型： Int
最小值： 1024
最大值： MAX_LONG文件适配器会将批处理限制为首先达到的值，最大消息数或允许的最大字节数。
选择“确定”。
在 “接收位置属性 ”对话框中输入相应的值以完成接收位置的配置，然后单击“ 确定 ”保存设置。 有关 “接收位置属性 ”对话框的信息，请参阅 “如何创建接收位置”。
配置发送端口
在 BizTalk Server 管理控制台中，创建新的发送端口，或双击现有发送端口对其进行修改。 请参阅 如何创建发送端口。 配置所有发送端口选项，并为“常规”选项卡的“传输”部分中的“类型”选项指定 FILE。
选择“类型”旁边的“配置”按钮。
在“ 常规 ”选项卡中执行以下作：
用这个 要执行的操作 目标位置 必填。 输入文件系统、公共共享或 Azure 文件共享上位置的路径以写入输出消息。 可以直接在 目标位置输入路径，或使用 “浏览 ”按钮从文件系统中选择该路径。 在“ 浏览文件夹 ”对话框中浏览文件夹时，还可以单击“ 新建文件夹”创建新文件夹。
如果使用 Azure 文件共享，请输入\\yourfilestoragename.file.core.windows.net\yourfilesharename。
类型： 字符串
注意： 发送端口或接收位置的 URI 不能超过 256 个字符。文件名 指定文件发送处理程序写入消息的文件的名称。
有关此属性的限制，包括使用文件名中的宏，请参阅 配置文件适配器时的限制。复制模式 定义将消息写入文件时要使用的复制模式。 有效值为：
附加。 如果文件存在，则文件发送处理程序将打开一个文件，并将消息追加到文件末尾。 如果文件不存在，则文件发送处理程序将创建一个新文件。
覆盖。 文件发送处理程序在文件存在时打开它并覆盖其内容。 如果文件不存在，则文件发送处理程序将创建一个新文件。
新建。 如果文件不存在，则文件发送处理程序将创建一个新文件并写入该文件。 如果文件已存在，则文件发送处理程序报告错误，然后遵循发送端口的常见适配器重试逻辑。 这是文件发送处理程序的默认复制模式。允许写入时缓存 定义在向文件写入消息时是否使用文件系统缓存。
有效选项是：
假 请勿使用文件系统缓存。
启用 使用文件系统缓存。
默认值： 错误 重要提示： 如果将此属性设置为 True ，可能会增加文件适配器的性能，但当断电，而不是所有数据写入磁盘时，可能会丢失数据。写入时使用临时文件 定义是否先将输出文件写入临时文件，然后在写入作完成后重命名该文件。 如果启用此选项，则将使用扩展名 BTS-WIP 创建临时文件。
有效选项为
真 写入目标文件夹时，文件适配器会创建一个临时文件。
假 写入目标文件夹时，文件适配器不会创建临时文件。
默认值：False 注意：仅当 CopyMode 属性设置为“新建”值时，此选项才可用在 “身份验证 ”选项卡上执行以下作：
用这个 要执行的操作 当主机无权访问网络共享时使用这些凭据 仅当使用网络共享或 Azure 文件共享时才是必需的。
默认值： 假
类型： 布尔用户名 如果使用网络共享，请输入有权访问共享的用户名。
如果使用 Azure 文件共享，请输入存储帐户的名称。
类型：字符串密码 如果使用网络共享，请输入有权访问网络共享的帐户的密码。
如果使用 Azure 文件共享，请输入存储帐户访问密钥;Azure 门户中列出了该列表。
类型：字符串选择确定保存设置。
设置动态发送端口的属性
动态发送端口不提供 BizTalk Server 管理控制台中的任何传输配置选项，因为预期这些属性将与消息关联的上下文属性提供。 可以在自定义管道或编排中设置这些属性。 若要在编排流程中设置消息配置属性，可以执行以下步骤：
向业务流程添加 构造消息 形状。
配置 构造消息 形状以构造新消息。 （例如Message_2）
向构造消息形状添加消息分配形状。
将代码添加到 消息分配 形状以初始化所构造的消息，并设置消息的相应配置属性。 以下代码初始化一个名为Message_2的消息，该消息是使用 构造消息 形状构造的，然后为消息设置两个配置属性。 在此情景中，编排最先接收到Message_1：
Message_2=Message_1; Message_2(FILE.CopyMode)= 0; //0=Append Message_2(FILE.AllowCacheOnWrite)= true; Message_2(FILE.UseTempFileOnWrite)= true;
配置接收或发送处理程序
在 BizTalk Server 管理控制台中，展开 BizTalk Server 管理、 BizTalk 组、 平台设置，然后单击“ 适配器”。
在适配器的展开列表中，单击 “文件”，在右侧窗格中，右键单击要配置的接收或发送处理程序。 选择 属性。
在 “主机名 ”列表中，选择要运行处理程序的主机。
单击 “确定” 。