カスタムスクリプトを用いた外部データベースのプロビジョン/デプロビジョンのオーケストレーション
- MS SQL
- Oracle
- PostgreSQL
ADManager Plusでは、特定のユーザーへのアクションが実行されたときに、カスタムスクリプトでMS SQLデータベースを自動的に更新するオーケストレーションポリシーを作成できます。
以下、機能の概要と作成手順を説明します。
オーケストレーションの挙動
データベースでユーザーを特定するために、ユーザー固有の引数が使われます。
送られたリクエストを基に対象の製品でアクションが実行されます。
- 「insert」リクエストが開始されたときは、データベーステーブルに行が挿入され、リクエストで指定された値が指定された列に追加されます。
- 「update」リクエストが開始されたときは、指定された列の値が、リクエストで指定された値で置き換えられます。
- 「delete」リクエストが開始されたときは、データベースから指定された行または列が削除されます。
前提条件
SQLスクリプトをダウンロードして以下のフォルダーに配置していることを確認してください。
インストールディレクトリ\ADManager Plus\Scripts
オーケストレーションの作成手順
カスタムスクリプトを用いたオーケストレーションテンプレートを作成します。
- ADManager Plusにログインし、[自動化]タブに移動します。
- 左ペインで、[設定]配下の[オーケストレーションテンプレート]をクリックします。
- [新しいテンプレートを作成]をクリックします。
- 「テンプレート名」を入力します。
- 「カスタムアクション」配下の[カスタムスクリプト]ブロックをドラック&ドロップで追加し、以下の項目を入力して、[保存]をクリックします。
- 「ブロック名」ブロックの名称を入力します。
- 「説明」実行されるアクションを説明します。
- 「スクリプトの種類」ドロップタウンリストから、スクリプトの種類として「Powershell」を選択します。
- 「スクリプト パス」絶対ファイルパスまたはファイル名を入力します。
例:MSSQL_Insert.ps1、MSSQL_Update.ps1、MSSQL_Delete.ps1 - 「引数」コンマで区切り引数を入力します。リクエストで使用できる引数のリストは以下の表のとおりです。
アクション 引数 例 Insert サーバー名,データベース名,ポート番号,認証タイプ,テーブル名,列の名称,列の値,ユーザー名,パスワード Windows認証
"EmpServer", "Empdata", "1433", "Windows", "Users", "col1|col2", "%employeeID%|%telephoneNumber%"
サーバー認証
"EmpServer", "Empdata", "1433", "Server", "Users", "col1|col2", "%employeeID%|%telephoneNumber%", "sa", "Test@123"Update サーバー名,データベース名,ポート番号,認証タイプ,テーブル名,列の名称,列の値,クエリの場所,ユーザー名,パスワード Windows認証
"EmpServer", "Empdata","1433" "Windows","Users","col1|col2" "%employeeID%|%telephoneNumber%","samAccountName='%sAMAccountName%'"
サーバー認証
"EmpServer", "Empdata","1433","Server","Users" "col1|123col2" ,"%employeeID%|%telephoneNumber%" ,"samAccountName='%sAMAccountName%'","sa","Test@"Delete サーバー名,データベース名,ポート番号,認証タイプ,テーブル名,クエリの場所,ユーザー名,パスワード Windows認証
"EmpServer","Empdata","1433","Windows","Users","samAccountName='%sAMAccountName%'"
サーバー認証
"EmpServer","Empdata","1433","Server" ,"Users","samAccountName='%sAMAccountName%'","sa","Test@123"
オーケストレーションテンプレートが実行される条件を設定するイベントドリブンオートメーションを作成します。
- adminとしてADManager Plusにログインします。
- [自動化]タブ→[自動化]→[イベントドリブンオートメーション]に移動します。
- ページ右上の[新しい自動化を作成する]ボタンをクリックします。
- 「オートメーション名」と[説明]を入力します。
- テンプレートを実行する条件を「基準」フィールドで追加します。
例1:「操作」[は]「シングルユーザーの作成」
例2:「操作」[は]「複数ユーザーの作成」 - 「オーケストレーションテンプレート」で、作成したオーケストレーションテンプレートをリストから追加します。
- [保存]をクリックします。
ADManager Plusでは、特定のユーザーへのアクションが実行されたときに、カスタムスクリプトでOracleデータベースを自動的に更新するオーケストレーションを作成できます。
以下、機能の概要と作成手順を説明します。
オーケストレーションの挙動
データベースでユーザーを特定するために、ユーザー固有の引数が使われます。
送られたリクエストを基に対象の製品でアクションが実行されます。
- 「insert」リクエストが開始されたときは、データベーステーブルに行が挿入され、リクエストで指定された値が指定された列に追加されます。
- 「update」リクエストが開始されたときは、指定された列の値が、リクエストで指定された値で置き換えられます。
- 「delete」リクエストが開始されたときは、データベースから指定された行または列が削除されます。
前提条件
- Oracle.DataAccess.dllを{Oracle-Home}\ODP.NET\bin\4\からコピーして、インストールディレクトリ\ADManager Plus\binフォルダーにペーストします。
- Oracleスクリプトをダウンロードして以下のフォルダーに配置します。
インストールディレクトリ\ADManager Plus\Scripts
オーケストレーションの作成手順
カスタムスクリプトを用いたオーケストレーションテンプレートを作成します。
- ADManager Plusにログインし、[自動化]タブに移動します。
- 左ペインで、[設定]配下の[オーケストレーションテンプレート]をクリックします。
- [新しいテンプレートを作成]をクリックします。
- 「テンプレート名」を入力します。
- 「カスタムアクション」配下の[カスタムスクリプト]ブロックをドラック&ドロップで追加し、以下の項目を入力して、[保存]をクリックします。
- 「ブロック名」カスタムスクリプトブロックの名称を入力します。
- 「説明」実行されるアクションを説明します。
- 「スクリプトの種類」ドロップタウンリストから、スクリプトの種類として「Powershell」を選択します。
- 「スクリプト パス」絶対ファイルパスまたはファイル名を入力します。
例: Oracle_Insert.ps1、Oracle_Update.ps1、Oracle_Delete.ps1 - 「引数」コンマで区切り引数を入力します。リクエストで使用できる引数のリストは以下の表のとおりです。
アクション 引数 例 Insert ホストID,ポート番号,サービス名,ユーザー名, パスワード,DBA権限,テーブル名,列の名称,列の値 "localhost", "1521", "sys", "Oracle", "orcl.test", "SYSDBA" "Users", "col1|col2", "%employeeID%|%telephoneNumber%" Update ホストID,ポート番号,サービス名,ユーザー名, パスワード,DBA権限,テーブル名,列の名称,列の値,クエリの場所 "localhost", "1521", "sys", "Oracle", "orcl.test", "SYSDBA" "Users", "col1|col2", "%employeeID%|%telephoneNumber%", "samAccountName='%sAMAccountName%'" Delete ホストID,ポート番号,サービス名,ユーザー名, パスワード,DBA権限,テーブル名,クエリの場所 "localhost", "1521", "sys", "Oracle", "orcl.test", "SYSDBA" "Users", "samAccountName='%sAMAccountName%'"
オーケストレーションテンプレートが実行される条件を設定したイベントドリブンオートメーションを作成します。
- adminとしてADManager Plusにログインします。
- [自動化]タブ→[自動化]→[イベントドリブンオートメーション]に移動します。
- ページ右上の[新しい自動化を作成する]ボタンをクリックします。
- 「オートメーション名」と[説明]を入力します。
- テンプレートを実行する条件を「基準」フィールドで設定します。
例1:「操作」[は]「シングルユーザーの作成」
例2:「操作」[は]「複数ユーザーの作成」 - 「オーケストレーションテンプレート」で、作成したオーケストレーションテンプレートをリストから追加します。
- [保存]をクリックします。
ADManager Plusでは、特定のユーザーへのアクションが実行されたときに、カスタムスクリプトでPostgreSQLデータベースを自動的に更新するオーケストレーションを作成できます。
以下、機能の概要と作成手順を説明します。
オーケストレーションの挙動
データベースでユーザーを特定するために、ユーザー固有の引数が使われます。
送られたリクエストを基に対象の製品でアクションが実行されます。
- 「insert」リクエストが開始されたときは、データベーステーブルに行が挿入され、リクエストで指定された値が指定された列に追加されます。
- 「update」リクエストが開始されたときは、指定された列の値が、リクエストで指定された値で置き換えられます。
- 「delete」リクエストが開始されたときは、データベースから指定された行または列が削除されます。
前提条件
自動更新を準備する前に以下の手順が完了していることを確認してください。
- PostgreSQL ODBCドライバーをこちらからダウンロードしインストールします。
- PostgreSQLスクリプトをダウンロードして以下のフォルダーに配置します。
インストールディレクトリ\ADManager Plus\Scripts
オーケストレーションの作成手順
カスタムスクリプトを用いたオーケストレーションテンプレートを作成します。
- ADManager Plusにログインし、[自動化]タブに移動します。
- 左ペインで、[設定]配下の[オーケストレーションテンプレート]をクリックします。
- [新しいテンプレートを作成]をクリックします。
- 「テンプレート名」を入力します。
- 「カスタムアクション」配下の[カスタムスクリプト]ブロックをドラック&ドロップで追加し、以下の項目を入力して、[保存]をクリックします。
- 「ブロック名」カスタムスクリプトブロックの名称を入力します。
- 「説明」実行されるアクションを説明します。
- 「スクリプトの種類」ドロップタウンリストから、スクリプトの種類として「Powershell」を選択します。
- 「スクリプト パス」絶対ファイルパスまたはファイル名を入力します。
例:PostgreSQL_Insert.ps1、PostgreSQL_Update.ps1、PostgreSQL_Delete.ps1 - 「引数」コンマで区切り引数を入力します。リクエストで使用できる引数のリストは以下の表のとおりです。
アクション 引数 例 Insert ドライバー名,サーバー,ポート番号,データベース,ユーザー名,パスワード,テーブル名,列の名称,列の値 "PostgreSQL Unicode(x64)", "TestServer1", "45678", "TestDB", "loginUser", "Test@123" "Users", "col1|col2", "%employeeID%|%telephoneNumber%" Update ドライバー名,サーバー,ポート番号,データベース,ユーザー名,パスワード,テーブル名,列の名称,列の値,クエリの場所 "PostgreSQL Unicode(x64)", "TestServer1", "45678", "TestDB", "loginUser", "Test@123" "Users", "col1|col2", "%employeeID%|%telephoneNumber%" "samAccountName='%sAMAccountName%'" Delete ドライバー名,サーバー,ポート番号,データベース,ユーザー名,パスワード,テーブル名,クエリの場所 "PostgreSQL Unicode(x64)", "TestServer1", "45678", "TestDB", "loginUser", "Test@123" "Users", "samAccountName='%sAMAccountName%'"
オーケストレーションテンプレートが実行される条件を設定したイベントドリブンオートメーションを作成します。
- adminとしてADManager Plusにログインします。
- [自動化]タブ→[自動化]→[イベントドリブンオートメーション]に移動します。
- ページ右上の[新しい自動化を作成する]ボタンをクリックします。
- 「オートメーション名」と[説明]を入力します。
- テンプレートを実行する条件を「基準」フィールドで設定します。
例1:「操作」[は]「シングルユーザーの作成」
例2:「操作」[は]「複数ユーザーの作成」 - 「オーケストレーションテンプレート」で、作成したオーケストレーションテンプレートをリストから追加します。
- [保存]をクリックします。