PowerShell 模块 Cmdlet 和命令

PowerShell 模块

Windows PowerShell® 是基于任务的命令行 shell 和脚本语言，专为系统管理而设计。 Windows PowerShell 基于 .NET Framework 构建，可帮助 IT 专业人员和电源用户控制并自动管理在 Windows 上运行的 Windows作系统和应用程序。 DRDA 服务提供 PowerShell 命令作为常见 HIS 2013 PowerShell 模块的一部分，Microsoft.HostIntegration.PowerShell，包括许多用于添加/get/remove/set MsDrdaService.exe.config 元素和属性的 Cmdlet 命令，以及用于启动/停止侦听器的命令。

PowerShell Cmdlet

PowerShell cmdlet 是在 Windows PowerShell 环境中使用的轻型命令。 Windows PowerShell 运行时在命令行提供的自动化脚本上下文中调用这些 cmdlet。 Windows PowerShell 运行时还通过 Windows PowerShell API 以编程方式调用它们。

用于定义可供用户或运行 cmdlet 的应用程序可用的参数的公共属性。 Cmdlet 可以具有必需参数、命名参数、位置参数和开关参数。 switch 参数是一个参数，可以在运行命令时指定或不能指定此参数。 如果指定了参数，则 Windows PowerShell 运行时将其值解析为 true。 如果未指定参数（通常是默认值），则参数值解析为 false。 通用参数将添加到所有 cmdlet，并在运行 cmdlet 时访问。

DRDA 服务 PowerShell 模块 Cmdlet 命令

DRDA 服务配置存储在 MsDrdaService.exe.config 应用程序配置（应用配置）文件中，以及关联的 XML 文件（错误消息映射和数据类型映射）。 在运行时，DRDA 服务将监视 MsDrdaService.exe.config 文件以获取更改。 检测到后，DRDA 服务会在处理新的绑定连接时读取和使用更改的配置信息。 DRDA 服务包括 %SNAROOT%\System\Schemas\HostIntegrationDrdaServiceConfiguration.xsd 文件来验证应用程序配置文件。

IT 专业人员可以使用 DRDA 服务 PowerShell 模块 Microsoft.HostIntegration.PowerShell 自定义 DRDA 服务配置。 cmdlet 分组到配置和操作集合中。

先决条件软件

DRDA 服务 PowerShell 模块需要以下软件产品作为功能先决条件。

• Microsoft PowerShell 3.0 （Windows Management Framework 3.0）

  • https://www.microsoft.com/download/details.aspx?id=34595

启动 PowerShell

通过运行其中一个命令，使用管理员权限启动 PowerShell。

• 在 “开始” 屏幕中，右键单击 Windows PowerShell 应用磁贴，然后在应用栏中单击“ 以管理员身份运行”。

• 在任务栏上的 服务器管理器 或 桌面 中，右键单击 Windows PowerShell 快捷方式，然后单击“ 以管理员身份运行”。

• 在 桌面上，将光标移动到右上角，单击“ 搜索”，键入 PowerShell，右键单击 Windows PowerShell 应用磁贴，然后在应用栏中单击“ 以管理员身份运行”。

• 在 Windows PowerShell 命令提示符处，键入：

  Start-Process PowerShell -Verb RunAs
  

启动 PowerShell ISE

通过运行其中一个命令，使用管理员权限启动 PowerShell ISE（集成脚本环境）。

• 在 “开始” 屏幕中，键入 ISE，右键单击 Windows PowerShell ISE 磁贴，然后在应用栏中单击“ 以管理员身份运行”。

• 在任务栏上，右键单击 Windows PowerShell ，然后单击“ 以管理员身份运行 ISE”。

• 在“服务器管理器 工具” 菜单中，选择 Windows PowerShell ISE。

• 在 Windows PowerShell 命令提示符处，键入：

  Start-Process PowerShell_ISE -Verb RunAs
  

设置模块路径

DRDA 服务 PowerShell 模块必须位于模块路径中。 使用独立MsDrdaService.MSI安装 DRDA 服务时，必须使用 PowerShell 或 PowerShell ISE 手动设置模块路径。

1. 在 Windows PowerShell 或 PowerShell ISE 命令提示符处，键入以下命令，然后单击 Enter。

   Import-Module "C:\Program Files\Microsoft Host Integration Server 2013\system\Microsoft.HostIntegration.PowerShell"
   

2. 键入以下 Get-Module 命令，然后单击 Enter。

   Get-Module Microsoft.HostIntegration.PowerShell
   

3. 验证以下信息。

   ModuleType Version    Name                                ExportedCommands
   ---------- -------    ----                                ----------------
   Binary     9.0.1000.0 Microsoft.HostIntegration.PowerS... {Add-HisDrdaApplicationEncoding, Remove-HisDrdaApplicationEncoding, Get-HisDrdaApplicationEncoding, Add-HisDrdaCollationName...}
   

获取模块命令

1. 在 Windows PowerShell 或 PowerShell ISE 命令提示符处，键入以下命令，然后单击 Enter。

   Get-Command -Module Microsoft.HostIntegration.PowerShell
   

2. 验证以下信息。

DRDA 服务命令

以下 Microsoft.HostIntegration.PowerShell cmdlet 命令用于 DRDA 服务。

命令类型	名称	ModuleName
Cmdlet	Add-HisCustomCodePage	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisCustomConversion	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaApplicationEncoding	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaCollationName	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaDatabaseAlias	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaDatetimeFormat	Microsoft.HostIntegration.PowerShell
Cmdlet	Add-HisDrdaPackageBindListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisCustomCodePage	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisCustomConversion	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaApplicationEncoding	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaCollationName	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaDatabaseAlias	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaDatetimeFormat	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaPackageBindListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaPackageBindProcessing	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaPackageProcedureCache	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaService	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaSqlServerConnection	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaSqlTransform	Microsoft.HostIntegration.PowerShell
Cmdlet	Get-HisDrdaTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisCustomCodePage	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisCustomConversion	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaApplicationEncoding	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaCollationName	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaDatabaseAlias	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaDatetimeFormat	Microsoft.HostIntegration.PowerShell
Cmdlet	Remove-HisDrdaPackageBindListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaConsoleTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaEtwTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaEventLogTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaPackageBindProcessing	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaPackageProcedureCache	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaService	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaSqlServerConnection	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaSqlTransform	Microsoft.HostIntegration.PowerShell
Cmdlet	Set-HisDrdaTextTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Start-HisDrdaTraceListener	Microsoft.HostIntegration.PowerShell
Cmdlet	Stop-HisDrdaTraceListener	Microsoft.HostIntegration.PowerShell

表 1. DRDA 服务 PowerShell 命令的列表。

DRDA 服务连接和包绑定处理

DRDA 服务连接和包绑定包括：（1） DRDA 客户端到 DRDA 服务连接、（2） DRDA 服务到 SQL Server 连接、（3） DRDA 服务到 DRDA 服务连接，以及 （4） DRDA 服务包绑定处理（包括 SQL 语法转换）。

Set-HisDrdaService

此 Set-HisDrdaService cmdlet 为绑定 DRDA 客户端连接配置 DRDA 服务。

Syntax

Set-HisDrdaService [-PartnerServers<string>] [-Port<uint32>] [-IsPrimary ] [-UseSsl ] [-PingInterval<uint32>] [-EnablePerformanceCounters ] [-AllowClientIpAddresses<string>] [-SslCertificatePath<string>] [<CommonParameters>]

参数

AllowClientIpAddresses 参数将 DRDA 服务限制为接受已知 DRDA AR 客户端计算机列表中的绑定 TCP/IP 网络连接。 此 可选 参数接受 字符串 值。 默认值为 空字符串，它允许 DRDA 服务响应所有绑定的客户端连接请求。 该列表由 TCP/IP 地址或别名分号分隔组成。 TCP/IP 地址可以采用 IPv4 或 IPv6 格式定义。 例如，123.34.45.57;123.34.45.58 以 IPv4 网络地址格式定义有效的客户端列表。

EnablePeformanceCounters 参数指示 DRDA 服务将信息收集到性能计数器中。 此 可选 参数接受 布尔 值。 默认值是 false。

IsPrimary 参数指示 DRDA 服务是否在一组服务器中的主角色中运行。 此 可选 参数接受 布尔 值。 默认值为 true。 主服务器将通过处理 EXCSAT（Exchange 服务器属性）、ACCSEC（访问安全性）和 ACCRDB（访问关系数据库）来响应所有 DRDA AR 客户端请求，包括返回 ACCRDBRM （ACCRDB 回复消息）上的 SRVLST （服务器列表）。 服务器列表包含主要服务器（最高加权值）和辅助服务器（最低加权值）的加权优先级列表，以通知 DRDA AR 客户端要连接到的 DRDA 服务计算机

PartnerServers 参数定义辅助服务器计算机的列表。 当 isPrimary=false 并接受字符串值时，此可选参数是必需的。 默认值为 空字符串。 该列表由 TCP/IP 地址或别名冒号组成，由 TCP/IP 端口号分隔。 TCP/IP 地址可以采用 IPv4 或 IPv6 格式定义。 该列表可以包含多个以分号分隔的伙伴服务器计算机。 例如，123.34.45.57：446;123.34.45.58：446 以 IPv4 网络地址格式定义有效的合作伙伴服务器列表。

PingInterval 参数通过执行 EXCSAT（Exchange Server 属性）流并检查 EXCSAT（EXCSAT 回复数据）来指示 DRDA 服务监视伙伴服务器计算机的运行状况的频率。 此 可选 参数接受 整数 值。 默认值为 10000 毫秒（10 秒）。

端口参数定义 DRDA 服务必须侦听绑定 DRDA 应用程序请求程序客户端连接请求的 TCP/IP 端口号。 此 可选 参数接受 整数 值。 默认值为 446。

SslCertificatePath 参数指定 SSL 或 TLS 证书公用名 （CN）。 当 useSSL=true 并接受字符串值时，此可选参数是必需的。 默认值为 空字符串。

UseSSL 参数指示 DRDA 服务在响应绑定的 TCP/IP 网络连接时使用安全套接字层 （SSL） 版本 3.0 和传输层安全性 （TLS） 版本 1.0。 此 可选 参数接受 布尔 值。 默认值是 false。

示例

以下示例命令设置默认值。

Set-HisDrdaService -IsPrimary -PingInterval 10000 -Port 446

Get-HisDrdaService

此 Get-HisDrdaService cmdlet 获取绑定 DRDA 客户端连接的 DRDA 服务配置设置。

Syntax

Get-HisDrdaService [<CommonParameters>]

参数

没有。

输出

此 Get-HisDrdaService cmdlet 返回具有属性的对象：AllowClientIpAddresses （字符串）;IsPrimary （布尔值）：PartnerServers （string）;EnablePerformanceCounters （布尔值）：PingInterval （整数）;端口（整数）;SslCertificatePath （string）;和 UseSsl （布尔值）。

示例

以下示例命令获取默认值。

Get-HisDrdaService

AllowClientIpAddresses    :
IsPrimary                 : True
PartnerServers            :
EnablePerformanceCounters : false
PingInterval              : 10000
Port                      : 446
SslCertificatePath        :
UseSsl                    : false

Set-DrdaSqlServerConnection

此 Set-DrdaSqlServerConnection cmdlet 为超出边界的 SQL Server 连接配置 DRDA 服务。

Syntax

Set-DrdaSqlServerConnection [-MappedAuthenticationDomain<string>] [-AuthenticationLookupTimeoutDuration<string>] [-AuthenticationLookupRetryCount<uint32>] [-SecurityTokenTimeoutDuration<string>] [-RollbackTransactionOnError ] [-ClientApplicationName<ClientApplicationName>] [-DefaultCollationName<string] [-ConnectionString <string>>] [-StoredProcedureCallTimeout<uint32>] [-HostInitiatedAffiliateApplication<string>] [-WindowsInitiatedAffiliateApplication<string>] [-EnableArithAbort ] [<CommonParameters>]

参数

AuthenticationLookupRetryCount 参数指示 DRDA 服务在失败之前尝试安全身份验证查找请求的次数。 此 可选 参数接受 整数 值。 默认值为 3 次重试

AuthenticationLookupTimeoutDuration 参数指示 DRDA 服务在失败之前等待安全身份验证查找请求的持续时间。 此 可选 参数接受表示 XML 持续时间值的 字符串 值。 默认值为 PT30S （时间段为 30 秒）。 持续时间值以 PnYnMnDTnHnMnS 的形式指定。 有关值的详细信息和说明，请参阅数据集成（部署）、DRDA 服务、配置 SQL Server 连接。

ClientApplicationName 参数指示 DRDA 服务如何设置 SQL 客户端应用程序名称连接属性。 此 可选 参数接受枚举字符串值。 默认值为 空。 指定 externalName 以指示 DRDA 服务使用表示 DRDA AR 客户端程序的名称的 DRDA 外部名称（EXTNAM）的字节 1-8。 指定 transactionIdentifier 以指示 DRDA 服务使用 EXTNAM 的字节 5-8，表示在 CICS for z/OS 中运行时 DRDA AR 客户端程序事务标识符的名称。

ConnectionString 参数定义 DRDA 服务在定义 sql Server 连接对象的Microsoft ADO.NET 框架数据提供程序时要使用的参数名称和值对列表。 此 必需 参数接受 字符串 值。 默认值为 Data Source=;集成安全性=True;MultipleActiveResultSets=True。 有关详细信息，请参阅数据集成（部署）、DRDA 服务、配置 SQL Server 连接。

DefaultCollationName 参数指示 DRDA 服务在将带有 ORDER BY 子句的 DB2 SELECT 语句转换为具有 ORDER BY 子句的 SQL Server SELECT 语句时添加 SQL Server COLLATE （collation_name） 子句。 此 可选 参数接受 字符串 值。 默认值 为SQL_Latin1_General_CP1_CI_AS。 有关值的详细信息和说明，请参阅数据集成（部署）、DRDA 服务、配置排序规则映射。

EnableArithAbort 参数指示 DRDA 服务在连接时发出 SET ARITHABORT 语句，以请求 SQL Server 在查询执行期间发生溢出或除零错误时终止查询。 此 可选 参数接受 布尔 值。 默认值为 false。

HostInitiatedAffiliateApplication 参数定义 DRDA 服务应与 Microsoft Enterprise Single Sign-On 一起使用的关联应用程序名称，以便当 SQL 客户端使用 Windows 身份验证时，将绑定的 DRDA AR 客户端凭据映射到 Windows Active Directory 域用户。 此 可选 参数接受 字符串 值。 默认值为 空字符串，指示 DRDA 服务不使用主机启动的 ESSO。 使用主机启动的 ESSO 时，必须在 SQL Server 连接字符串中指定 Integrated Security=true。

MappedAuthenticationDomain 参数指示 DRDA 服务，Microsoft Windows Active Directory 域将绑定的 DRDA 客户端凭据（用户名和密码）映射到使用集成安全支持提供程序接口（SSPI）为 Windows 身份验证配置的 SQL Server，但在使用Microsoft企业单一登录时不会。 此 可选 参数接受 字符串 值。 默认值为 空字符串。

RollbackTransactionOnError 参数指示 DRDA 服务在执行负 SQL Server 数据库错误后执行 ROLLBACK。 此 可选 参数接受 布尔 值。 默认值为 true。

SecurityTokenTimeout 参数指示 DRDA 服务在一段时间内保留安全令牌，之后获取新的 Windows 客户端标识符（CID）。 此 可选 参数接受 持续时间 值。 默认值为 PT8H （时间段为 8 小时）。 持续时间值以 PnYnMnDTnHnMnS 的形式指定。 有关值的详细信息和说明，请参阅数据集成（部署）、DRDA 服务、配置 SQL Server 连接。

WindowsInitiatedAffiliateApplication 参数定义 DRDA 服务应与 Microsoft Enterprise Single Sign-On 一起使用的关联应用程序名称，以便当 SQL 客户端使用 SQL Server 身份验证时，将 Windows Active Directory 域用户映射到绑定的 SQL 客户端凭据。 此 可选 参数接受 字符串 值。 默认值为 空字符串，指示 DRDA 服务不使用 Windows 发起的 ESSO。 使用 Windows 发起的 ESSO 时，必须在 SQL Server 连接字符串中指定 Integrated Security=false。

StoredProcedureCallTimeout 参数指示 DRDA 服务等待 SQL Server 处理 CALL 语句以执行存储过程的时间长度（以秒为单位），然后终止尝试并生成错误。 此 可选 参数接受 整数 值。 有效值大于或等于 0，小于或等于2147483647。 值为 0 表示没有限制（尝试执行命令将无限期等待）。 默认值为 30 秒。

示例

以下示例命令设置默认值。

注意

此示例或指南引用敏感信息，例如连接字符串或用户名和密码。 切勿在代码中硬编码这些值，并确保使用最安全的身份验证来保护机密数据。 有关详细信息，请参阅以下文档：

• BizTalk Server 中的安全性
• 发送和接收消息的安全性
• 访问控制和数据安全性

Set-HisDrdaSqlServerConnection -AuthenticationLookupRetryCount 3 -AuthenticationLookupTimeoutDuration PT30S -ClientApplicationName empty -ConnectionString "Data Source=localhost; Integrated Security=True; MultipleActiveResultSets=True" -DefaultCollationName SQL_Latin1_General_CP1_CI_AS -RollbackTransactionOnError -SecurityTokenTimeoutDuration PT8H -StoredProcedureCallTimeout 30

Get-DrdaSqlServerConnection

此 Get-DrdaSqlServerConnection cmdlet 获取绑定 SQL Server 连接的 DRDA 服务配置设置。

Syntax

Get-DrdaSqlServerConnection [<CommonParameters>]

参数

没有。

输出

此 Get-DrdaSqlServerConnection cmdlet 返回具有属性的对象：ArithAbort （布尔值）：AuthenticationLookupTimeout （string）;AuthenticationLookupRetryCount （整数）;ClientApplicationName （string）;ConnectionString （string）;DefaultCollationName （string）;HostInitiatedAffiliateApplication （string）;MappedAuthenticationDomain （string）;RollbackTransactionOnError （布尔值）：SecurityTokenTimeoutSeconds （字符串）;StoredProcedureCallTimeoutSeconds （整数）;和 WindowsInitiatedAffiliateApplication （string）。

示例

以下示例命令获取默认值。

Get-HisDrdaSqlServerConnection

ArithAbort                           :
AuthenticationLookupTimeout          : PT30S
AuthenticationLookupRetryCount       : 3
ClientApplicationName                :
ConnectionString                     : Data Source=localhost;Integrated Security=True;MultipleActiveResultSets=True
DefaultCollationName                 : SQL_Latin1_General_CP1_CI_AS
HostInitiatedAffiliateApplication    :
MappedAuthenticationDomain           :
RollbackTransactionOnError           : true
SecurityTokenTimeoutSeconds          : PT8H
StoredProcedureCallTimeoutSeconds    : 30
WindowsInitiatedAffiliateApplication :

Set-DrdaPackageBindProcessing

此 Set-DrdaPackageBindProcessing cmdlet 将 DRDA 服务配置为将 DRDA 静态 SQL 包处理到 SQL Server 存储过程中。

Syntax

Set-DrdaPackageBindProcessing [-CreatePackageProcedureWithCustomSqlScripts ] [-PackageProcedureSchemaList string] [-CreatePackageProcedure] [-CreatePackageXml ] [-PackageXmlFormat PackageXmlFormat<>] [-PackageXmlLocation <string] [-StoredProcedureNameSeparator <string>>] [-CreatePackageProcedureWithExtendedProperties] [<CommonParameters>]><

参数

CreatePackageProcedure 参数指示 DRDA 服务将单个 BGNBND 流处理到 SQL Server 存储过程中，将 DRDA BNDSQLSTT 定义的原始语句转换为相应的 SQL Server 语法。 此 可选 参数接受 布尔 值。 默认值为 true。

CreatePackageProcedureWithCustomSqlScripts 参数指示 DRDA 服务通过外部自定义包绑定侦听器组件处理 DRDA BGNBND 和 BNDSQLSTT。 此 可选 参数接受 布尔 值。 默认值为 false。

CreatePackageProcedureWithExtendedProperties 参数指示 DRDA 服务将 BGNBND 包绑定选项保留为 SQL Server 存储过程上的扩展属性。 此 可选 参数接受 布尔 值。 默认值是 false。

CreatePackageXml 参数指示 DRDA 服务将单个 BGNBND 流处理成静态 SQL for DB2 包 XML 文件，保留 DRDA BNDSQLSTT 流定义的原始绑定选项和语句。 此 可选 参数接受 布尔 值。 默认值是 false。

PackageProcedureSchemaList 指示 DRDA 服务在备用架构中查找目标 SQL Server 存储过程。 此 可选 参数接受 字符串 值。 默认值为 空字符串。 该字符串由逗号分隔的 SQL Server 架构名称组成。 packageProcedureSchemaList 参数类似于 IBM DB2 for z/OS CURRENT PACKAGESET 特殊寄存器和 SET CURRENT PACKAGESET 语句。

PackageXmlFormat 参数指示 DRDA 服务以 v90 或 v85 格式写入 DB2 XML 文件的静态 SQL。 此 可选 参数接受 v85 或 v90 的枚举 字符串 值。 默认值为 v90。

PackageXmlLocation 参数指示 DRDA 服务在何处写入 DB2 包 XML 文件的静态 SQL。 此 可选 参数接受 字符串 值。 默认值为 c：\temp。

StoredProcedureNameSeparator 参数指示 DRDA 服务将 DRDA 包名称映射到 SQL Server 存储过程名称时要使用的分隔符。 此 可选 参数接受 字符串 值。 默认值为单个 下划线 字符（_）。

示例

以下示例命令设置默认值。

Set-HisDrdaPackageBindProcessing -CreatePackageProcedure -PackageXmlFormat v90 -PackageXmlLocation c:\temp -StoredProcedureNameSeparator _

Get-HisDrdaPackageBindProcessing

此 Get-HisDrdaPackageBindProcessing cmdlet 获取 DRDA 服务配置设置，用于将 DRDA 静态 SQL 包处理到 SQL Server 存储过程中。

Syntax

Get-HisDrdaPackageBindProcessing [<CommonParameters>]

参数

没有。

输出

此 Get-HisDrdaPackageBindProcessing cmdlet 返回具有属性的对象：CreatePackageProcedure （布尔值）：CreatePackageXml （布尔值）：PackageXmlFormat （string）;PackageXmlLocation （string）;StoredProcedureNameSeparator （string）;CreatePackageProcedureWithExtendedProperties （布尔值）：CreatePackageProcedureWithCustomSqlScripts （布尔值）;和 PackageProcedureSchemaList （字符串）。

示例

以下示例命令获取默认值。

Get-HisDrdaPackageBindProcessing

CreatePackageProcedure                       : true
CreatePackageXml                             : false
PackageXmlFormat                             : v90
PackageXmlLocation                           : c:\temp
StoredProcedureNameSeparator                 : _
CreatePackageProcedureWithExtendedProperties : false
CreatePackageProcedureWithCustomSqlScripts   : false
PackageProcedureSchemaList                   :

Set-HisDrdaPackageProcedureCache

此 Set-HisDrdaPackageProcedureCache cmdlet 配置 DRDA 服务，以便缓存 SQL Server 存储过程的元数据，以便验证语句类型、游标类型、参数数据类型和其他属性。

Syntax

<Set-HisDrdaPackageProcedureCache -FlushTimeSpan 字符串> [<CommonParameters>]

参数

FlushTimeSpan 参数指示 DRDA 服务在指定的时间间隔后刷新包过程缓存。 此 可选 参数接受表示 XML 持续时间值的 字符串 值。 默认值为 P1D （时间段为 1 天）。 持续时间值以 PnYnMnDTnHnMnS 的形式指定。 有关值的详细信息和说明，请参阅数据集成（部署）、DRDA 服务、配置包绑定处理。

示例

以下示例命令设置默认值。

Set-HisDrdaPackageProcedureCache -FlushTimeSpan P1D

Get-HisDrdaPackageProcedureCache

此 Get-HisDrdaPackageProcedureCache cmdlet 获取用于缓存 SQL Server 存储过程元数据的 DRDA 服务配置设置，该存储过程用于验证语句类型、游标类型、参数数据类型和其他属性。

Syntax

Get-HisDrdaPackageProcedureCache [<CommonParameters>]

参数

没有。

输出

此 Get-HisDrdaPackageProcedureCache cmdlet 返回属性为 FlushTimeSpan（字符串）的对象。

示例

以下示例命令获取默认值。

Get-HisDrdaPackageProcedureCache

FlushTimeSpan
-------------
P1D

Set-HisDrdaSqlTransform

此 Set-DrdaSqlTransform cmdlet 将 DRDA 服务配置为使用基于 CLR 的内部或外部 SQL 转换将 DB2 函数语法转换为 SQL Server T-SQL 函数语法。

Syntax

Set-DrdaSqlTransform [-EnableUnicodeOutput] [-Type<SqlTransforms] [<CommonParameters>>]

参数

EnableUnicodeOutput 参数指示 DRDA 服务在 Unicode 或 ANSI 中对基于 CLR 的 SQL 转换器的输出进行编码。 此 可选 参数接受 布尔 值。 默认值为 false，指示 DRDA 服务输出 ANSI CHAR 和 VARCHAR 字符串。

Type 参数指示 DRDA 服务利用内部服务或基于 CLR 的外部 SQL 转换。 此可选参数接受服务或 Clr的类型值。 默认值为 Service。

示例

以下示例命令设置默认值。

Set-HisDrdaSqlTransform -Type Service

Get-HisDrdaSqlTransform

此 Get-HisDrdaSqlTransform cmdlet 获取 DRDA 服务配置设置，以使用基于 CLR 的内部或外部 SQL 转换将 DB2 函数语法转换为 SQL Server T-SQL 函数语法。

Syntax

Get-HisDrdaSqlTransforms [<CommonParameters>]

参数

没有。

输出

此 Get-HisDrdaSqlTransforms cmdlet 返回具有属性的对象：类型（SqlTransforms）;和 EnableUnicodeOutput （布尔值）。

示例

以下示例命令获取默认值。

Get-HisDrdaSqlTransform

Type
----
Service

EnableUnicodeOutput
-------------------
False

数据库别名映射

IBM DB2 和 Microsoft SQL Server 数据库对命名对象使用不同的术语，如下表所示，定义表的完全限定的三部分对象标识符。 DRDA 服务可以将 DB2 目录和架构名称映射到 SQL Server 目录和架构名称。 有关详细信息，请参阅配置数据库别名映射。

Add-HisDrdaDatabaseAlias

此 Add-HisDrdaDatabaseAlias cmdlet 将 DRDA 服务配置为将绑定目录和架构名称映射到出站目录和架构名称，以便在为映射到 SQL Server 存储过程的 DB2 命令执行静态 SQL 包时使用。

Syntax

Add-HisDrdaDatabaseAlias -SourceLocation<字符串> -SourceCollection<> 字符串 -TargetDatabase<字符串> -TargetSchema<字符串> [<CommonParameters>]

参数

SourceLocation 参数定义在映射到外绑定 SQL Server 数据库名称时 DRDA 服务应使用的绑定 DRDA RDBNAM（关系数据库名称）。 此 可选 参数接受 字符串 值。 默认值为 空字符串，表示任何值。

SourceCollection 参数定义一个绑定的 DRDA COLID （集合标识符），DRDA 服务在映射到外绑定 SQL Server 架构名称时应使用该标识符。 此 可选 参数接受 字符串 值。 默认值为 空字符串，表示任何值。

TargetDatabase 参数定义从绑定的 DRDA RDBNAM 值进行映射时 DRDA 服务应使用的外绑定 SQL Server 数据库名称。 此 可选 参数接受 字符串 值。 默认值为 空字符串，表示任何值。

TargetSchema 参数定义从绑定 DRDA COLID 值进行映射时 DRDA 服务应使用的外绑定 SQL Server 架构名称。 此 可选 参数接受 字符串 值。 默认值为 空字符串，表示任何值。

示例

以下示例命令添加示例值。

Add-HisDrdaDatabaseAlias -SourceCollection DSN8HC91 -SourceLocation CONTOSO -TargetDatabase ContosoRetailDW -TargetSchema DSN8910

Get-HisDrdaDatabaseAlias

此 Get-HisDrdaDatabaseAlias cmdlet 获取 DRDA 服务配置设置，用于将绑定目录和架构名称映射到出站目录和架构名称，以便在为映射到 SQL Server 存储过程的 DB2 命令执行静态 SQL 包时使用。

Syntax

Get-HisDrdaDatabaseAlias [<CommonParameters>]

参数

没有。

输出

此 Get-HisDrdaDatabaseAlias cmdlet 返回属性集合的对象：SourceLocation（字符串）;SourceCollection （string）;TargetDatabase （string）;和 TargetSchema （字符串）。

示例

以下示例命令获取示例值。

Get-HisDrdaDatabaseAlias

SourceLocation
--------------
CONTOSO

SourceCollection
----------------
DSN8HC91

TargetDatabase
--------------
ContosoRetailDW

TargetSchema
------------
DSN8910

DRDA 服务日期时间转换

DRDA 服务将在处理特定日期时间和字符数据类型的动态和静态 SQL 语句时，将源中的字符串文本日期时间值格式化为目标格式。

Add-DrdaDatetimeFormat

此 Add-DrdaDatetimeFormat cmdlet 配置 DRDA 服务，用于处理 DB2 和 SQL Server DATE、CHAR （10） 和 VARCHAR （10） 数据类型中的字符串文本日期值，以便从 DB2 日期格式转换为 SQL Server 日期格式，以及从 SQL Server 日期格式转换为 DB2 日期格式。 dateMask 包含一个或多个用于定义日期映射的 dateMask 元素。 dateMask 元素包含用于指示方向的 db2ToSql 或 sqlToDb2，以及用于指定映射的 sourceFormat 和 targetFormat。 有关值的详细信息和说明，请参阅数据集成（部署）、DRDA 服务、配置日期时间转换。

Syntax

<Add-DrdaDatetimeFormat -Conversion 转换> -DateFormat <DateFormats> [<CommonParameters>]

<Add-DrdaDatetimeFormat -Conversion 转换> -TimeFormat <TimeFormats> [<CommonParameters>]

<Add-DrdaDatetimeFormat -Conversion 转换> -DateTimeFormat <DateTimeFormats> [<CommonParameters>]

参数

转换参数定义 DB2 到 SQL 或 SQL 到 DB2 的方向。 此 必需 参数接受 枚举的转换 值。 指定 Db2toSql 以指示 DRDA 服务读取以转换绑定的 DateTime 格式。 指定 SqlToDb2 以指示 DRDA 服务写入以转换绑定的 DateTime 格式。

DateFormat 参数定义格式类型。 此必需参数接受枚举 的 DateFormat 值。

TimeFormat 参数定义格式类型。 此必需参数接受枚举 的 TimeFormat 值。

DateTimeFormat 参数定义格式类型。 此必需参数接受枚举 的 DateTimeFormat 值。

有关值的详细信息和说明，请参阅数据集成（部署）、DRDA 服务、配置日期时间转换。

示例

以下示例命令设置示例 Date 值。

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateFormat Usa

以下示例命令设置示例时间值。

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -TimeFormat HmsPeriod

以下示例命令设置示例 Date 值。

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTimeFormat IsoTimestampFormat

Get-HisDrdaDatetimeFormat

此 Get-HisDrdaDatetimeFormat cmdlet 获取 DRDA 服务配置设置，用于处理 DB2 和 SQL Server DATE、CHAR （10） 和 VARCHAR （10） 数据类型中的字符串文本日期值，以从 DB2 日期格式转换为 SQL Server 日期格式，以及从 SQL Server 日期格式转换为 DB2 日期格式。

Syntax

Get-HisDrdaDatetimeFormat -DateTime DateTime<> [<CommonParameters>]

参数

DateTime 参数指示 DRDA 服务返回配置的格式转换。 此 必需 参数接受 枚举的 DateTime 值。 没有 默认值 。 指定 Date 以指示 DRDA 服务返回配置的日期格式转换。 指定 时间 以指示 DRDA 服务返回配置的时间格式转换。 指定 DateTime 以指示 DRDA 服务返回配置的 DateTime 格式转换。

输出

此 Get-HisDrdaDatetimeFormat cmdlet 返回属性集合的对象：Db2ToSql（字符串）;和 SqlToDb2 （string）。

示例

以下示例命令获取默认的 Date 值。

Get-HisDrdaDatetimeFormat -DateTime Date

Db2ToSql
--------
Iso

SqlToDb2
--------
Iso

以下示例命令获取默认的 Time 值。

Get-HisDrdaDatetimeFormat -DateTime Date

Db2ToSql
--------
HmsColong
HmsPeriod

SqlToDb2
--------
HmsColon

以下示例命令获取默认的 DateTime 值。

Get-HisDrdaDatetimeFormat -DateTime Date

Db2ToSql
--------
Db2TimestampFormat

SqlToDb2
--------
Db2TimestampFormat

Remove-HisDrdaDatetimeFormat

此 Remove-HisDrdaDatetimeFormat cmdlet 删除一个或多个 DRDA 服务配置设置，用于处理 DB2 和 SQL Server DATE、CHAR （10） 和 VARCHAR （10） 数据类型中的字符串文本日期值，以便从 DB2 日期格式转换为 SQL Server 日期格式，以及从 SQL Server 日期格式转换为 DB2 日期格式。

Syntax

Remove-HisDrdaDatetimeFormat -DateTime DateTime<> -Conversion Conversion<> -Format<string> [<CommonParameters>]

参数

DateTime 参数指示 DRDA 服务删除配置的格式转换。 此 必需 参数接受 枚举的 DateTime 值。 没有 默认值 。 指定 Date 以指示 DRDA 服务删除配置的日期格式转换。 指定 时间 以指示 DRDA 服务删除配置的时间格式转换。 指定 DateTime 以指示 DRDA 服务删除配置的 DateTime 格式转换。

转换参数定义 DB2 到 SQL 或 SQL 到 DB2 的方向。 此 必需 参数接受 枚举的转换 值。 指定 Db2toSql 以指示 DRDA 服务读取以转换绑定的 DateTime 格式。 指定 SqlToDb2 以指示 DRDA 服务写入以转换绑定的 DateTime 格式。

Format 参数定义格式类型。 此必需参数接受枚举的 DateFormat、 TimeFormat 或 DateTimeFormat 值。

示例

以下示例命令删除示例 Date 值。

Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Date -Format Usa

以下示例命令设置示例时间值。

Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Time -Format HmsPeriod

以下示例命令设置示例 Date 值。

Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime DateTime -Format IsoTimestampFormat

DRDA 服务编码

DRDA 服务使用基础 HIS 编码器组件和 Windows 国家语言支持 （NLS） 系统组件映射代码页并支持自定义代码页转换。 使用 Microsoft Windows 更新，可以安装包括 Windows NLS 代码页转换库的其他 Windows 语言包。 （可选）HIS 编码器可以根据在 MsDrdaService.exe.config 文件的 codePages 部分定义的 codePage 元素加载自定义 NLS 代码页。 HIS 编码器可以根据在 MsDrdaService.exe.config 文件的 codePages 部分中定义的 ebcdicToUnicodeConversion 元素，在标准 NLS 和自定义 NLS 代码页中自定义映射代码点。 有关值的详细信息和说明，请参阅“配置服务编码”。

Add-HisCustomCodePage

此 Add-HisCustomCodePage cmdlet 配置 DRDA 服务，以指示 HIS Encoder 组件加载自定义 Windows 国家/地区语言支持（NLS）系统代码页转换文件。

Syntax

Add-HisCustomCodePage -CodePage<uint32> -Name<string> -NlsCodePage<uint32> [-Description<string>] [<CommonParameters>]

参数

CodePage 参数指示 HIS 编码器加载编号的自定义 NLS 代码页文件。 此 必需 参数接受 整数。 默认值为 0。

Name 参数命名 HIS 编码器应根据定义的自定义 NLS 代码页码页码加载的自定义 NLS 代码页。 此 必需 参数接受 字符串。 默认值为 空字符串。

NlsCodePage 参数定义 HIS 编码器应替换为自定义代码页码的标准 NLS 代码页码。 此 必需 参数接受 整数。 默认值为 0。

Description 参数描述 HIS 编码器应根据定义的自定义 NLS 代码页码页码加载的自定义 NLS 代码页。 此 可选 参数接受 字符串。 默认值为 空字符串。

示例

以下示例命令设置示例值。

Add-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140 -Description "Custom codepage based on 1140"

Get-HisCustomCodePage

此 Get-HisCustomCodePage cmdlet 获取 DRDA 服务配置设置，用于指示 HIS 编码器组件加载自定义 Windows 国家/地区语言支持（NLS）系统代码页转换文件。

Syntax

Get-HisCustomCodePage [-CodePage<uint32>] [-Name<string>] [-NlsCodePage<uint32>] [<CommonParameters>]

参数

CodePage 参数指示 DRDA 服务使用此编号的自定义 NLS 代码页文件获取配置设置。 此 可选 参数接受 整数。 默认值为 0。

Name 参数指示 DRDA 服务使用此自定义 NLS 代码页名称获取配置设置。 此 可选 参数接受 字符串。 默认值为 空字符串。

NlsCodePage 参数指示 DRDA 服务使用此自定义代码页码获取配置设置。 此 可选 参数接受 整数。 默认值为 0。

输出

此 Get-HisCustomCodePage cmdlet 返回一个具有属性的对象：名称（字符串）;CodePage （整数）;NlsCodePage （整数）;和说明（字符串）。

示例

以下示例命令获取示例值。

Get-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140

Name
----
Custom21140

CodePage
--------
21140

Description
-----------
Custom code based on 1140

NlsCodePage
1140

Remove-HisCustomCodePage

此 Remove-HisCustomCodePage cmdlet 删除 DRDA 服务配置设置，以指示 HIS 编码器组件加载自定义 Windows 国家/地区语言支持（NLS）系统代码页转换文件。

Syntax

Remove-HisCustomCodePage [-Name] <字符串> [<CommonParameters>]

参数

Name 参数指示 DRDA 服务使用自定义 NLS 代码页名称删除配置设置。 此 必需 参数接受 字符串。 默认值为 空字符串。

示例

以下示例命令删除示例值。

Remove-HisCustomCodePage -Name Custom21140

Add-HisCustomConversion

此 Add-HisCustomConversion cmdlet 将 DRDA 服务配置为覆盖标准 NLS 和自定义 NLS 代码页中的代码点映射。

Syntax

Add-HisCustomConversion -CodePage<uint32> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]

Add-HisCustomConversion -Name<string> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]

参数

CodePage 参数指示 DRDA 服务使用此编号的 NLS 代码页文件添加配置设置。 此 必需 参数接受 整数。 默认值为 0。

Name 参数指示 DRDA 服务使用此自定义 NLS 代码页名称文件添加配置设置。 此 必需 参数接受 字符串。 默认值为 空字符串。

EbcdicToUnicode 参数指示 HIS 编码器从指定的 EBCDIC 代码点转换。 此可选参数接受 字符串 值，采用“To=From”的形式，其中“To”是 EBCDIC 十六进制代码点值，“From”是 Unicode 十六进制代码点值。 默认值为 空字符串。

UnicodeToEbcdic 参数指示 HIS 编码器从指定的 Unicode 码位转换。 此可选参数接受 字符串 值，格式为“To=From”，其中“To”是 Unicode 十六进制代码点值，“From”是 EBCDIC 十六进制代码点值。 默认值为 空字符串。

Get-HisCustomConversion

此 Get-HisCustomConversion cmdlet 获取用于在标准 NLS 和自定义 NLS 代码页中重写代码点映射的 DRDA 服务配置设置。

Syntax

Get-HisCustomConversion -Type<ConversionType> {EbcdicToUnicode |UnicodeToEbcdic} -CodePage <uint32> [<CommonParameters>]

Get-HisCustomConversion -Type<ConversionType> {EbcdicToUnicode |UnicodeToEbcdic} -Name <字符串> [<CommonParameters>]

参数

CodePage 参数指示 DRDA 服务使用此编号的 NLS 代码页文件获取配置设置。 此 必需 参数接受 整数。 默认值为 0。

Name 参数指示 DRDA 服务使用此自定义 NLS 代码页名称文件获取配置设置。 此 必需 参数接受 字符串。 默认值为 空字符串。

Type 参数指示 DRDA 服务使用此编号的 NLS 代码页文件或自定义 NLS 代码页名称文件获取配置设置。 此 必需 参数接受 EbcdicToUnicode 或 UnicodeToEbcdic 的枚举值。

输出

此 Get-HisCustomConversion cmdlet 返回具有属性的对象：From （十六进制）;和 To （十六进制）。

Remove-HisCustomConversion

此 Remove-HisCustomConversion cmdlet 删除用于在标准 NLS 和自定义 NLS 代码页中重写代码点映射的 DRDA 服务配置设置。

Syntax

Remove-HisCustomConversion -CodePage<uint32> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]

Remove-HisCustomConversion -Name<string> [-EbcdicToUnicode<string[]>] [-UnicodeToEbcdic<string[]>] [<CommonParameters>]

参数

CodePage 参数指示 DRDA 服务使用此编号的 NLS 代码页文件获取配置设置。 此 必需 参数接受 整数。 默认值为 0。

Name 参数指示 DRDA 服务使用此自定义 NLS 代码页名称文件获取配置设置。 此 必需 参数接受 字符串。 默认值为 空字符串。

EbcdicToUnicode 参数指示 HIS 编码器从指定的 EBCDIC 代码点转换。 此可选参数接受 字符串 值。 默认值为 空字符串。

UnicodeToEbcdic 参数指示 HIS 编码器从指定的 Unicode 码位转换。 此可选参数接受 字符串 值。 默认值为 空字符串。

DRDA 服务应用程序编码

DRDA 服务使用基础 HIS 编码器组件和 Windows 国家语言支持 （NLS） 系统组件转换基本代码页和映射代码点。 applicationEncodings 元素包含 applicationEncoding 元素，用于为每个数据库指定默认应用程序级编码方案。 有关值的详细信息和说明，请参阅“配置应用程序编码”。

Add-HisDrdaApplicationEncoding

此 Add-HisDrdaApplicationEncoding cmdlet 为每个数据库配置默认应用程序级编码方案的 DRDA 服务，供 HIS 编码器组件和 Windows 国家语言支持 （NLS） 系统组件在代码页中的映射代码点中使用。 有关值的详细信息和说明，请参阅“配置应用程序编码”了解详细信息。

Syntax

Add-HisDrdaApplicationEncoding -Ccsid<uint32> -Database<string [-Scheme<string>>] [<CommonParameters>]

Add-HisDrdaApplicationEncoding -Database<string> -CustomCcsid<uint32> [-Scheme<string>] [<CommonParameters>]

参数

Ccsid 参数指示 DRDA 服务使用替代 CCSID（编码字符集标识符）而不是 DRDA AR 客户端请求的 CCSID 对输出参数和结果集值进行编码。 此 必需 参数接受 整数。 默认值为 1208。

CustomCcsid 参数指示 DRDA 服务使用替代自定义 CCSID（编码字符集标识符）对输出参数和结果集值进行编码，而不是 DRDA AR 客户端请求的 CCSID。 此 必需 参数接受 整数。 默认值为 -1。

数据库参数指示 DRDA 服务仅使用替代编码方案（而不是 DRDA AR 客户端请求的编码方案）对输出参数和结果集值进行编码。 此 必需 参数接受 字符串 值。 默认值为 空字符串。

Scheme 参数指示 DRDA 服务使用替代编码方案对输出参数和结果集值进行编码，而不是 DRDA AR 客户端请求的编码方案。 此 可选 参数接受 字符串 值。 支持的值为 Ebcdic、Unicode 和 Ansi。 默认值为 Unicode。

示例

以下示例命令设置示例值。

Add-HisDrdaApplicationEncoding -Ccsid 1140 -Database NWIND1 -Scheme Ebcdic

以下示例命令设置默认值。

Add-HisDrdaApplicationEncoding -CustomCcsid 1234 -Database NWIND1 -Scheme Ebcdic

Get-HisDrdaApplicationEncoding

此 Get-HisDrdaApplicationEncoding cmdlet 根据每个数据库获取默认应用程序级编码方案的 DRDA 服务配置设置，供 HIS 编码器组件和 Windows 国家/地区语言支持 （NLS） 系统组件在映射代码页中的代码点中使用。

Syntax

Get-HisDrdaApplicationEncoding [-Ccsid<uint32>] [-Database<string>] [-CustomCcsid<uint32>] [<CommonParameters>]

参数

Ccsid 参数指示 DRDA 服务使用替代 CCSID（编码字符集标识符）获取应用程序编码配置。 此 可选 参数接受 整数。 默认值为 1208。

CustomCcsid 参数指示 DRDA 服务使用自定义 CCSID（编码字符集标识符）获取应用程序编码配置。 此 可选 参数接受 整数。 默认值为 -1。

数据库参数指示 DRDA 服务使用指定的目标 SQL Server 数据库名称获取应用程序编码配置。 此 可选 参数接受 字符串 值。 默认值为 空字符串。

输出

此 Get-HisDrdaApplicationEncoding cmdlet 返回具有属性的对象：Scheme（字符串）;Ccsid （整数）;数据库（字符串）;和 CustomCcsid （整数）。

示例

以下示例命令获取示例值。

Get-HisDrdaApplicationEncoding

Scheme
------
Ebcdic
Ebcdic

Ccsid
-----
1140

Database
--------
NWIND1
NWIND1

Customccsid
-----------

1234

Remove-HisDrdaApplicationEncoding

此 Remove-HisDrdaApplicationEncoding cmdlet 会根据每个数据库删除默认应用程序级编码方案的 DRDA 服务配置设置，供 HIS 编码器组件和 Windows 国家/地区语言支持 （NLS） 系统组件在映射代码页中的代码点中使用。

Syntax

Remove-HisDrdaApplicationEncoding -Ccsid<string[]> [-Database<string>] [<CommonParameters>]

Remove-HisDrdaApplicationEncoding -CustomCcsid<string[]> [-Database<string>] [<CommonParameters>]

参数

Ccsid 参数指示 DRDA 服务使用替代 CCSID（编码字符集标识符）删除应用程序编码配置。 此 可选 参数接受 整数。 默认值为 1208。

CustomCcsid 参数指示 DRDA 服务使用自定义 CCSID（编码字符集标识符）删除应用程序编码配置。 此 可选 参数接受 整数。 默认值为 -1。

数据库参数指示 DRDA 服务使用指定的目标 SQL Server 数据库名称删除应用程序编码配置。 此 可选 参数接受 字符串 值。 默认值为 空字符串。

示例

以下示例命令删除示例值。

Remove-HisDrdaApplicationEncoding -Ccsid 1140

以下示例命令删除示例值。

Remove-HisDrdaApplicationEncoding -CustomCcsid 1234

DRDA 服务排序规则映射

DRDA 服务映射排序规则语法，以提供查询结果的跨平台兼容性。 有关值的详细信息和说明，请参阅数据集成（部署）、DRDA 服务、配置排序规则映射。

Add-HisDrdaCollationName

此 Add-HisDrdaCollationName cmdlet 将 DRDA 服务配置为将 SELECT 语句从 DB2 ORDER BY COLLATION_KEY（排序规则名称）语法转换为 SQL Server T-SQL ORDER BY COLLATE （collation_name） 语法，从 DB2 排序规则名称值映射到 SQL Server collation_name值，以提供更兼容的查询结果。 有关值的详细信息和说明，请参阅数据集成（部署）、DRDA 服务、配置排序规则映射。

Syntax

<Add-HisDrdaCollationName -To 字符串> -From <字符串> [<CommonParameters>]

参数

To 参数指示 DRDA 服务 SQL 转换器转换为 SQL Server SELECT ORDER BY COLLATE 子句中的指定collation_name字符串。 此 必需 参数接受 字符串 值。 没有默认值。

From 参数指示 DRDA 服务 SQL 转换器从 DB2 SELECT ORDER BY COLLATION_KEY 子句中的指定排序规则名称字符串转换。 此 必需 参数接受 字符串 值。 没有默认值。

示例

以下示例命令设置示例值。

Add-HisDrdaCollationName -From UCA400R1_LEN_AN -To SQL_EBCDIC037_CP1_CS_AS

Get-HisDrdaCollationName

此 Get-HisDrdaCollationName cmdlet 获取 DRDA 服务配置设置，用于将 SELECT 语句从 DB2 ORDER BY COLLATION_KEY （排序规则名称） 语法转换为 SQL Server T-SQL ORDER BY COLLATE （collation_name） 语法，从 DB2 排序规则名称值映射到 SQL Server collation_name 值，以提供更兼容的查询结果。

Syntax

Get-HisDrdaCollationName [-To<string>] [-From<string>] [<CommonParameters>]

参数

To 参数指示 DRDA 服务使用指定的collation_name字符串获取排序规则名称配置。 此 必需 参数接受 字符串 值。 没有默认值。

From 参数指示 DRDA 服务使用 DB2 SELECT ORDER BY COLLATION_KEY 子句中的指定排序规则名称字符串获取排序规则名称配置。 此 必需 参数接受 字符串 值。 没有默认值。

输出

此 Get-HisDrdaCollationName cmdlet 返回具有属性的对象：To （string）;和 From （字符串）。

示例

以下示例命令设置默认值。

Get-HisDrdaCollationName

To
--
SQL_EBCDIC037_CP1_CS_AS

From
----
UCA400R1_LEN_AN

Remove-HisDrdaCollationName

此 Remove-HisDrdaCollationName cmdlet 根据默认 ORDER BY 排序规则名称删除 DRDA 服务配置设置，以将 COLLATE 子句添加到 ORDER BY 子句。

Syntax

Remove-HisDrdaCollationName -RemoveAll<bool> [-To<string>] [-From<string>] [<CommonParameters>]

参数

To 参数指示 DRDA 服务使用指定的collation_name字符串删除排序规则名称配置。 此 必需 参数接受 字符串 值。 没有默认值。

From 参数指示 DRDA 服务使用 DB2 SELECT ORDER BY COLLATION_KEY 子句中的指定排序规则名称字符串删除排序规则名称配置。 此 必需 参数接受 字符串 值。 没有默认值。

示例

以下示例命令删除示例值。

Remove-HisDrdaCollationName -From UCA400R1_LEN_AN

配置跟踪侦听器

DRDA 服务支持多个并发跟踪侦听器，包括：文本跟踪侦听器、控制台跟踪侦听器、自定义跟踪侦听器和 Windows 事件跟踪（ETW）跟踪侦听器。 有关值的详细信息和说明，请参阅数据集成（部署）、DRDA 服务、配置跟踪侦听器。

Set-HisDrdaConsoleTraceListener

Set-HisDrdaConsoleTraceListener cmdlet 将 DRDA 服务控制台跟踪侦听器配置为将跟踪数据写入命令控制台窗口。

Syntax

<Set-HisDrdaConsoleTraceListener -Level uint32> [<CommonParameters>]

参数

Level 参数指示 DRDA 服务跟踪定义的信息集合，从最小到最大跟踪级别。 此 必需 参数接受 整数 值。 默认值为 0。

价值	说明
0	输出无跟踪消息。
1	输出错误消息。
2	输出警告消息和错误消息。
3	输出信息消息、警告消息和错误消息。
4	输出所有消息。

Table AUTONUM \\ Arabic 跟踪级别。*

示例

以下示例命令设置示例值。

Set-HisDrdaConsoleTraceListener -Level 3

Set-HisDrdaEtwTraceListener

Set-HisDrdaEtwTraceListener cmdlet 将 DRDA 服务 ETW（Windows 事件跟踪）配置为 ETW 提供程序，以便通过 ETW 会话将跟踪数据输出到 Windows 操作系统 ETW 控制器。

Syntax

<Set-HisDrdaEtwTraceListener -Level uint32> [<CommonParameters>]

参数

Level 参数指示 DRDA 服务跟踪定义的信息集合，从最小到最大跟踪级别。 此 必需 参数接受 整数 值。 默认值为 0。

价值	说明
0	输出无跟踪消息。
1	输出错误消息。
2	输出警告消息和错误消息。
3	输出信息消息、警告消息和错误消息。
4	输出所有消息。

Table AUTONUM \\ Arabic 跟踪级别。*

示例

以下示例命令设置示例值。

Set-HisDrdaEtwTraceListener -Level 3

Set-HisDrdaEventLogTraceListener

Set-HisDrdaEventLogTraceListener cmdlet 配置 DRDA 服务事件日志侦听器将日志数据输出到 Windows 事件日志。

Syntax

<Set-HisDrdaEventLogTraceListener -InitializeData 字符串> [<CommonParameters>]

参数

InitializeData 参数指示 DRDA 服务记录定义的信息集合。 此 必需 参数接受 字符串 值。 默认值为“Error，Warning，Information”，其中包括所有事件日志级别。

价值	说明
Error	此值指示 DRDA 服务仅记录错误级别数据。
警告	此值指示 DRDA 服务仅记录警告级别数据。
信息	此值指示 DRDA 服务仅记录信息级别数据

Table AUTONUM \\ Arabic 事件日志级别。*

示例

以下示例命令设置示例值。

Set-HisDrdaEventLogTraceListener -InitializeData Warning

Set-HisDrdaTextTraceListener

Set-HisDrdaTextTraceListener cmdlet 配置 DRDA 服务文本跟踪侦听器，以文本格式将跟踪数据写入磁盘文件。

Syntax

Set-HisDrdaTextTraceListener -Level uint32> [-InitializeData <string>] [-AutoFlush <bool>] [-MaxTraceEntryCount uint32>] [-MaxTraceFileCount <<uint32>] [<CommonParameters>]<

参数

Level 参数指示 DRDA 服务跟踪定义的信息集合，从最小到最大跟踪级别。 此 必需 参数接受 整数 值。 默认值为 0。

价值	说明
0	输出无跟踪消息。
1	输出错误消息。
2	输出警告消息和错误消息。
3	输出信息消息、警告消息和错误消息。
4	输出所有消息。

表 x. 跟踪级别。

AutoFlush 参数指示 DRDA 服务自动将数据刷新到跟踪侦听器。 此 必需 参数接受 布尔 值。 默认值为 false。

注释

DRDA 服务可以自动将跟踪数据刷新到跟踪侦听器，这可以确保捕获跟踪数据，但会增加磁盘 I/O 并降低整体系统性能。 若要提高性能，请将 AutoFlush=$False 设置为禁用自动跟踪刷新。

MaxTraceEntryCount 参数指示 DRDA 服务跟踪最大条目数，然后停止跟踪。 此 必需 参数接受 整数。 默认值为 1000000。

MaxTraceFileCount 参数指示 DRDA 服务编写文本侦听器跟踪输出的最大单个跟踪文件数，然后覆盖现有的跟踪文件。 此 必需 参数接受 整数。 默认值为“10”。

示例

以下示例命令设置示例值。

Set-HisDrdaTextTraceListener -Level 3 -AutoFlush $True -InitializeData MsDrdaService.DSTF -MaxTraceEntryCount 1000000 -MaxTraceFileCount 10

Start-HisDrdaTraceListener

此 Start-HisDrdaTraceListener cmdlet 指示 DRDA 服务启动指定的跟踪侦听器类型。

Syntax

Start-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]

参数

侦听器参数指示 DRDA 服务启动指定的跟踪侦听器类型。 此参数接受控制台、文本、Etw 或 EventLog 的侦听器值。 没有默认值。

示例

以下示例命令设置示例值。

Start-HisDrdaTraceListener -Listener Console

以下示例命令设置示例值。

Start-HisDrdaTraceListener -Listener Text

以下示例命令设置示例值。

Start-HisDrdaTraceListener -Listener Etw

以下示例命令设置示例值。

Start-HisDrdaTraceListener -Listener EventLog

Get-HisDrdaTraceListener

此 Get-DrdaTextTraceListener cmdlet 获取文本跟踪侦听器的 DRDA 服务配置设置，以文本格式将跟踪数据写入磁盘文件。

Syntax

Get-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]

参数

侦听器参数指示 DRDA 服务获取指定跟踪侦听器类型的配置。 此参数接受控制台、文本、Etw 或 EventLog 的侦听器值。 没有默认值。

输出

此 Get-HisDrdaTraceListener cmdlet 返回属性集合。

示例

以下示例命令获取示例值。

Get-HisDrdaTraceListener -Listener Console

Status
------
Enabled

Level
-----
3

以下示例命令获取示例值。

Get-HisDrdaTraceListener -Listener Text

InitializeData  : MsDrdaService.DSTF
AutoFlush       : True
MaxTraceEntries : 1000000
MaxTraceFiles   : 10
Status          : Enabled
Level           : 3

以下示例命令获取示例值。

Get-HisDrdaTraceListener -Listener Etw

Status
------
Enabled

Level
-----
3

以下示例命令获取示例值。

Get-HisDrdaTraceListener -Listener Console

InitializeData
--------------
Warning

Status
------
Enabled

Stop-HisDrdaTraceListener

此 Stop-HisDrdaTraceListener cmdlet 指示 DRDA 服务停止指定的跟踪侦听器类型。

Syntax

Stop-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]

参数

侦听器参数指示 DRDA 服务获取指定跟踪侦听器类型的配置。 此参数接受控制台、文本、Etw 或 EventLog 的侦听器值。 没有默认值。

示例

以下示例命令设置示例值。

Get-HisDrdaTraceListener -Listener Console

以下示例命令设置示例值。

Get-HisDrdaTraceListener -Listener Text

以下示例命令设置示例值。

Get-HisDrdaTraceListener -Listener Etw

以下示例命令设置示例值。

Get-HisDrdaTraceListener -Listener EventLog

DRDA 服务包绑定侦听器

DRDA 服务以 .NET Framework 自定义侦听器的形式支持自定义包绑定器。

Add-HisDrdaPackageBindListener

此 Add-HisDrdaPackageBindListener cmdlet 添加了 DRDA 服务配置，用于将绑定包与绑定 SQL 语句输出一起发送到可选的自定义绑定侦听器。

Syntax

Add-HisDrdaPackageBindListener -TypeName<字符串> [-ThrowWhenNoCallback ] [<CommonParameters>]

参数

TypeName 参数定义 DRDA 服务自定义绑定侦听器的类型。 此 必需 参数接受 字符串。 没有默认值。 自定义包绑定侦听器示例的类型值为“CustomListeners.MyPackageBindListener， CustomListeners， Version=1.0.0.0， Culture=neutral， PublicKeyToken=34013cf74da51d17， processorArchitecture=MSIL”。

ThrowWhenNoCallback 参数指示 DRDA 服务在自定义绑定侦听器组件不返回回调接口上的任何信息时，将 BGNBNDRM （开始绑定回复消息）返回到 DRDA AR 客户端。 此 可选 参数接受 布尔 值。 默认值为 true。

示例

以下示例命令添加示例值。

Add-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener -ThrowWhenNoCallback

Get-HisDrdaPackageBindListener

此 Get-HisDrdaPackageBindListener cmdlet 获取 DRDA 服务配置设置，用于将绑定包与绑定 SQL 语句输出一起发送到可选的自定义绑定侦听器。

Syntax

Get-HisDrdaPackageBindListener [-Type<string>] [<CommonParameters>]

参数

Type 参数定义 DRDA 服务自定义绑定侦听器的类型。 此 必需 参数接受 字符串。 没有默认值。 自定义包绑定侦听器示例的类型值为“CustomListeners.MyPackageBindListener， CustomListeners， Version=1.0.0.0， Culture=neutral， PublicKeyToken=34013cf74da51d17， processorArchitecture=MSIL”。

示例

以下示例命令获取示例值。

Get-HisDrdaPackageBindListener
PackageBindListener:
type=CustomListeners.MyPackageBindListener
errorWhenNoCallback=True

Remove-HisDrdaPackageBindListener

此 Remove-HisDrdaPackageBindListener cmdlet 删除 DRDA 服务配置设置以添加自定义跟踪侦听器。

Syntax

Remove-HisDrdaPackageBindListener -TypeName<字符串> [<CommonParameters>]

参数

Type 参数定义 DRDA 服务自定义绑定侦听器的类型。 此 必需 参数接受 字符串。 没有默认值。 自定义包绑定侦听器示例的类型值为“CustomListeners.MyPackageBindListener， CustomListeners， Version=1.0.0.0， Culture=neutral， PublicKeyToken=34013cf74da51d17， processorArchitecture=MSIL”。

示例

以下示例命令删除示例值。

Remove-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener