PowerShell 模块
Windows PowerShell® 是基于任务的命令行管理程序和脚本语言，专为进行系统管理而设计。 在 .NET Framework 的基础上构建的 Windows PowerShell 可帮助 IT 专业人士和高级用户控制和自动执行 Windows 操作系统以及在 Windows 上运行的应用程序的管理。 DRDA 服务提供 PowerShell 命令作为常见 HIS 2013 PowerShell 模块 Microsoft.HostIntegration.PowerShell 的一部分，包括许多用于添加/获取/删除/设置 MsDrdaService.exe.config 元素和属性的 Cmdlet 命令，以及用于启动/停止侦听器的命令。
PowerShell Cmdlet
PowerShell cmdlet 是在Windows PowerShell环境中使用的轻量级命令。 Windows PowerShell运行时在命令行提供的自动化脚本上下文中调用这些 cmdlet。 Windows PowerShell运行时还通过Windows PowerShell API 以编程方式调用它们。
用于定义用户或运行 cmdlet 的应用程序可用的参数的公共属性。 Cmdlet 可以具有 required、named、positional 和 switch 参数。 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)
启动 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 手动设置模块路径。
在Windows PowerShell或 PowerShell ISE 命令提示符下，键入以下命令，然后单击 Enter。
Import-Module "C:\Program Files\Microsoft Host Integration Server 2013\system\Microsoft.HostIntegration.PowerShell"键入以下 Get-Module 命令 ，并单击 Enter。
Get-Module Microsoft.HostIntegration.PowerShell验证以下信息。
ModuleType Version Name ExportedCommands ---------- ------- ---- ---------------- Binary 9.0.1000.0 Microsoft.HostIntegration.PowerS... {Add-HisDrdaApplicationEncoding, Remove-HisDrdaApplicationEncoding, Get-HisDrdaApplicationEncoding, Add-HisDrdaCollationName...}
获取模块命令
在Windows PowerShell或 PowerShell ISE 命令提示符处，键入以下命令，然后单击 Enter。
Get-Command -Module Microsoft.HostIntegration.PowerShell验证以下信息。
DRDA 服务命令
以下 Microsoft.HostIntegration.PowerShell cmdlet 命令与 DRDA 服务一起使用。
| CommandType | 名称 | 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 服务。
语法
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 Server 属性) 、ACCSEC (Access Security) 和 ACCRDB (Access 关系数据库) 来响应所有 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 参数指示 DRDA 服务监视伙伴服务器计算机的运行状况的频率，方法是执行 EXCSAT (Exchange Server 属性) 流并检查 EXCSATRD (EXCSAT 回复数据) 。 此 可选 参数接受 整数 值。 默认值为 10000 毫秒 (10 秒) 。
Port 参数定义 TCP/IP 端口号，DRDA 服务必须侦听入站 DRDA 应用程序请求程序客户端连接请求。 此 可选 参数接受 整数 值。 默认值为 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 服务配置设置。
语法
Get-HisDrdaService [<CommonParameters>]
参数
无。
输出
此 Get-HisDrdaService cmdlet 返回一个属性为：AllowClientIpAddresses (字符串) ;IsPrimary (布尔) ;PartnerServers (字符串) ;EnablePerformanceCounters (布尔) ;PingInterval (整数) ;端口 (整数) ;SslCertificatePath (字符串) ;和 UseSsl (布尔) 。
示例
以下示例命令获取默认值。
Get-HisDrdaService
AllowClientIpAddresses :
IsPrimary : True
PartnerServers :
EnablePerformanceCounters : false
PingInterval : 10000
Port : 446
SslCertificatePath :
UseSsl : false
Set-DrdaSqlServerConnection
此 Set-DrdaSqlServerConnection cmdlet 为外接SQL Server连接配置 DRDA 服务。
语法
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 服务在 z/OS 的 CICS 中运行时使用 EXTNAM 的第 5-8 个字节，表示 DRDA AR 客户端程序的事务标识符的名称。
ConnectionString 参数定义参数名称和值对的列表，供 DRDA 服务在定义 Microsoft ADO.NET Framework Data Provider for SQL Server 连接对象时使用。 此 必需 参数接受 字符串 值。 默认值为 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 参数定义关联应用程序名称，当 SQL 客户端使用 Windows 身份验证时，DRDA 服务应与 Microsoft Enterprise Single Sign-On 一起使用，以将绑定的 DRDA AR 客户端凭据映射到 Windows Active Directory 域用户。 此 可选 参数接受 字符串 值。 默认值为 空字符串，指示 DRDA 服务不使用主机启动的 ESSO。 使用主机启动的 ESSO 时，必须在SQL Server 连接字符串中指定 Integrated Security=true。
MappedAuthenticationDomain 参数指示 DRDA 服务在连接到使用集成安全支持提供程序接口 (SSPI) 为Windows 身份验证配置的SQL Server时， (用户名和密码) 将绑定 DRDA 客户端凭据映射到哪个 Microsoft Windows Active Directory 域，但在使用 Microsoft Enterprise 单一登录时则不映射。 此 可选 参数接受 字符串 值。 默认值为空字符串。
RollbackTransactionOnError 参数指示 DRDA 服务在出现负SQL Server数据库错误后执行 ROLLBACK。 此 可选 参数接受 布尔 值。 默认值为 true。
SecurityTokenTimeout 参数指示 DRDA 服务将安全令牌保留一段时间，之后获取新的 Windows 客户端标识符 (CID) 。 此 可选 参数接受 持续时间 值。 默认值为 PT8H ， (时间段为 8 小时) 。 持续时间值以 PnYnMnDTnHnMnS 格式指定。 有关值的详细信息和说明，请参阅 数据集成 (部署) 、DRDA 服务、配置SQL Server连接。
WindowsInitiatedAffiliateApplication 参数定义关联应用程序名称，当 SQL 客户端使用 SQL Server 身份验证时，DRDA 服务应与 Microsoft Enterprise Single Sign-On 一起使用，以便将 Windows Active Directory 域用户映射到绑定的 SQL 客户端凭据。 此 可选 参数接受 字符串 值。 默认值为 空字符串，指示 DRDA 服务不使用 Windows 启动的 ESSO。 使用 Windows 发起的 ESSO 时，必须在SQL Server 连接字符串中指定 Integrated Security=false。
StoredProcedureCallTimeout 参数指示 DRDA 服务在终止尝试并生成错误之前等待SQL Server处理 CALL 语句以执行存储过程) 的时间 (长度（以秒为单位）。 此 可选 参数接受 整数 值。 有效值大于或等于 0 且小于或等于 2147483647。 值为 0 表示没有限制， (尝试执行命令将无限期等待) 。 默认值为 30 秒。
示例
以下示例命令设置默认值。
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 服务配置设置。
语法
Get-DrdaSqlServerConnection [<CommonParameters>]
参数
无。
输出
此 Get-DrdaSqlServerConnection cmdlet 返回属性为：ArithAbort (布尔) ;AuthenticationLookupTimeout (字符串) ;AuthenticationLookupRetryCount (整数) ;ClientApplicationName (string) ;ConnectionString (字符串) ;DefaultCollationName (字符串) ;HostInitiatedAffiliateApplication (字符串) ;MappedAuthenticationDomain (字符串) ;RollbackTransactionOnError (布尔) ;SecurityTokenTimeoutSeconds (string) ;StoredProcedureCallTimeoutSeconds (整数) ;和 WindowsInitiatedAffiliateApplication (字符串) 。
示例
以下示例命令获取默认值。
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存储过程中。
语法
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 静态 SQL 包处理到SQL Server存储过程的 DRDA 服务配置设置。
语法
Get-HisDrdaPackageBindProcessing [<CommonParameters>]
参数
无。
输出
此 Get-HisDrdaPackageBindProcessing cmdlet 返回属性为：CreatePackageProcedure (Boolean) ;CreatePackageXml (布尔) ;PackageXmlFormat (string) ;PackageXmlLocation (字符串) ;StoredProcedureNameSeparator (字符串) ;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存储过程的元数据，用于验证语句类型、游标类型、参数数据类型和其他属性。
语法
Set-HisDrdaPackageProcedureCache -FlushTimeSpan <字符串> [<CommonParameters>]
参数
FlushTimeSpan 参数指示 DRDA 服务在指定的时间间隔后刷新包过程缓存。 此 可选 参数接受表示 XML 持续时间值的 字符串 值。 默认值为 P1D ， (时间段为 1 天) 。 持续时间值以 PnYnMnDTnHnMnS 格式指定。 有关值的详细信息和说明，请参阅数据集成 (部署) 、DRDA 服务、配置包绑定处理。
示例
以下示例命令设置默认值。
Set-HisDrdaPackageProcedureCache -FlushTimeSpan P1D
Get-HisDrdaPackageProcedureCache
此 Get-HisDrdaPackageProcedureCache cmdlet 获取用于缓存SQL Server存储过程元数据的 DRDA 服务配置设置，用于验证语句类型、游标类型、参数数据类型和其他属性。
语法
Get-HisDrdaPackageProcedureCache [<CommonParameters>]
参数
无。
输出
此 Get-HisDrdaPackageProcedureCache cmdlet 返回属性为 FlushTimeSpan (字符串) 的对象。
示例
以下示例命令获取默认值。
Get-HisDrdaPackageProcedureCache
FlushTimeSpan
-------------
P1D
Set-HisDrdaSqlTransform
此 Set-DrdaSqlTransform cmdlet 将 DRDA 服务配置为使用基于 CLR 的内部或外部 SQL 转换将 DB2 函数语法转换为SQL Server T-SQL 函数语法。
语法
Set-DrdaSqlTransform [-EnableUnicodeOutput] [-Type<SqlTransforms>] [<CommonParameters>]
参数
EnableUnicodeOutput 参数指示 DRDA 服务在 Unicode 或 ANSI 中对基于 CLR 的 SQL 转换器的输出进行编码。 此 可选 参数接受 布尔 值。 默认值为 false，指示 DRDA 服务输出 ANSI CHAR 和 VARCHAR 字符串。
Type 参数指示 DRDA 服务利用内部服务或基于外部 CLR 的 SQL 转换。 此可选参数接受 Service 或 Clr 的 Type 值。 默认值为 Service。
示例
以下示例命令设置默认值。
Set-HisDrdaSqlTransform -Type Service
Get-HisDrdaSqlTransform
此 Get-HisDrdaSqlTransform cmdlet 获取使用基于 CLR 的内部或外部 SQL 转换将 DB2 函数语法转换为SQL Server T-SQL 函数语法的 DRDA 服务配置设置。
语法
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 包时使用。
语法
Add-HisDrdaDatabaseAlias -SourceLocation<string> -SourceCollection<string> -TargetDatabase<string> -TargetSchema<string> [<CommonParameters>]
参数
SourceLocation 参数定义一个绑定的 DRDA RDBNAM (关系数据库名称) ，DRDA 服务在映射到外部SQL Server数据库名称时应使用该名称。 此 可选 参数接受 字符串 值。 默认值为 空字符串，表示任何值。
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 包时使用。
语法
Get-HisDrdaDatabaseAlias [<CommonParameters>]
参数
无。
输出
此 Get-HisDrdaDatabaseAlias cmdlet 返回具有属性集合的对象：SourceLocation (string) ;SourceCollection (字符串) ;TargetDatabase (字符串) ;和 TargetSchema (字符串) 。
示例
以下示例命令获取示例值。
Get-HisDrdaDatabaseAlias
SourceLocation
--------------
CONTOSO
SourceCollection
----------------
DSN8HC91
TargetDatabase
--------------
ContosoRetailDW
TargetSchema
------------
DSN8910
DRDA 服务日期时间转换
当处理特定日期时间和字符数据类型的动态和静态 SQL 语句时，DRDA 服务会将源和目标中的字符串文本日期时间值的格式设置为目标格式。
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 服务、配置日期时间转换。
语法
Add-DrdaDatetimeFormat -Conversion <> -DateFormat <DateFormats> [<CommonParameters>]
Add-DrdaDatetimeFormat -Conversion <> -TimeFormat <TimeFormats> [<CommonParameters>]
Add-DrdaDatetimeFormat -Conversion <> -DateTimeFormat <DateTimeFormats> [<CommonParameters>]
参数
Conversion 参数定义 DB2 到 SQL 或 SQL 到 DB2 的方向。 此 必需 参数接受 枚举的转换 值。 指定 Db2toSql 以指示 DRDA 服务读取以转换传入的 DateTime 格式。 指定 SqlToDb2 以指示 DRDA 服务写入以转换超出边界的 DateTime 格式。
DateFormat 参数定义格式类型。 此必需参数接受枚举 的 DateFormat 值。
TimeFormat 参数定义格式类型。 此必需参数接受枚举 的 TimeFormat 值。
DateTimeFormat 参数定义格式类型。 此必需参数接受枚举 的 DateTimeFormat 值。
有关值的详细信息和说明，请参阅数据集成 (部署) 、DRDA 服务、配置日期时间转换。
示例
以下示例命令设置示例 Date 值。
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateFormat Usa
以下示例命令设置示例 Time 值。
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -TimeFormat HmsPeriod
以下示例命令设置示例 Date 值。
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTimeFormat IsoTimestampFormat
Get-HisDrdaDatetimeFormat
此 Get-HisDrdaDatetimeFormat cmdlet 获取用于处理 DB2 和 SQL Server DATE、CHAR (10) 和 VARCHAR (10) 数据类型中的字符串文本日期值的 DRDA 服务配置设置，以便从 DB2 日期格式转换为SQL Server日期格式，以及从 SQL Server 日期格式转换为 DB2 日期格式。
语法
Get-HisDrdaDatetimeFormat -DateTime<DateTime> [<CommonParameters>]
参数
DateTime 参数指示 DRDA 服务返回配置的格式转换。 此 必需 参数接受 枚举的 DateTime 值。 没有 默认值 。 指定 Date 以指示 DRDA 服务返回配置的日期格式转换。 指定 时间 以指示 DRDA 服务返回配置的时间格式转换。 指定 DateTime 以指示 DRDA 服务返回配置的 DateTime 格式转换。
输出
此 Get-HisDrdaDatetimeFormat cmdlet 返回具有属性集合的对象：Db2ToSql (字符串) ;和 SqlToDb2 (字符串) 。
示例
以下示例命令获取默认的 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 日期格式。
语法
Remove-HisDrdaDatetimeFormat -DateTime<DateTime> -Conversion<> -Format<string> [<CommonParameters>]
参数
DateTime 参数指示 DRDA 服务删除配置的格式转换。 此 必需 参数接受 枚举的 DateTime 值。 没有 默认值 。 指定 Date 以指示 DRDA 服务删除配置的日期格式转换。 指定 时间 以指示 DRDA 服务删除配置的时间格式转换。 指定 DateTime 以指示 DRDA 服务删除配置的 DateTime 格式转换。
Conversion 参数定义 DB2 到 SQL 或 SQL 到 DB2 的方向。 此 必需 参数接受 枚举的转换 值。 指定 Db2toSql 以指示 DRDA 服务读取以转换传入的 DateTime 格式。 指定 SqlToDb2 以指示 DRDA 服务写入以转换超出边界的 DateTime 格式。
Format 参数定义格式类型。 此必需参数接受枚举 的 DateFormat、 TimeFormat 或 DateTimeFormat 值。
示例
以下示例命令删除示例 Date 值。
Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Date -Format Usa
以下示例命令设置示例 Time 值。
Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Time -Format HmsPeriod
以下示例命令设置示例 Date 值。
Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime DateTime -Format IsoTimestampFormat
DRDA 服务编码
DRDA 服务映射代码页并支持使用基础 HIS Encoder 组件和 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) 系统代码页转换文件。
语法
Add-HisCustomCodePage -CodePage<uint32> -Name<string> -NlsCodePage<uint32> [-Description<string>] [<CommonParameters>]
参数
CodePage 参数指示 HIS 编码器加载编号的自定义 NLS 代码页文件。 此 必需 参数接受 整数。 默认值为 0。
Name 参数根据定义的自定义 NLS 代码页号命名 HIS Encoder 应加载的自定义 NLS 代码页。 此 必需 参数接受 字符串。 默认值为空字符串。
NlsCodePage 参数定义 HIS Encoder 应替换为自定义代码页码的标准 NLS 代码页码。 此 必需 参数接受 整数。 默认值为 0。
Description 参数描述 HIS Encoder 应根据定义的自定义 NLS 代码页码页码号加载该自定义 NLS 代码页。 此 可选 参数接受 字符串。 默认值为空字符串。
示例
以下示例命令设置示例值。
Add-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140 -Description "Custom codepage based on 1140"
Get-HisCustomCodePage
此 Get-HisCustomCodePage cmdlet 获取 DRDA 服务配置设置，用于指示 HIS Encoder 组件加载自定义 Windows 国家/地区语言支持 (NLS) 系统代码页转换文件。
语法
Get-HisCustomCodePage [-CodePage<uint32>] [-Name<string>] [-NlsCodePage<uint32>] [<CommonParameters>]
参数
CodePage 参数指示 DRDA 服务使用此编号的自定义 NLS 代码页文件获取配置设置。 此 可选 参数接受 整数。 默认值为 0。
Name 参数指示 DRDA 服务使用此自定义 NLS 代码页名称获取配置设置。 此 可选 参数接受 字符串。 默认值为空字符串。
NlsCodePage 参数指示 DRDA 服务使用此自定义代码页码获取配置设置。 此 可选 参数接受 整数。 默认值为 0。
输出
此 Get-HisCustomCodePage cmdlet 返回具有以下属性的对象：Name (string) ;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) 系统代码页转换文件。
语法
Remove-HisCustomCodePage [-Name] <字符串> [<CommonParameters>]
参数
Name 参数指示 DRDA 服务使用自定义 NLS 代码页名称删除配置设置。 此 必需 参数接受 字符串。 默认值为空字符串。
示例
以下示例命令删除示例值。
Remove-HisCustomCodePage -Name Custom21140
Add-HisCustomConversion
此 Add-HisCustomConversion cmdlet 将 DRDA 服务配置为替代标准 NLS 和自定义 NLS 代码页中的代码点映射。
语法
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 服务配置设置。
语法
Get-HisCustomConversion -Type<ConversionType> {EbcdicToUnicode |UnicodeToEbcdic} -CodePage <uint32> [<CommonParameters>]
Get-HisCustomConversion -Type<ConversionType> {EbcdicToUnicode |UnicodeToEbcdic} -Name <string> [<CommonParameters>]
参数
CodePage 参数指示 DRDA 服务使用此编号的 NLS 代码页文件获取配置设置。 此 必需 参数接受 整数。 默认值为 0。
Name 参数指示 DRDA 服务使用此自定义 NLS 代码页名称文件获取配置设置。 此 必需 参数接受 字符串。 默认值为空字符串。
Type 参数指示 DRDA 服务使用此编号的 NLS 代码页文件或自定义 NLS 代码页名称文件获取配置设置。 此 必需 参数接受 EbcdicToUnicode 或 UnicodeToEbcdic 的枚举值。
输出
此 Get-HisCustomConversion cmdlet 返回属性为：From (hex) ;和 (十六进制) 。
Remove-HisCustomConversion
此 Remove-HisCustomConversion cmdlet 删除用于替代标准 NLS 和自定义 NLS 代码页中的代码点映射的 DRDA 服务配置设置。
语法
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) 系统组件在代码页中的映射代码点中使用。 有关值的详细信息和说明，请参阅配置应用程序编码了解详细信息。
语法
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 服务仅对指定目标SQL Server数据库使用替代编码方案（而不是 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) 系统组件在代码页中的映射代码点中使用。
语法
Get-HisDrdaApplicationEncoding [-Ccsid<uint32>] [-Database<string>] [-CustomCcsid<uint32>] [<CommonParameters>]
参数
Ccsid 参数指示 DRDA 服务使用替代 CCSID (编码字符集标识符) 获取应用程序编码配置。 此 可选 参数接受 整数。 默认值为 1208。
CustomCcsid 参数指示 DRDA 服务使用自定义 CCSID (编码字符集标识符) 获取应用程序编码配置。 此 可选 参数接受 整数。 默认值为 -1。
Database 参数指示 DRDA 服务使用指定的目标SQL Server数据库名称获取应用程序编码配置。 此 可选 参数接受 字符串 值。 默认值为空字符串。
输出
此 Get-HisDrdaApplicationEncoding cmdlet 返回一个属性为：Scheme (string) ;Ccsid (整数) ;数据库 (字符串) ;和 CustomCcsid (整数) 。
示例
以下示例命令获取示例值。
Get-HisDrdaApplicationEncoding
Scheme
------
Ebcdic
Ebcdic
Ccsid
-----
1140
Database
--------
NWIND1
NWIND1
Customccsid
-----------
1234
Remove-HisDrdaApplicationEncoding
此 Remove-HisDrdaApplicationEncoding cmdlet 基于每个数据库删除默认应用程序级编码方案的 DRDA 服务配置设置，供 HIS 编码器组件和 Windows 国家/地区语言支持 (NLS) 系统组件在代码页中的映射代码点中使用。
语法
Remove-HisDrdaApplicationEncoding -Ccsid<string[]> [-Database<string>] [<CommonParameters>]
Remove-HisDrdaApplicationEncoding -CustomCcsid<string[]> [-Database<string>] [<CommonParameters>]
参数
Ccsid 参数指示 DRDA 服务使用替代 CCSID (编码字符集标识符) 删除应用程序编码配置。 此 可选 参数接受 整数。 默认值为 1208。
CustomCcsid 参数指示 DRDA 服务使用自定义 CCSID (编码字符集标识符) 删除应用程序编码配置。 此 可选 参数接受 整数。 默认值为 -1。
Database 参数指示 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 服务、配置排序规则映射。
语法
Add-HisDrdaCollationName -To <string> -From <string> [<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值，以提供更兼容的查询结果。
语法
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 删除 DRDA 服务配置设置，以基于默认 ORDER BY 排序规则名称将 COLLATE 子句添加到 ORDER BY 子句。
语法
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 服务控制台跟踪侦听器配置为将跟踪数据写入命令控制台窗口。
语法
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 将 Windows) 的 DRDA 服务 ETW (事件跟踪配置为 ETW 提供程序，以便通过 ETW 会话将跟踪数据输出到 Windows 操作系统 ETW 控制器。
语法
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 事件日志。
语法
Set-HisDrdaEventLogTraceListener -InitializeData <字符串> [<CommonParameters>]
参数
InitializeData 参数指示 DRDA 服务记录定义的信息集合。 此 必需 参数接受 字符串 值。 默认值为“Error，Warning，Information”，其中包括所有事件日志级别。
| 值 | 说明 |
|---|---|
| 错误 | 此值指示 DRDA 服务仅记录错误级别数据。 |
| 警告 | 此值指示 DRDA 服务仅记录警告级别数据。 |
| 信息 | 此值指示 DRDA 服务仅记录信息级别数据 |
Table AUTONUM \\ Arabic 事件日志级别。*
示例
以下示例命令设置示例值。
Set-HisDrdaEventLogTraceListener -InitializeData Warning
Set-HisDrdaTextTraceListener
Set-HisDrdaTextTraceListener cmdlet 配置 DRDA 服务文本跟踪侦听器，以文本格式将跟踪数据写入磁盘文件。
语法
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 服务启动指定类型的跟踪侦听器。
语法
Start-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]
参数
侦听器参数指示 DRDA 服务启动指定的跟踪侦听器类型。 此 必需 参数接受 Console、 Text、 Etw 或 EventLog 的侦听器值。 没有默认值。
示例
以下示例命令设置示例值。
Start-HisDrdaTraceListener -Listener Console
以下示例命令设置示例值。
Start-HisDrdaTraceListener -Listener Text
以下示例命令设置示例值。
Start-HisDrdaTraceListener -Listener Etw
以下示例命令设置示例值。
Start-HisDrdaTraceListener -Listener EventLog
Get-HisDrdaTraceListener
此 Get-DrdaTextTraceListener cmdlet 获取文本跟踪侦听器的 DRDA 服务配置设置，以便以文本格式将跟踪数据写入磁盘文件。
语法
Get-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]
参数
侦听器参数指示 DRDA 服务获取指定跟踪侦听器类型的配置。 此 必需 参数接受 Console、 Text、 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 服务停止指定类型的跟踪侦听器。
语法
Stop-HisDrdaTraceListener [-Listener] <TraceListenerType> [<CommonParameters>]
参数
侦听器参数指示 DRDA 服务获取指定跟踪侦听器类型的配置。 此 必需 参数接受 Console、 Text、 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 语句输出一起发送到可选的自定义绑定侦听器。
语法
Add-HisDrdaPackageBindListener -TypeName<字符串> [-ThrowWhenNoCallback ] [<CommonParameters>]
参数
TypeName 参数定义 DRDA 服务自定义绑定侦听器的类型。 此 必需 参数接受 字符串。 没有默认值。 自定义包绑定侦听器示例的 Type 值为“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 语句输出将绑定包发送到可选的自定义绑定侦听器。
语法
Get-HisDrdaPackageBindListener [-Type<string>] [<CommonParameters>]
参数
Type 参数定义 DRDA 服务自定义绑定侦听器的类型。 此 必需 参数接受 字符串。 没有默认值。 自定义包绑定侦听器示例的 Type 值为“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 服务配置设置以添加自定义跟踪侦听器。
语法
Remove-HisDrdaPackageBindListener -TypeName<字符串> [<CommonParameters>]
参数
Type 参数定义 DRDA 服务自定义绑定侦听器的类型。 此 必需 参数接受 字符串。 没有默认值。 自定义包绑定侦听器示例的 Type 值为“CustomListeners.MyPackageBindListener， CustomListeners， Version=1.0.0.0， Culture=neutral， PublicKeyToken=34013cf74da51d17， processorArchitecture=MSIL”。
示例
以下示例命令删除示例值。
Remove-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener