AddResource コマンド: 証明書
BizTalk アプリケーションにセキュリティ証明書を追加するには、 AddResource コマンドを使用し、Type パラメーターに System.BizTalk:Certificate を 指定します。 このコマンドが適切に機能するためには、ローカル コンピューターの "その他のユーザー" 証明書ストアに証明書が存在している必要があります。
このコマンドを実行すると、該当する証明書が BizTalk 管理データベースに追加されます。 証明書は、BizTalk Server 管理コンソール (追加先アプリケーションのリソース フォルダー) にも表示されます。 さらに、 ListApp コマンドを使用すると、証明書が一覧表示されます。
アプリケーションのインストール時、証明書が、ローカル コンピューターの "その他のユーザー" 証明書ストアにインポートされます。
使用
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Certificate [/Overwrite] /Thumbprint:"value" [/Server:value] [/Database:value]
パラメーター
| パラメーター | 必須 | 値 |
|---|---|---|
| /ApplicationName (または /A、解説を参照) | いいえ | 証明書を追加する BizTalk アプリケーションの名前。 名前にスペースが含まれている場合は、二重引用符 (") で囲む必要があります。 アプリケーション名が指定されなかった場合、グループの既定の BizTalk アプリケーションが使用されます。 |
| /Type (または /Ty、解説を参照) | はい | System.BizTalk:Certificate (この値では大文字と小文字は区別されません)。 |
| /Overwrite (または /O、解説を参照) | いいえ | 既存の証明書を更新するためのオプション。 指定しなかった場合、追加する証明書と同じ拇印 (Thumbprint) プロパティを持つ証明書が既にアプリケーションに存在した場合、追加操作は失敗します。 [証明書] スナップインで証明書をダブルクリックし、[詳細] タブをクリックすると、拇印プロパティを表示できます。詳細については、証明書スナップインのドキュメントの「証明書情報の表示」を参照してください。 |
| /拇印 (または /Th、解説を参照) | はい | 証明書の拇印プロパティ ( 拇印 はデータのダイジェストです)。 この値は、二重引用符 (") で囲む必要があります。 |
| /Server (または /S、解説を参照) | いいえ | BizTalk 管理データベースをホストする SQL Server インスタンスの名前。ServerName\InstanceName,Port の形式で指定します。 インスタンス名の指定は、そのインスタンス名がサーバー名と異なる場合にのみ必要です。 ポートの指定は、SQL Server で使用するポート番号が既定値 (1433) と異なる場合にのみ必要です。 例 : Server=MyServer Server=MyServer\MySQLServer,1533 指定しなかった場合、ローカル コンピューターで実行されている SQL Server インスタンスの名前が使用されます。 |
| /Database (または /D、解説を参照) | いいえ | BizTalk 管理データベースの名前。 指定しない場合は、SQL Serverのローカル インスタンスで実行されている BizTalk 管理データベースが使用されます。 |
サンプル
BTSTask AddResource /ApplicationName:MyApplication /Type: System.BizTalk:Certificate /Overwrite /Thumbprint:"04 a2 8e 32 24 f9 36 b9 42 81 12 71 3a d2 ef db c7 9c 83 dc" /Server:MyDatabaseServer /Database:BizTalkMgmtDb
注釈
パラメーターの大文字と小文字は区別されません。 パラメーター名は、すべて入力する必要はありません。最初の数文字 (一意に特定できるだけの文字数) を入力するだけで構いません。