PowerShell モジュール コマンドレットとコマンド

PowerShell モジュール

Windows PowerShell® は、システム管理に重点を置いて設計されたタスクベースのコマンド ライン シェルおよびスクリプト言語です。 .NET Framework 上に構築された Windows PowerShell は、IT 技術者およびパワー ユーザーが Windows オペレーティング システムと Windows 上で実行するアプリケーションの管理の自動化を制御するときに役立ちます。 DRDA サービスは、一般的な HIS 2013 powershell モジュールの一部として powershell コマンドを提供します。これには、MsDrdaService.exe.config の要素や属性を追加/取得/削除/設定するコマンドレットコマンドや、リスナーを開始または停止するためのコマンドが含まれます。

PowerShell コマンドレット

PowerShell コマンドレットは、Windows PowerShell 環境で使用される簡易コマンドです。 Windows PowerShell ランタイムは、コマンドラインで指定されたオートメーションスクリプトのコンテキスト内でこれらのコマンドレットを呼び出します。 また、Windows PowerShell ランタイムは、Windows PowerShell api を使用してプログラムでそれらを呼び出します。

ユーザーが使用できるパラメーター、またはコマンドレットを実行しているアプリケーションに対して使用可能なパラメーターを定義するパブリックプロパティ。 コマンドレットには、必須の、名前付き、位置指定、およびスイッチのパラメーターを指定できます。 スイッチパラメーターは、コマンドの実行時に指定することができるか、または指定できないパラメーターです。 パラメーターを指定した場合、Windows PowerShell ランタイムはその値を true として解決します。 パラメーターが指定されていない場合 (通常は既定)、パラメーター値は false として解決されます。 共通パラメーターはすべてのコマンドレットに追加され、コマンドレットを実行するたびにアクセスできます。

DRDA Service PowerShell モジュールコマンドレットコマンド

DRDA サービスの構成は、MsDrdaService.exe.config アプリケーション構成 (アプリ構成) ファイルと、関連付けられている XML ファイル (エラーメッセージのマッピングとデータ型のマッピング) に格納されます。 実行時に、DRDA サービスは MsDrdaService.exe.config ファイルの変更を監視します。 検出されると、DRDA サービスは、新しいインバウンド接続を処理するときに、変更された構成情報を読み取り、使用します。 DRDA サービスには、アプリケーション構成ファイルを検証するための%SNAROOT%\System\Schemas\HostIntegrationDrdaServiceConfiguration.xsd ファイルが含まれています。

IT プロフェッショナルは、DRDA Service PowerShell モジュール DRDA を使用して、サービス構成をカスタマイズできます。 コマンドレットは、構成コレクションと操作コレクションにグループ化されています。

必要なソフトウェア

DRDA Service PowerShell モジュールでは、機能の前提条件として、次のソフトウェア製品が必要です。

PowerShell を起動する

これらのコマンドのいずれかを実行して、管理者権限で PowerShell を起動します。

  • スタート画面で、[ Windows PowerShellアプリ] タイルを右クリックし、アプリバーの [管理者として実行] をクリックします。

  • タスクバーのサーバーマネージャーまたはデスクトップで、 Windows PowerShellショートカットを右クリックし、[管理者として実行] をクリックします。

  • デスクトップで、右上隅にカーソルを移動し、[検索] をクリックして「 PowerShell」と入力し、 Windows PowerShellアプリのタイルを右クリックして、アプリバーで [管理者として実行] をクリックします。

  • Windows PowerShell コマンドプロンプトで、次のように入力します。

    Start-Process PowerShell -Verb RunAs
    

PowerShell ISE を起動する

これらのコマンドのいずれかを実行して、管理者権限で PowerShell ISE (Integrated Scripting Environment) を起動します。

  • スタート画面で、「 ise」と入力し、[ Windows PowerShell ise ] タイルを右クリックして、アプリバーで [管理者として実行] をクリックします。

  • タスクバーの [ Windows PowerShellを右クリックし、[管理者として ISE を実行] をクリックします。

  • [サーバーマネージャーツール] メニューの [ Windows PowerShell ISE] を選択します。

  • Windows PowerShell コマンドプロンプトで、次のように入力します。

    Start-Process PowerShell_ISE -Verb RunAs
    

モジュールパスの設定

DRDA Service 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...}
    

Get モジュールコマンド

  1. Windows PowerShell または PowerShell ISE のコマンドプロンプトで、次のコマンドを入力して、enter キーを押します。

    Get-Command -Module Microsoft.HostIntegration.PowerShell
    
  2. 次の情報を確認します。

DRDA Service のコマンド

次の DRDA コマンドレットコマンドは、このサービスで使用されます。

CommandType 名前 ModuleName
コマンドレット Add-HisCustomCodePage Microsoft HostIntegration. PowerShell
コマンドレット Add-HisCustomConversion Microsoft HostIntegration. PowerShell
コマンドレット Add-HisDrdaApplicationEncoding Microsoft HostIntegration. PowerShell
コマンドレット Add-HisDrdaCollationName Microsoft HostIntegration. PowerShell
コマンドレット Add-HisDrdaDatabaseAlias Microsoft HostIntegration. PowerShell
コマンドレット Add-HisDrdaDatetimeFormat Microsoft HostIntegration. PowerShell
コマンドレット Add-HisDrdaPackageBindListener Microsoft HostIntegration. PowerShell
コマンドレット Get-HisCustomCodePage Microsoft HostIntegration. PowerShell
コマンドレット Get-HisCustomConversion Microsoft HostIntegration. PowerShell
コマンドレット Get-HisDrdaApplicationEncoding Microsoft HostIntegration. PowerShell
コマンドレット Get-HisDrdaCollationName Microsoft HostIntegration. PowerShell
コマンドレット Get-HisDrdaDatabaseAlias Microsoft HostIntegration. PowerShell
コマンドレット Get-HisDrdaDatetimeFormat Microsoft HostIntegration. PowerShell
コマンドレット Get-HisDrdaPackageBindListener Microsoft HostIntegration. PowerShell
コマンドレット Get-HisDrdaPackageBindProcessing Microsoft HostIntegration. PowerShell
コマンドレット Get-HisDrdaPackageProcedureCache Microsoft.HostIntegration.PowerShell
コマンドレット Get-HisDrdaService Microsoft.HostIntegration.PowerShell
コマンドレット Get-HisDrdaSqlServerConnection Microsoft.HostIntegration.PowerShell
コマンドレット Get-HisDrdaSqlTransform Microsoft.HostIntegration.PowerShell
コマンドレット Get-HisDrdaTraceListener Microsoft.HostIntegration.PowerShell
コマンドレット Remove-HisCustomCodePage Microsoft.HostIntegration.PowerShell
コマンドレット Remove-HisCustomConversion Microsoft.HostIntegration.PowerShell
コマンドレット Remove-HisDrdaApplicationEncoding Microsoft.HostIntegration.PowerShell
コマンドレット Remove-HisDrdaCollationName Microsoft.HostIntegration.PowerShell
コマンドレット Remove-HisDrdaDatabaseAlias Microsoft.HostIntegration.PowerShell
コマンドレット Remove-HisDrdaDatetimeFormat Microsoft.HostIntegration.PowerShell
コマンドレット Remove-HisDrdaPackageBindListener Microsoft.HostIntegration.PowerShell
コマンドレット Set-HisDrdaConsoleTraceListener Microsoft.HostIntegration.PowerShell
コマンドレット Set-HisDrdaEtwTraceListener Microsoft.HostIntegration.PowerShell
コマンドレット Set-HisDrdaEventLogTraceListener Microsoft.HostIntegration.PowerShell
コマンドレット Set-HisDrdaPackageBindProcessing Microsoft.HostIntegration.PowerShell
コマンドレット Set-HisDrdaPackageProcedureCache Microsoft.HostIntegration.PowerShell
コマンドレット Set-HisDrdaService Microsoft.HostIntegration.PowerShell
コマンドレット Set-HisDrdaSqlServerConnection Microsoft.HostIntegration.PowerShell
コマンドレット Set-HisDrdaSqlTransform Microsoft.HostIntegration.PowerShell
コマンドレット Set-HisDrdaTextTraceListener Microsoft.HostIntegration.PowerShell
コマンドレット Start-HisDrdaTraceListener Microsoft.HostIntegration.PowerShell
コマンドレット Stop-HisDrdaTraceListener Microsoft.HostIntegration.PowerShell

表 1。 DRDA サービス PowerShell コマンドの一覧。

DRDA サービス接続とパッケージ バインド処理

DRDA サービスの接続とパッケージ バインドは、(1) DRDA クライアントから DRDA サービスへの接続、(2) DR SQL Server DA サービス間接続、(3) DRDA サービス間接続、および (4) DRDA サービス パッケージバインド処理 (SQL 構文変換を含む) で構成されます。

Set-HisDrdaService

このSet-HisDrdaServiceコマンドレットは、バインドされた DRDA クライアント接続用に DRDA サービスを構成します。

構文

Set-HisDrdaService [-PartnerServersstring<>] [-Portuint32><] [-IsPrimary ] [-UseSsl ] [-PingIntervaluint32<>] [-EnablePerformanceCounters ] [-AllowClientIpAddressesstring<>] [-SslCertificatePathstring<>] [<CommonParameters>]

パラメーター

AllowClientIpAddresses パラメーターは、既知の DRDA AR クライアント コンピューターの一覧から、バインドされた TCP/IP ネットワーク接続を受け入れる DRDA サービスを制限します。 この 省略可能な パラメーターは、文字列値を 受け取 ります。 既定値は空の 文字列です。これにより、DRDA サービスは、すべてのバインドされたクライアント接続要求に応答できます。 この一覧は、TCP/IP アドレスまたはエイリアスのセミコロンで区切って構成されます。 TCP/IP アドレスは、IPv4 または IPv6 形式で定義できます。 たとえば、123.34.45.57 などです。123.34.45.58 では、IPv4 ネットワーク アドレス形式で有効なクライアント リストが定義されています。

EnablePeformanceCounters パラメーターは、パフォーマンス カウンターに情報を収集するように DRDA サービスに指示します。 この 省略可能な パラメーターは、ブール値を 受け取 ります。 既定値は false です。

IsPrimary パラメーターは、サーバーのグループ内のプライマリ ロールで動作するかどうかを DRDA サービスに指示します。 この 省略可能な パラメーターは、ブール値を 受け取 ります。 既定値は true です。 プライマリ サーバーは、ACCRDBRM (ACCRDB 応答メッセージ) で SRVLST (サーバー リスト) を返すなど、EXCSAT (Exchange Server 属性)、ACCSEC (アクセス セキュリティ)、および ACCRDB (Access Relational Database) を処理することで、すべての DRDA AR クライアント要求に応答します。 サーバー一覧には、DRDA サービス コンピューターが接続する DRDA AR クライアントに通知する、プライマリ (最も高い重み付け値) とセカンダリ サーバー (最も低い重み付け値) の重み付け優先度の一覧が含まれています

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 属性) フローを実行し、EXCSATRD (EXCSAT 応答データ) を確認することで、パートナー サーバー コンピューターの正常性を監視する頻度を DRDA サービスに指示します。 この 省略可能な パラメーターは、整数値を 受け取 ります。 既定値は 10000 ミリ 秒 (10 秒) です。

Port パラメーター は、DRDA サービスがバインドされた DRDA Application Requester クライアント接続要求をリッスンする必要がある TCP/IP ポート番号を定義します。 この 省略可能 なパラメーターは、 整数 値を受け取ります。 既定値は 446です。

Sslcertificatepathパラメーターは、SSL または TLS 証明書の共通名 (CN) を指定します。 UseSSL = true の場合は、この 省略可能 なパラメーターを指定し、 文字列 値を受け入れます。 既定値は空の文字列です。

UseSSLパラメーターは、バインドされた tcp/ip ネットワーク接続への応答時に、SECURE SOCKETS LAYER (SSL) バージョン3.0 とトランスポート層セキュリティ (TLS) バージョン1.0 を使用するよう DRDA サービスに指示します。 この 省略可能 なパラメーターは、 ブール 値を受け取ります。 既定値は false です。

次のコマンド例では、既定値を設定します。

Set-HisDrdaService -IsPrimary -PingInterval 10000 -Port 446

Get-HisDrdaService

この Get-HisDrdaService コマンドレットは、インバウンド DRDA クライアント接続の DRDA サービス構成設定を取得します。

構文

Get-HisDrdaService [ < commonparameters > ]

パラメーター

[なし] :

出力

この Get-HisDrdaService コマンドレットは、次のプロパティを持つオブジェクトを返します: AllowClientIpAddresses (string);IsPrimary (ブール値) です。PartnerServers (文字列);EnablePerformanceCounters (ブール値) です。Ping 間隔 (integer);Port (integer);SslCertificatePath (string);and UseSsl (ブール値)。

次のコマンド例では、既定値を取得します。

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

Set-DrdaSqlServerConnection

この Set-DrdaSqlServerConnection コマンドレットは、out バインド SQL Server 接続用に DRDA サービスを構成します。

構文

Set-DrdaSqlServerConnection [-MappedAuthenticationDomain< string > ] [-authenticationlookuptimeoutduration< string > ] [-authenticationlookuptimeoutduration< uint32 > ] [-SecurityTokenTimeoutDuration< string > ] [-RollbackTransactionOnError ] [-clientapplicationname< clientapplicationname > ] [-DefaultCollationName< string > ] [-ConnectionString < string > ] [-StoredProcedureCallTimeout< uint32 > ] [-HostInitiatedAffiliateApplication< string > ] [-WindowsInitiatedAffiliateApplication< string > ] [-EnableArithAbort ] [ < commonparameters > ]

パラメーター

Authenticationlookupretrycountパラメーターは、失敗する前に、セキュリティ認証の参照要求を試行する回数を DRDA サービスに指示します。 この 省略可能 なパラメーターは、 整数 値を受け取ります。 既定値は3回です。

Authenticationlookuptimeoutdurationパラメーターは、DRDA サービスに、セキュリティ認証の参照要求を待機する時間を指定します。この時間が経過すると失敗します。 この 省略可能 なパラメーターは、XML duration 値を表す 文字列 値を受け取ります。 既定値は PT30S (期間は30秒) です。 Duration 値は、PnYnMnDTnHnMnS の形式で指定します。 値の詳細と説明については、「データ統合 (デプロイ)」、「DRDA Service」、「SQL Server 接続の構成」を参照してください。

clientapplicationnameパラメーターは、SQL クライアントアプリケーション名の接続プロパティを設定する方法を DRDA サービスに指示します。 この 省略可能 なパラメーターは、列挙された文字列値を受け取ります。 既定値は です。 Externalnameを指定して、DRDA AR client プログラムのジョブ、タスク、またはプロセスの名前を表す DRDA 外部名 (extnam) のバイト1-8 を使用するように DRDA サービスに指示します。 DRDA サービスに対して、DRDA AR client プログラムのトランザクション識別子の名前を表すバイト5-8 を使用するように指定するには、 Transactionidentifier を指定します。

ConnectionStringパラメーターは、SQL Server connection オブジェクト用に Microsoft ADO.NET Framework Data Provider を定義するときに、DRDA サービスによって使用される引数名と値のペアの一覧を定義します。 この 必須 パラメーターは、 文字列 値を受け入れます。 既定値は [ Data Source =; Integrated Security = True;MultipleActiveResultSets = True。 詳細については、「データ統合 (デプロイ)」、「DRDA Service」、「SQL Server 接続の構成」を参照してください。

DefaultCollationNameパラメーターは、order by 句を含む DB2 select ステートメントを order by 句を指定した SQL Server select ステートメントに変換するときに、DRDA サービスに SQL Server COLLATE (collation_name) 句を追加するように指示します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は SQL_Latin1_General_CP1_CI_ASです。 値の詳細と説明については、「データ統合 (デプロイ)」、「DRDA Service」、「照合順序マッピングの構成」を参照してください。

EnableArithAbortパラメーターは、クエリの実行中にオーバーフローまたは0除算エラーが発生した場合にクエリを終了する SQL Server 要求するために、接続時に SET ARITHABORT ステートメントを発行するように DRDA サービスに指示します。 この 省略可能 なパラメーターは、 ブール 値を受け取ります。 既定値は false です。

HostInitiatedAffiliateApplicationパラメーターは、SQL クライアントが Windows 認証を使用するときに、DRDA サービスが Microsoft Enterprise Single Sign-On と共に使用して、バインドされた DRDA AR クライアント資格情報を Windows Active Directory ドメインユーザーにマップするために使用する関連アプリケーション名を定義します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の 文字列です。これは、ホスト側開始 esso を使用しないように DRDA サービスに指示します。 ホスト側開始 esso を使用する場合は、SQL Server 接続文字列で Integrated Security = true を指定する必要があります。

MappedAuthenticationDomainパラメーターは、DRDA サービスに対して、microsoft が統合セキュリティサポートプロバイダインターフェイス (SSPI) を使用して Windows 認証用に構成されている SQL Server に接続するときに、バインドされている DRDA クライアント資格情報 (ユーザー名とパスワード) をマップするようにサービスに指示します。 microsoft Active Directory WindowsEnterprise Single Sign-On。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の文字列です。

RollbackTransactionOnErrorパラメーターは、DRDA サービスに対して、負の SQL Server データベースエラーの後のロールバックを実行するように指示します。 この 省略可能 なパラメーターは、 ブール 値を受け取ります。 既定値は true です。

SecurityTokenTimeoutパラメーターは、DRDA サービスに対して、一定期間にセキュリティトークンを保持するように指示します。その後、新しい Windows クライアント識別子 (CID) を取得します。 この 省略可能 なパラメーターは、 duration 値を受け取ります。 既定値は PT8H です (期間は8時間です)。 Duration 値は、PnYnMnDTnHnMnS の形式で指定します。 値の詳細と説明については、「データ統合 (デプロイ)」、「DRDA Service」、「SQL Server 接続の構成」を参照してください。

WindowsInitiatedAffiliateApplicationパラメーターは、SQL クライアントが SQL 認証を使用している場合に、DRDA サービスが Microsoft Enterprise Single Sign-On と共に使用して Windows Active Directory ドメインユーザーをアウトバウンド SQL Server クライアント資格情報にマップするために使用する関連アプリケーション名を定義します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の文字列です。これは、DRDA サービスが Windows 開始 esso を使用しないように指示します。 Windows によって開始される esso を使用する場合は、SQL Server 接続文字列に Integrated Security = false を指定する必要があります。

StoredProcedureCallTimeoutパラメーターは、DRDA サービスに対して、ストアドプロシージャを実行するため SQL Server の呼び出しステートメントの処理を待機する時間 (秒単位) を指定します。この時間が経過すると、試行が終了してエラーが生成されます。 この 省略可能 なパラメーターは、 整数 値を受け取ります。 有効な値は、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 コマンドレットは、out バインド SQL Server 接続の DRDA サービス構成設定を取得します。

構文

Get-DrdaSqlServerConnection [ < commonparameters > ]

パラメーター

[なし] :

出力

この Get-DrdaSqlServerConnection コマンドレットは、次のプロパティを持つオブジェクトを返します: ArithAbort (Boolean);AuthenticationLookupTimeout (string);AuthenticationLookupRetryCount (integer);ClientApplicationName (string);ConnectionString (string);DefaultCollationName (string);HostInitiatedAffiliateApplication (string);MappedAuthenticationDomain (string);RollbackTransactionOnError (ブール値) です。SecurityTokenTimeoutSeconds (string);StoredProcedureCallTimeoutSeconds (integer);と 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 コマンドレットは、DRDA 静的 SQL パッケージを SQL Server ストアドプロシージャに処理するための DRDA サービスを構成します。

構文

Set-DrdaPackageBindProcessing [-CreatePackageProcedureWithCustomSqlScripts] [-PackageProcedureSchemaList < string > ] [-createpackageprocedure] [-CreatePackageXml] [-PackageXmlFormat < PackageXmlFormat > ] [-PackageXmlLocation < string > ] [-StoredProcedureNameSeparator < string > ] [-CreatePackageProcedureWithExtendedProperties] [ < commonparameters > ]

パラメーター

createpackageprocedureパラメーターは、1つの BGNBND flow を SQL Server ストアドプロシージャに処理し、DRDA BNDSQLSTT のフローで定義されている元のステートメントを対応する SQL Server の構文に変換するように DRDA サービスに指示します。 この 省略可能 なパラメーターは、 ブール 値を受け取ります。 既定値は true です。

CreatePackageProcedureWithCustomSqlScriptsパラメーターは、DRDA サービスに対して、外部カスタムパッケージバインドリスナーコンポーネントを介して DRDA BGNBND と BNDSQLSTT を処理するように指示します。 この 省略可能 なパラメーターは、 ブール 値を受け取ります。 既定値は false です。

CreatePackageProcedureWithExtendedPropertiesパラメーターは、DRDA サービスに対して、SQL Server ストアドプロシージャの拡張プロパティとして BGNBND package バインドオプションを保持するように指示します。 この 省略可能 なパラメーターは、 ブール 値を受け取ります。 既定値は false です。

CreatePackageXmlパラメーターは、DRDA サービスに対して、単一の BGNBND フローを DB2 パッケージ XML ファイルの静的 SQL に処理し、DRDA BNDSQLSTT フローで定義されている元のバインドオプションとステートメントを保持するように指示します。 この 省略可能 なパラメーターは、 ブール 値を受け取ります。 既定値は false です。

PackageProcedureSchemaListは、DRDA サービスに対して、代替スキーマでターゲット SQL Server ストアドプロシージャを検索するように指示します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の文字列です。 文字列は、コンマ区切りの SQL Server スキーマ名で構成されます。 PackageProcedureSchemaList パラメーターは、IBM DB2 for z/OS の現在の PACKAGESET 特別なレジスタと SET CURRENT PACKAGESET ステートメントに似ています。

PackageXmlFormatパラメーターは、DRDA サービスに対して、v90 または v85 のいずれかの形式で DB2 XML ファイルの静的 SQL を書き込むように指示します。 この 省略可能 なパラメーターは、v85 または v90 のいずれかの列挙 文字列 値を受け取ります。 既定値は v90です。

PackageXmlLocationパラメーターは、DB2 パッケージ XML ファイルの静的 SQL を書き込む場所を DRDA サービスに指示します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は c:\tempです。

StoredProcedureNameSeparatorパラメーターは、DRDA サービスに対して、DRDA パッケージ名を SQL Server のストアドプロシージャ名にマップするときに使用する区切り文字を指示します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は1つの アンダースコア 文字 (_) です。

次のコマンド例では、既定値を設定します。

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

Get-HisDrdaPackageBindProcessing

この Get-HisDrdaPackageBindProcessing コマンドレットは、DRDA 静的 SQL パッケージを SQL Server ストアドプロシージャに処理するための DRDA サービス構成設定を取得します。

構文

Get-HisDrdaPackageBindProcessing [ < commonparameters > ]

パラメーター

[なし] :

出力

この Get-HisDrdaPackageBindProcessing コマンドレットは、次のプロパティを持つオブジェクトを返します: CreatePackageProcedure (ブール値)。CreatePackageXml (ブール値) です。PackageXmlFormat (string);PackageXmlLocation (string);StoredProcedureNameSeparator (string);CreatePackageProcedureWithExtendedProperties (ブール値) です。CreatePackageProcedureWithCustomSqlScripts (ブール値) です。と PackageProcedureSchemaList (string) です。

次のコマンド例では、既定値を取得します。

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

Set-HisDrdaPackageProcedureCache

この Set-HisDrdaPackageProcedureCache コマンドレットは、ステートメントの種類、カーソルの種類、パラメーターのデータ型、およびその他の属性を確認するために使用する、SQL Server ストアドプロシージャのメタデータをキャッシュするために DRDA サービスを構成します。

構文

Set-HisDrdaPackageProcedureCache-FlushTimeSpan < string > [ < commonparameters > ]

パラメーター

Flushtimespanパラメーターは、指定された時間が経過した後にパッケージプロシージャキャッシュをフラッシュするように DRDA サービスに指示します。 この 省略可能 なパラメーターは、XML duration 値を表す 文字列 値を受け取ります。 既定値は P1D (期間は1日) です。 Duration 値は、PnYnMnDTnHnMnS の形式で指定します。 値の詳細と説明については、「データ統合 (配置)」、「DRDA Service」、「パッケージバインド処理の構成」を参照してください。

次のコマンド例では、既定値を設定します。

Set-HisDrdaPackageProcedureCache -FlushTimeSpan P1D

Get-HisDrdaPackageProcedureCache

この Get-HisDrdaPackageProcedureCache コマンドレットは、ステートメントの種類、カーソルの種類、パラメーターのデータ型、およびその他の属性を確認するために使用する、SQL Server ストアドプロシージャのメタデータをキャッシュするための DRDA サービス構成設定を取得します。

構文

Get-HisDrdaPackageProcedureCache [ < commonparameters > ]

パラメーター

[なし] :

出力

この Get-HisDrdaPackageProcedureCache コマンドレットは、プロパティ FlushTimeSpan (string) を持つオブジェクトを返します。

次のコマンド例では、既定値を取得します。

Get-HisDrdaPackageProcedureCache
FlushTimeSpan
-------------
P1D

Set-HisDrdaSqlTransform

この Set-DrdaSqlTransform コマンドレットは、内部または外部の CLR ベースの SQL 変換を使用して DB2 関数構文を SQL Server T SQL 関数構文に変換するための DRDA サービスを構成します。

構文

Set-DrdaSqlTransform [-EnableUnicodeOutput] [-Type< sqltransforms フォーム > ] [ < commonparameters > ]

パラメーター

EnableUnicodeOutputパラメーターは、DRDA サービスに対して、CLR ベースの SQL トランスフォーマーからの出力を Unicode または ANSI でエンコードするように指示します。 この 省略可能 なパラメーターは、 ブール 値を受け取ります。 既定値は falseです。これは、DRDA サービスに対して、 ANSI CHAR および VARCHAR 文字列を出力するように指示します。

Typeパラメーターは、内部サービスまたは外部 CLR ベースの SQL 変換を使用するように DRDA サービスに指示します。 この省略可能なパラメーターは、 ServiceまたはClrの値を受け取ります。 既定値は Serviceです。

次のコマンド例では、既定値を設定します。

Set-HisDrdaSqlTransform -Type Service

Get-HisDrdaSqlTransform

この Get-HisDrdaSqlTransform コマンドレットは、内部または外部の CLR ベースの SQL 変換を使用して DB2 関数構文を SQL Server T SQL 関数構文に変換するための DRDA サービス構成設定を取得します。

構文

Get-HisDrdaSqlTransforms [ < commonparameters > ]

パラメーター

[なし] :

出力

この Get-HisDrdaSqlTransforms コマンドレットは、プロパティ: Type (SqlTransforms フォーム) を持つオブジェクトを返します。and EnableUnicodeOutput (ブール値)。

次のコマンド例では、既定値を取得します。

Get-HisDrdaSqlTransform
Type
----
Service

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

データベースの別名マッピング

IBM DB2 および Microsoft SQL Server データベースでは、オブジェクトの名前付けに関してさまざまな用語が使用されています。次の表に、テーブルの完全修飾された3つの要素から構成されるオブジェクト識別子の定義を示します。 DRDA サービスは、DB2 カタログ名とスキーマ名を SQL Server カタログとスキーマ名にマップできます。 詳細については、「データベースの別名マッピングの構成」を参照してください。

Add-HisDrdaDatabaseAlias

この Add-HisDrdaDatabaseAlias コマンドレットは、バインドされたカタログ名とスキーマ名を送信カタログとスキーマ名にマッピングするための DRDA サービスを構成します。これは、SQL Server ストアドプロシージャにマップされている DB2 コマンドに対して静的 SQL パッケージを実行する場合に使用します。

構文

Add-HisDrdaDatabaseAlias-SourceLocation<><> string-targetdatabase< 文字列 > -TargetSchema< string > [ < commonparameters > ]

パラメーター

SourceLocationパラメーターは、DRDA RDBNAM (リレーショナルデータベース名) を定義します。この名前は、out バインド SQL Server データベース名にマッピングするときに DRDA サービスが使用する必要があります。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の 文字列で、任意の値を示します。

SourceCollectionパラメーターは、out バインドされた SQL Server スキーマ名にマッピングするときに DRDA サービスが使用する、インバウンドの DRDA COLID (コレクション識別子) を定義します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の 文字列で、任意の値を示します。

targetdatabaseパラメーターは、DRDA サービスがインバウンドの DRDA RDBNAM 値からマッピングするときに使用する、out バインド SQL Server データベース名を定義します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の 文字列で、任意の値を示します。

TargetSchemaパラメーターは、DRDA サービスがインバウンドの DRDA COLID 値からマッピングするときに使用する、out バインド SQL Server スキーマ名を定義します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の 文字列で、任意の値を示します。

次のコマンド例では、サンプル値を追加します。

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

Get-HisDrdaDatabaseAlias

この Get-HisDrdaDatabaseAlias コマンドレットは、SQL Server ストアドプロシージャにマップされている DB2 コマンド用の静的 SQL パッケージを実行するときに使用するために、バインドされたカタログ名とスキーマ名を送信カタログ名とスキーマ名にマッピングするための DRDA サービス構成設定を取得します。

構文

Get-HisDrdaDatabaseAlias [ < commonparameters > ]

パラメーター

[なし] :

出力

この Get-HisDrdaDatabaseAlias コマンドレットは、プロパティのコレクションを含むオブジェクトを返します。 SourceLocation (string);SourceCollection (string);TargetDatabase (string);および TargetSchema (string)。

次のコマンド例では、サンプル値を取得します。

Get-HisDrdaDatabaseAlias
SourceLocation
--------------
CONTOSO

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

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

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

DRDA サービスの日付と時刻の変換

DRDA サービスは、特定の日付と文字のデータ型に対して、動的および静的 SQL ステートメントを処理するときに、文字列リテラルの日付と時刻の値をソース形式とターゲット形式の間で書式設定します。

Add-DrdaDatetimeFormat

この Add-DrdaDatetimeFormat コマンドレットは、db2 および SQL Server date、CHAR (10)、および VARCHAR (10) データ型の文字列リテラルの日付値を処理するための DRDA サービスを構成し、db2 の日付形式から SQL Server 日付形式に変換し、SQL Server の日付形式から db2 日付形式に変換します。 Datemasks には、日付マッピングを定義するための Datemasks 要素が1つ以上含まれています。 dateMask 要素には方向を示す db2ToSql または sqlToDb2 と、マッピングを示す sourceFormat と targetFormat が含まれます。 値の詳細と説明については、「データ統合 (デプロイ)」、「DRDA Service」、「日付と時刻の変換の構成」を参照してください。

構文

Add-DrdaDatetimeFormat 変換 < 変換 > -DateFormat < DateFormats > [ < commonparameters > ]

Add-DrdaDatetimeFormat 変換 < 変換 > -timeformat < timeformat > [ < commonparameters > ]

Add-DrdaDatetimeFormat 変換 <> DateTimeFormat < DateTimeFormats > [ < commonparameters > ]

パラメーター

変換パラメーターは、db2 から SQL または SQL から db2 の方向を定義します。 この 必須 パラメーターは、 列挙 された変換値を受け入れます。 Db2toSqlを指定して、DRDA サービスに対して、バインドされている DateTime 形式を変換するように指示します。 SqlToDb2を指定して、DRDA サービスに対して、アウトバウンドの DateTime 形式を変換するように書き込むように指示します。

DateFormatパラメーターでは、書式の種類を定義します。 この必須パラメーターは、列挙された DateFormat 値を受け入れます。

Timeformatパラメーターは、書式の種類を定義します。 この必須パラメーターは、列挙された Timeformat 値を受け入れます。

DateTimeFormatパラメーターは、書式の種類を定義します。 この必須パラメーターは、列挙された DateTimeFormat 値を受け入れます。

値の詳細と説明については、「データ統合 (デプロイ)」、「DRDA Service」、「日付と時刻の変換の構成」を参照してください。

次のコマンド例では、サンプルの日付値を設定します。

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateFormat Usa

次のコマンド例では、サンプルの Time 値を設定します。

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -TimeFormat HmsPeriod

次のコマンド例では、サンプルの日付値を設定します。

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTimeFormat IsoTimestampFormat

Get-HisDrdaDatetimeFormat

この Get-HisDrdaDatetimeFormat コマンドレットは、db2 および SQL Server date、CHAR (10)、および VARCHAR (10) データ型の文字列リテラルの日付値を処理するための DRDA サービス構成設定を取得し、db2 の日付形式から SQL Server 日付形式に変換し、SQL Server の日付形式から db2 日付形式に変換します。

構文

Get-HisDrdaDatetimeFormat-datetime< datetime > [ < commonparameters > ]

パラメーター

DateTimeパラメーターは、構成された形式変換を返すように DRDA サービスに指示します。 この 必須 パラメーターは、 列挙 された DateTime 値を受け入れます。 既定値はありません。 日付を指定して、構成された日付形式変換を返すように DRDA サービスに指示します。 時刻を指定して、構成された時刻形式の変換を返すように DRDA サービスに指示します。 Datetimeを指定して、構成された datetime 形式の変換を返すように DRDA サービスに指示します。

出力

この Get-HisDrdaDatetimeFormat コマンドレットは、次のプロパティのコレクションを持つオブジェクトを返します: Db2ToSql (string);と SqlToDb2 (string) です。

次のコマンド例では、既定の日付値を取得します。

Get-HisDrdaDatetimeFormat -DateTime Date
Db2ToSql
--------
Iso

SqlToDb2
--------
Iso

次のコマンド例では、既定の時刻値を取得します。

Get-HisDrdaDatetimeFormat -DateTime Date
Db2ToSql
--------
HmsColong
HmsPeriod

SqlToDb2
--------
HmsColon

次のコマンド例では、既定の DateTime 値を取得します。

Get-HisDrdaDatetimeFormat -DateTime Date
Db2ToSql
--------
Db2TimestampFormat

SqlToDb2
--------
Db2TimestampFormat

Remove-HisDrdaDatetimeFormat

この Remove-HisDrdaDatetimeFormat コマンドレットは、db2 および SQL Server date、CHAR (10)、および VARCHAR (10) データ型の文字列リテラルの日付値を処理するための1つ以上の DRDA サービス構成設定を削除し、db2 の日付形式から SQL Server 日付形式に変換し、SQL Server の日付形式から db2 日付形式に変換します。

構文

Remove-HisDrdaDatetimeFormat-datetime<> -変換< 変換 > -書式指定< 文字列 > [ < commonparameters > ]

パラメーター

DateTimeパラメーターは、構成された形式変換を削除するように DRDA サービスに指示します。 この 必須 パラメーターは、 列挙 された DateTime 値を受け入れます。 既定値はありません。 日付を指定して、構成された日付形式変換を削除するように DRDA サービスに指示します。 時刻を指定して、構成された時刻形式変換を削除するように DRDA サービスに指示します。 DRDA サービスに対して、構成された DateTime 形式の変換を削除するように指示する datetime を指定します。

変換パラメーターは、db2 から SQL または SQL から db2 の方向を定義します。 この 必須 パラメーターは、 列挙 された変換値を受け入れます。 Db2toSqlを指定して、DRDA サービスに対して、バインドされている DateTime 形式を変換するように指示します。 SqlToDb2を指定して、DRDA サービスに対して、アウトバウンドの DateTime 形式を変換するように書き込むように指示します。

Format パラメーターでは、書式の種類を定義します。 この必須パラメーターは、列挙された DateFormattimeformat、または DateTimeFormat 値を受け入れます。

次のコマンド例では、サンプルの日付値を削除します。

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

次のコマンド例では、サンプルの Time 値を設定します。

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

次のコマンド例では、サンプルの日付値を設定します。

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

DRDA サービスエンコーディング

DRDA Service は、コードページをマップし、基になる HIS Encoder コンポーネントと Windows National Language Support (NLS) システムコンポーネントを使用して、カスタムコードページ変換をサポートします。 Microsoft Windows Update を使用すると、Windows NLS コードページ変換ライブラリを含む追加の Windows 言語パックをインストールできます。 必要に応じて、HIS エンコーダーは、MsDrdaService.exe.config ファイルのコードページ部分で定義されているコードページの要素に基づいて、カスタム NLS コードページを読み込むことができます。 HIS エンコーダーは、MsDrdaService.exe.config ファイルのコードページ部分で定義されている ebcdicToUnicodeConversion 要素に基づいて、標準 nls およびカスタム NLS コードページ内のコードポイントをカスタムマップできます。 値の詳細と説明については、「サービスエンコーディングの構成」を参照してください。

Add-HisCustomCodePage

この Add-HisCustomCodePage コマンドレットは、カスタム Windows National Language Support (NLS) システムコードページ変換ファイルを読み込むように HIS Encoder コンポーネントに指示するように、DRDA サービスを構成します。

構文

Add-HisCustomCodePage-codepage< uint32 > -Name< string > -nlscodepage< uint32 > [-Description< string > ] [ < commonparameters > ]

パラメーター

CodePageパラメーターは、番号付きカスタム NLS コードページファイルを読み込むように HIS エンコーダーに指示します。 この 必須 パラメーターは 整数を受け取ります。 既定値は 0 です。

Nameパラメーターは、定義されているカスタム nls コードページ番号に基づいて HIS Encoder が読み込むカスタム nls コードページの名前を指定します。 この 必須 パラメーターは 文字列を受け入れます。 既定値は空の文字列です。

nlscodepageパラメーターは、HIS Encoder がカスタムコードページ番号に置き換える標準 NLS コードページ番号を定義します。 この 必須 パラメーターは 整数を受け取ります。 既定値は 0 です。

Descriptionパラメーターは、定義されたカスタム nls コードページ番号に基づいて HIS エンコーダーが読み込むカスタム nls コードページを記述します。 この 省略可能 なパラメーターは 文字列を受け入れます。 既定値は空の文字列です。

次のコマンド例では、サンプル値を設定します。

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

Get-HisCustomCodePage

この Get-HisCustomCodePage コマンドレットは、HIS Encoder コンポーネントに対して、カスタム Windows National Language Support (NLS) システムコードページ変換ファイルを読み込むように指示するための DRDA サービス構成設定を取得します。

構文

Get-HisCustomCodePage [-CodePage< uint32 > ] [-Name< string > ] [-nlscodepage< uint32 > ] [ < commonparameters > ]

パラメーター

CodePage パラメーターは、この番号付きカスタム NLS コード ページ ファイルを使用して構成設定を取得するように DRDA サービスに指示します。 この 省略可能な パラメーターは、整数を受け 取ります。 既定値は 0 です。

Name パラメーター は、このカスタム NLS コード ページ名を使用して構成設定を取得するように DRDA サービスに指示します。 この 省略可能な パラメーターは、文字列を受け取 ります。 既定値は空の文字列です。

NlsCodePage パラメーターは、このカスタム コード ページ番号を使用して構成設定を取得するように DRDA サービスに指示します。 この 省略可能な パラメーターは、整数を受け 取ります。 既定値は 0 です。

出力

このGet-HisCustomCodePageコマンドレットは、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 コマンドレットは、カスタム Windows National Language Support (NLS) システム コード ページ変換ファイルを読み込むよう HIS Encoder コンポーネントに指示する DRDA サービス構成設定を削除します。

構文

Remove-HisCustomCodePage [-Name] <文字列> [<CommonParameters>]

パラメーター

Name パラメーター は、カスタム NLS コード ページ名を使用して構成設定を削除するように DRDA サービスに指示します。 この 必須パラメーター は文字列を受け取 ります。 既定値は空の文字列です。

次のコマンド例では、サンプル値を削除します。

Remove-HisCustomCodePage -Name Custom21140

Add-HisCustomConversion

このAdd-HisCustomConversionコマンドレットは、標準の NLS およびカスタム NLS コード ページ内のコード ポイント マッピングをオーバーライドする DRDA サービスを構成します。

構文

Add-HisCustomConversion -CodePageuint32<> [-EbcdicToUnicodestring<[]>] [-UnicodeToEbcdicstring<[]>] [<CommonParameters>]

Add-HisCustomConversion -Namestring<> [-EbcdicToUnicodestring<[]>] [-UnicodeToEbcdicstring<[]>] [<CommonParameters>]

パラメーター

CodePage パラメーターは、番号が付いた NLS コード ページ ファイルを使用して構成設定を追加するように DRDA サービスに指示します。 この 必須パラメーター は整数を受け 取ります。 既定値は 0 です。

Name パラメーター は、このカスタム NLS コード ページ名ファイルを使用して構成設定を追加するように DRDA サービスに指示します。 この 必須パラメーター は文字列を受け取 ります。 既定値は空の文字列です。

EbcdicToUnicode パラメーターは、指定HIS EBCDIC コード ポイントから変換するようにエンコーダーに指示します。 この省略可能なパラメーターは、"To=From" の形式で文字列値を受け取ります。ここで、"To" は EBCDIC の 16 進コード ポイント値、"From" は Unicode の 16 進コード ポイント値です。 既定値は空の文字列です。

UnicodeToEbcdic パラメーターは、指定HIS Unicode コード ポイントから変換するようにエンコーダーに指示します。 この省略可能なパラメーターは、"To=From" の形式で文字列値を受け取ります。ここで、"To" は Unicode の 16 進コード ポイント値、"From" は EBCDIC の 16 進コード ポイント値です。 既定値は空の文字列です。

Get-HisCustomConversion

このGet-HisCustomConversionコマンドレットは、標準の NLS およびカスタム NLS コード ページ内のコード ポイント マッピングをオーバーライドする DRDA サービス構成設定を取得します。

構文

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

Get-HisCustomConversion -TypeConversionType<> {EbcdicToUnicode |UnicodeToEbcdic} -Name <文字列> [<CommonParameters>]

パラメーター

CodePage パラメーターは、番号が付いた NLS コード ページ ファイルを使用して構成設定を取得するように DRDA サービスに指示します。 この 必須パラメーター は整数を受け 取ります。 既定値は 0 です。

Name パラメーター は、このカスタム NLS コード ページ名ファイルを使用して構成設定を取得するように DRDA サービスに指示します。 この 必須パラメーター は文字列を受け取 ります。 既定値は空の文字列です。

Type パラメーターは、番号が付いた NLS コード ページ ファイルまたはカスタム NLS コード ページ名ファイルを使用して構成設定を取得するように DRDA サービスに指示します。 この 必須パラメーター は、EbcdicToUnicode または UnicodeToEbcdic のいずれかの列挙値を受け取ります。

出力

このGet-HisCustomConversionは、次のプロパティを持つオブジェクトを返します: From (16 進数)。と To (16 進数)。

Remove-HisCustomConversion

このRemove-HisCustomConversionコマンドレットは、標準の NLS およびカスタム NLS コード ページ内のコード ポイント マッピングをオーバーライドする DRDA サービス構成設定を削除します。

構文

Remove-HisCustomConversion -CodePageuint32<> [-EbcdicToUnicodestring<[]>] [-UnicodeToEbcdicstring<[]>] [<CommonParameters>]

Remove-HisCustomConversion -Namestring<> [-EbcdicToUnicodestring<[]>] [-UnicodeToEbcdicstring<[]>] [<CommonParameters>]

パラメーター

CodePage パラメーターは、番号が付いた NLS コード ページ ファイルを使用して構成設定を取得するように DRDA サービスに指示します。 この 必須パラメーター は整数を受け 取ります。 既定値は 0 です。

Name パラメーター は、このカスタム NLS コード ページ名ファイルを使用して構成設定を取得するように DRDA サービスに指示します。 この 必須パラメーター は文字列を受け取 ります。 既定値は空の文字列です。

EbcdicToUnicode パラメーターは、指定HIS EBCDIC コード ポイントから変換するようにエンコーダーに指示します。 この省略可能なパラメーターは、文字列値を 受け取 ります。 既定値は空の文字列です。

UnicodeToEbcdic パラメーターは、指定HIS Unicode コード ポイントから変換するようにエンコーダーに指示します。 この省略可能なパラメーターは、文字列値を 受け取 ります。 既定値は空の文字列です。

DRDA サービス アプリケーションのエンコード

DRDA サービスは、基になる HIS Encoder コンポーネントと Windows National Language Support (NLS) システム コンポーネントを使用して、基本コード ページを変換し、コード ポイントをマップします。 applicationEncodings 要素には、データベースごとに既定のアプリケーション レベルのエンコード スキームを指定する applicationEncoding 要素が含まれています。 値の詳細と説明については、「アプリケーション エンコードの構成」を参照してください。

Add-HisDrdaApplicationEncoding

この Add-HisDrdaApplicationEncoding コマンドレットは、コード ページ内のコード ポイントのマッピングで HIS Encoder コンポーネントと Windows National Language Support (NLS) システム コンポーネントで使用するために、データベースごとに既定のアプリケーション レベルのエンコード スキーム用に DRDA サービスを構成します。 値の詳細と説明については、「アプリケーション エンコードの構成」を参照してください。

構文

Add-HisDrdaApplicationEncoding -Add-HisDrdaApplicationEncoding< duint32> -Databasestring<> [-Schemestring<>] [<CommonParameters>]

Add-HisDrdaApplicationEncoding -Databasestring<> -CustomCcsiduint32<> [-Schemestring<>] [<CommonParameters>]

パラメーター

[Drd] パラメーターは、DRDA AR クライアントが要求した THEDRD ではなく、オーバーライドの (コード化文字セット識別コード) を使用して出力パラメーターと結果セットの値をエンコードするように DRDA サービスに指示します。 この 必須パラメーター は整数を受け 取ります。 既定値は 1208 です

CustomCcsid パラメーターは、DRDA AR クライアントが要求した THEDRD ではなく、オーバーライドカスタムの UTFD (コード化文字セット識別コード) を使用して出力パラメーターと結果セットの値をエンコードするように DRDA サービスに指示します。 この 必須パラメーター は整数を受け 取ります。 既定値は -1 です

Database パラメーターは、指定されたターゲット SQL Server データベースに対してだけ、DRDA AR クライアントが要求したエンコードスキームではなく、オーバーライド エンコード スキームを使用して出力パラメーターと結果セットの値をエンコードするように DRDA サービスに指示します。 この 必須パラメーター は、文字列値を 受け取 ります。 既定値は空の文字列です。

Scheme パラメーターは、DRDA AR クライアントが要求したエンコードスキームではなく、オーバーライド エンコード スキームを使用して出力パラメーターと結果セットの値をエンコードするように DRDA サービスに指示します。 この 省略可能な パラメーターは、文字列値を 受け取 ります。 サポートされている値は Ebcdic、Unicode、 Ansi です。 既定値は Unicode です

次のコマンド例では、サンプル値を設定します。

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

次のコマンド例では、既定値を設定します。

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

Get-HisDrdaApplicationEncoding

この Get-HisDrdaApplicationEncoding コマンドレットは、アプリケーションレベルの既定のエンコードスキームの DRDA サービス構成設定をデータベースごとに取得します。これは、コードページ内のコードポイントをマップするときに、HIS Encoder コンポーネントと Windows National Language Support (NLS) システムコンポーネントによって使用されます。

構文

Get-HisDrdaApplicationEncoding [-Ccsid< uint32 > ] [-Database< string > ] [-customccsid< uint32 > ] [ < commonparameters > ]

パラメーター

Ccsidパラメーターは、DRDA サービスに対して、オーバーライド Ccsid (コード化文字セット識別コード) を使用してアプリケーションエンコード構成を取得するように指示します。 この 省略可能 なパラメーターは 整数を受け取ります。 既定値は 1208です。

Customccsidパラメーターは、DRDA サービスに対して、カスタム CCSID (コード化文字セット識別コード) を使用してアプリケーションエンコード構成を取得するように指示します。 この 省略可能 なパラメーターは 整数を受け取ります。 既定値は -1です。

databaseパラメーターは、DRDA サービスに対して、指定されたターゲット SQL Server データベース名を使用してアプリケーションエンコード構成を取得するように指示します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の文字列です。

出力

この Get-HisDrdaApplicationEncoding コマンドレットは、次のプロパティを持つオブジェクトを返します: Scheme (string);Ccsid (integer);データベース (string);および CustomCcsid (integer)。

次のコマンド例では、サンプル値を取得します。

Get-HisDrdaApplicationEncoding
Scheme
------
Ebcdic
Ebcdic

Ccsid
-----
1140

Database
--------
NWIND1
NWIND1

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

1234

Remove-HisDrdaApplicationEncoding

この Remove-HisDrdaApplicationEncoding コマンドレットは、アプリケーションレベルの既定のエンコードスキームの DRDA サービス構成設定をデータベースごとに削除します。これは、コードページ内のコードポイントをマップするときに、HIS Encoder コンポーネントと Windows National Language Support (NLS) システムコンポーネントによって使用されます。

構文

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

Remove-HisDrdaApplicationEncoding-Customccsid< string [] > [-Database< string > ] [ < commonparameters > ]

パラメーター

Ccsidパラメーターは、オーバーライド Ccsid (コード化文字セット識別コード) を使用して、アプリケーションのエンコード構成を削除するように DRDA サービスに指示します。 この 省略可能 なパラメーターは 整数を受け取ります。 既定値は 1208です。

Customccsidパラメーターは、DRDA サービスに対して、カスタム CCSID (コード化文字セット識別コード) を使用してアプリケーションエンコード構成を削除するように指示します。 この 省略可能 なパラメーターは 整数を受け取ります。 既定値は -1です。

databaseパラメーターは、DRDA サービスに対して、指定されたターゲット SQL Server データベース名を使用してアプリケーションエンコード構成を削除するように指示します。 この 省略可能 なパラメーターは、 文字列 値を受け取ります。 既定値は空の文字列です。

次のコマンド例では、サンプル値を削除します。

Remove-HisDrdaApplicationEncoding -Ccsid 1140

次のコマンド例では、サンプル値を削除します。

Remove-HisDrdaApplicationEncoding -CustomCcsid 1234

DRDA サービスの照合順序マッピング

DRDA Service は、照合順序の構文をマップして、クエリ結果のクロスプラットフォームの互換性を提供します。 値の詳細と説明については、「データ統合 (デプロイ)」、「DRDA Service」、「照合順序マッピングの構成」を参照してください。

Add-HisDrdaCollationName

この Add-HisDrdaCollationName コマンドレットは、db2 order by COLLATION_KEY (collation-name) SQL SQL Server 構文を使用して SELECT ステートメントを変換するための DRDA サービスを構成します。この構文では、db2 照合順序名の値から collation_name SQL Server 値へのマッピングを行い、互換性のあるクエリの結果を提供します。 値の詳細と説明については、「データ統合 (デプロイ)」、「DRDA Service」、「照合順序マッピングの構成」を参照してください。

構文

文字列から文字列へ < の Add-HisDrdaCollationName [ < commonparameters > ] ><>

パラメーター

Toパラメーターは、SQL Server SELECT ORDER by COLLATE 句内の指定された collation_name 文字列に変換するように DRDA Service SQL トランスフォーマーに指示します。 この 必須 パラメーターは、 文字列 値を受け入れます。 既定値はありません。

Fromパラメーターは、DB2 SELECT ORDER BY COLLATION_KEY 句内の指定された照合順序名文字列から変換するように、DRDA Service SQL トランスフォーマーに指示します。 この 必須 パラメーターは、 文字列 値を受け入れます。 既定値はありません。

次のコマンド例では、サンプル値を設定します。

Add-HisDrdaCollationName -From UCA400R1_LEN_AN -To SQL_EBCDIC037_CP1_CS_AS

Get-HisDrdaCollationName

この Get-HisDrdaCollationName コマンドレットは、db2 order by COLLATION_KEY (collation-name) SQL SQL Server 構文を使用して SELECT ステートメントを変換するための DRDA サービス構成設定を取得します。この構文では、db2 照合順序名の値から collation_name SQL Server 値へのマッピングを行い、互換性のあるクエリの結果を提供します。

構文

Get-HisDrdaCollationName[-< 文字列 > ] [-From< string > ] [ < commonparameters > ]

パラメーター

Toパラメーターは、指定された collation_name 文字列を使用して DRDA Service get collation name 構成に指示します。 この 必須 パラメーターは、 文字列 値を受け入れます。 既定値はありません。

Fromパラメーターは、DB2 SELECT order BY COLLATION_KEY 句内で指定された照合順序名の文字列を使用して、DRDA Service get 照合順序名の構成を指示します。 この 必須 パラメーターは、 文字列 値を受け入れます。 既定値はありません。

出力

この Get-HisDrdaCollationName コマンドレットは、プロパティ: To (string); を持つオブジェクトを返します。および From (string) です。

次のコマンド例では、既定値を設定します。

Get-HisDrdaCollationName
To
--
SQL_EBCDIC037_CP1_CS_AS

From
----
UCA400R1_LEN_AN

Remove-HisDrdaCollationName

この Remove-HisDrdaCollationName コマンドレットでは、照合順序名の既定の順序に基づいて、DRDA サービスの構成設定を削除して、COLLATE 句を ORDER BY 句に追加します。

構文

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

パラメーター

Toパラメーターは、指定された collation_name 文字列を使用して、DRDA サービスに照合順序名の構成を削除します。 この 必須 パラメーターは、 文字列 値を受け入れます。 既定値はありません。

Fromパラメーターは、DB2 SELECT order BY COLLATION_KEY 句内で指定された照合順序名の文字列を使用して、DRDA サービスに照合順序名の構成を削除します。 この 必須 パラメーターは、 文字列 値を受け入れます。 既定値はありません。

次のコマンド例では、サンプル値を削除します。

Remove-HisDrdaCollationName -From UCA400R1_LEN_AN

トレース リスナーの構成

DRDA サービスでは、テキストトレースリスナー、コンソールトレースリスナー、カスタムトレースリスナー、Event Trace for Windows (ETW) トレースリスナーなど、複数の同時実行トレースリスナーがサポートされています。 値の詳細と説明については、「データ統合 (配置)」、「DRDA Service」、「トレースリスナーの構成」を参照してください。

Set-HisDrdaConsoleTraceListener

Set-HisDrdaConsoleTraceListener コマンドレットは、DRDA Service コンソールのトレースリスナーを構成して、トレースデータをコマンドコンソールウィンドウに書き込みます。

構文

Set-HisDrdaConsoleTraceListener レベル < の uint32 > [ < commonparameters > ]

パラメーター

Levelパラメーターは、DRDA サービスに対して、定義されている情報のコレクションをトレースの最小レベルから最大レベルまで、トレースするように指示します。 この 必須 パラメーターは 整数 値を受け取ります。 既定値は 0 です。

説明
0 トレースメッセージを出力しません。
1 エラー メッセージを出力します。
2 警告メッセージとエラー メッセージを出力します。
3 情報メッセージ、警告メッセージ、およびエラー メッセージを出力します。
4 すべてのメッセージを出力します。

テーブル AUTONUM \\ アラビア語 トレース レベル.*

次のコマンド例では、サンプル値を設定します。

Set-HisDrdaConsoleTraceListener -Level 3

Set-HisDrdaEtwTraceListener

Set-HisDrdaEtwTraceListener コマンドレットは、ETW セッションを介してトレース データを Windows オペレーティング システム ETW コントローラーに出力する ETW プロバイダーとして DRDA サービス ETW (event Tracing for Windows) を構成します。

構文

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

パラメーター

Level パラメーターは、最小レベルから最大レベルのトレースまで、定義された情報のコレクションをトレースするように DRDA サービスに指示します。 この 必須パラメーター は、整数値を 受け取 ります。 既定値は 0 です。

説明
0 トレース メッセージを出力しません。
1 エラー メッセージを出力します。
2 警告メッセージとエラー メッセージを出力します。
3 情報メッセージ、警告メッセージ、およびエラー メッセージを出力します。
4 すべてのメッセージを出力します。

テーブル AUTONUM \\ アラビア語 トレース レベル.*

次のコマンド例では、サンプル値を設定します。

Set-HisDrdaEtwTraceListener -Level 3

Set-HisDrdaEventLogTraceListener

このSet-HisDrdaEventLogTraceListenerは、DRDA サービス イベント ログ リスナーがログ データをイベント ログに出力Windows構成します。

構文

Set-HisDrdaEventLogTraceListener -InitializeData <文字列> [<CommonParameters>]

パラメーター

InitializeData パラメーターは、定義された情報のコレクションをログに記録するように DRDA サービスに指示します。 この 必須パラメーター は、文字列値を 受け取 ります。 既定値は "Error,Warning,Information" です。これには、すべてのイベント ログ レベルが含まれます。

説明
エラー この値は、エラー レベルのデータのみをログに記録するように DRDA サービスに指示します。
警告 この値は、警告レベルのデータのみをログに記録するように DRDA サービスに指示します。
Information この値は、情報レベルのデータのみをログに記録するように DRDA サービスに指示します

テーブル AUTONUM \\ アラビア語 イベント ログ レベル.*

次のコマンド例では、サンプル値を設定します。

Set-HisDrdaEventLogTraceListener -InitializeData Warning

Set-HisDrdaTextTraceListener

Set-HisDrdaTextTraceListenerコマンドレットは、トレース データをテキスト形式でディスク ファイルに書き込む 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コマンドレットは、指定した種類のトレース リスナーを開始するように DRDA サービスに指示します。

構文

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

パラメーター

Listener パラメーターは、指定されたトレース リスナーの種類を開始するように DRDA サービスに指示します。 この必須パラメーターは、Console、TextEtw、または EventLog のリスナー値を受け取ります。 既定値はありません。

次のコマンド例では、サンプル値を設定します。

Start-HisDrdaTraceListener -Listener Console

次のコマンド例では、サンプル値を設定します。

Start-HisDrdaTraceListener -Listener Text

次のコマンド例では、サンプル値を設定します。

Start-HisDrdaTraceListener -Listener Etw

次のコマンド例では、サンプル値を設定します。

Start-HisDrdaTraceListener -Listener EventLog

Get-HisDrdaTraceListener

このGet-DrdaTextTraceListenerコマンドレットは、トレース データをテキスト形式でディスク ファイルに書き込むテキスト トレース リスナーの DRDA サービス構成設定を取得します。

構文

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

パラメーター

Listener パラメーターは、指定されたトレース リスナーの種類の構成を取得するように DRDA サービスに指示します。 この必須パラメーターは、Console、TextEtw、または EventLog のリスナー値を受け取ります。 既定値はありません。

出力

このGet-HisDrdaTraceListenerは、プロパティのコレクションを返します。

次のコマンド例では、サンプル値を取得します。

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コマンドレットは、指定された種類のトレース リスナーを停止するように DRDA サービスに指示します。

構文

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

パラメーター

Listener パラメーターは、指定されたトレース リスナーの種類の構成を取得するように DRDA サービスに指示します。 この必須パラメーターは、Console、TextEtw、または 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コマンドレットは、バインド ステートメント出力を使用してバインド パッケージを送信SQLオプションのカスタム バインド リスナーに DRDA サービス構成を追加します。

構文

Add-HisDrdaPackageBindListener -TypeNamestring<> [-ThrowWhenNoCallback ] [<CommonParameters>]

パラメーター

TypeName パラメーターは、DRDA サービスのカスタム バインド リスナーの型を定義します。 この 必須パラメーターは 文字列を受け取 ります。 既定値はありません。 カスタム パッケージ バインド リスナー サンプルの Type 値は、"CustomListeners.MyPackageBindListener, CustomListeners, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34013cf74da51d17, processorArchitecture=MSIL" です。

ThrowWhenNoCallback パラメーターは、カスタム バインド リスナー コンポーネントがコールバック インターフェイスに関する情報を返さなかった場合に、DRDA AR クライアントに BGNBNDRM (応答メッセージのバインドを開始する) を返すよう DRDA サービスに指示します。 この 省略可能な パラメーターは、ブール値を 受け取 ります。 既定値は true です。

次のコマンド例では、サンプル値を追加します。

Add-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener -ThrowWhenNoCallback

Get-HisDrdaPackageBindListener

このGet-HisDrdaPackageBindListenerコマンドレットは、オプションのカスタム バインド リスナーにバインド SQL出力を使用してバインド パッケージを送信する DRDA サービス構成設定を取得します。

構文

Get-HisDrdaPackageBindListener [-Typestring<>] [<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 DRDA サービス構成設定を削除して、カスタム トレース リスナーを追加します。

構文

Remove-HisDrdaPackageBindListener -TypeNamestring<> [<CommonParameters>]

パラメーター

Type パラメーター は、DRDA サービスのカスタム バインド リスナーの型を定義します。 この 必須パラメーターは 文字列を受け取 ります。 既定値はありません。 カスタム パッケージ バインド リスナー サンプルの Type 値は、"CustomListeners.MyPackageBindListener, CustomListeners, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34013cf74da51d17, processorArchitecture=MSIL" です。

次のコマンド例では、サンプル値を削除します。

Remove-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener