# Runbooks {% embed url="" %} RealmJoin は管理者に、以下を使用してタスクを自動化する機能を提供します [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) を実行するために [PowerShell Runbooks](https://docs.microsoft.com/en-us/azure/automation/automation-runbook-types#powershell-runbooks). Runbooks はスクリプトであり、通常はサポート エンジニア / オペレーターまたは管理者が実行しなければならないタスクを自動化します。これらのタスクを自動化することで手作業によるエラーのリスクが下がり、操作の監査もしやすくなります。 RealmJoin が自動化の支援に役立つ一般的なタスクには次のようなものがあります: * ユーザーのライフサイクル操作（ユーザーのオンボーディング / オフボーディング） * Temporary Access Pass (TAP) の作成 * M/O365 ライセンス使用状況のレポート * メール エイリアスの管理 RealmJoin Portal をサポート チームおよび管理チームに提供することで、日常業務を簡素化し、品質を向上させることができます。 ![](/files/db088a4e11df893ad699059d3502b506c9852f78) ### PowerShell Runtime Environment への移行 RealmJoin は現在、Windows PowerShell v5.1 から PowerShell v7.4 へ移行中です [Runtime Environment](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment). {% hint style="info" %} Automation Account の「Runtime Environment」エクスペリエンスが有効になっていることを確認してください。 {% endhint %}
実行時に [sync](#syncing-from-the-shared-repository)すると、カスタムの PowerShell Runtime Environment「RJ-PowerShell-7.4」が作成され、同期された runbooks はこの環境へ移動されます。必要に応じて、必要な PowerShell モジュールは自動的にインポートされます。 {% hint style="info" %} 以下の理由により **処理時間が変動するため** 404 などのエラーが発生する可能性があるので、 **もう一度 sync してください**。また、移行後に最初の runbook を開始する前に数分待ってください。 {% endhint %} {% hint style="warning" %} **カスタム / 非同期の runbooks は自動的にはアップグレードされません。** Azure Portal を使用し、これらの runbooks で「Edit in Portal」を使って手動で移行できます。変更を有効にするには、runbooks を必ず「publish」してください。 {% endhint %}
## 一般的な Runbooks RealmJoin は [shared online repository of runbooks](https://github.com/realmjoin/realmjoin-runbooks)を維持しています。これは、多くの環境で見られる一般的な操作を幅広くカバーすることを目的としています。runbooks は継続的に更新・改善されています。もちろん、独自のカスタム runbooks も追加できます。 RealmJoin Portal では、これらの runbooks を次の方法でインポートできます: [RealmJoin Runbook Management App](/ja/zi-dong-hua/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) を使用して環境に取り込み、runbooks が扱うタスクをサポート担当者や管理担当者に対して、簡単で非技術的なインターフェースで提供します。 ### 共有リポジトリからの同期 次の場所で「Sync runbooks with upstream」をクリックすると、共有リポジトリから Azure Automation アカウントへの同期を開始できます: ![runbooks の同期を開始する](/files/e281d271173786c9080cbb8082fc5cc3d4312b49) 「Sync completed」メッセージが表示されるまでお待ちください。同期処理の実行中は、ブラウザー ウィンドウを開いたままにしてください。 次の [命名規則](/ja/zi-dong-hua/runbooks/naming-conventions.md) で説明されているように、これにより接続された Azure Automation Account 内の runbooks が追加・更新され、必要に応じて削除され、RealmJoin の共有リポジトリと同期されます。これにより、改善、修正、新機能を含めて runbooks を最新に保つことができます。 ## カスタマイズ 既存および新規の runbooks は環境に合わせてカスタマイズできます。たとえば、次のようなことが可能です。 * office の場所のような一般的な情報にテンプレートを使用する * オフボーディング時にユーザー オブジェクトの削除を許可しないようにするなど、パラメーターを事前入力 / 事前設定する * 特定の入力 / パラメーターを非表示にする 参照 [Runbook のカスタマイズ ](/ja/zi-dong-hua/runbooks/runbook-customization.md)をご覧ください。 ## スコープ RealmJoin Portal の runbooks は、環境内のさまざまな種類のオブジェクトに対してスコープが設定されています。ライセンス レポートの作成のように、いくつかの runbooks は Tenant / 組織レベルで動作します。パスワードのリセットのように、ユーザー単位でスコープが設定される runbooks もあります。RealmJoin Portal はこのスコープ設定を使用して、適切なコンテキストで適切な runbooks を提供します。 参照 [命名規則](/ja/zi-dong-hua/runbooks/naming-conventions.md) runbooks が環境内の特定のオブジェクトにどのようにスコープ設定されているかを確認するには ## アクセス制御 特定の runbooks を使用するためのアクセス / 権限は、runbook レベルで細かく付与できます。たとえば、Runbook Permissions は次のような場合に役立ちます。 * この runbook へのアクセスを 3 次レベルのオペレーターのみに許可する * CEO のメール アドレスの変更を VIP サポート チームのみに許可する 参照 [Runbook の権限](/ja/zi-dong-hua/runbooks/runbook-permissions.md) このようなルールを環境に実装する方法の詳細については --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.