> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks.md).

# Runbooks

{% embed url="<https://www.youtube.com/watch?v=TfL7xRasVUg>" %}

RealmJoin は管理者に、次を使用してタスクを自動化する機能を提供します [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) を実行するために [PowerShell ランブック](https://docs.microsoft.com/en-us/azure/automation/automation-runbook-types#powershell-runbooks).

ランブックはスクリプトであり、通常はサポートエンジニア／オペレーターまたは管理者が実行しなければならないタスクを自動化します。これらのタスクを自動化することで手作業によるエラーのリスクが低減され、操作の監査性が向上します。

RealmJoin で自動化できる一般的なタスクには、次のようなものがあります:

* ユーザーのライフサイクル操作（ユーザーのオンボーディング／オフボーディング）
* 一時アクセス パス (TAP) の作成
* M/O365 ライセンス使用状況のレポート
* メール エイリアスの管理

RealmJoin Portal をサポートおよび管理チームに提供することで、日常業務を簡素化し、品質を向上させることができます。

![](/files/db088a4e11df893ad699059d3502b506c9852f78)

### PowerShell ランタイム環境への移行

RealmJoin は現在、Windows PowerShell v5.1 から PowerShell v7.4 [ランタイム環境](https://learn.microsoft.com/en-us/azure/automation/manage-runtime-environment).

{% hint style="info" %}
Automation Account で「ランタイム環境」の機能が有効になっていることを確認してください。
{% endhint %}

<figure><img src="/files/651770131ba0b0b49bf511ffaf82808dd4230e61" alt=""><figcaption></figcaption></figure>

次の実行時に [同期](#syncing-from-the-shared-repository)が行われると、カスタムの PowerShell ランタイム環境「RJ-PowerShell-7.4」が作成され、同期されたランブックはこの環境に移動されます。必要に応じて、必要な PowerShell モジュールは自動的にインポートされます。

{% hint style="info" %}
のため、 **処理時間が一定でない** ことがあり、404 などのエラーが発生する可能性があるため、 **もう一度同期してください**。また、移行後に最初のランブックを開始するまで数分お待ちください。
{% endhint %}

{% hint style="warning" %}
**カスタム／非同期のランブックは自動的にはアップグレードされません。**

Azure Portal を使用し、これらのランブックで「Portal で編集」を使って手動で移行できます。変更を有効にするには、ランブックを「公開」することを忘れないでください。
{% endhint %}

<figure><img src="/files/77cbfa79eb8e4f71405378181a007d20540daff2" alt=""><figcaption></figcaption></figure>

## 一般的なランブック

RealmJoin は [ランブックの共有オンラインリポジトリ](https://github.com/realmjoin/realmjoin-runbooks)を管理しています。これは、多くの環境で見られる一般的な操作を幅広くカバーすることを目的としています。ランブックは継続的に更新・改善されています。もちろん、独自のカスタムランブックを追加することもできます。

RealmJoin Portal では、これらのランブックを次を介してインポートできます [RealmJoin Runbook Management App](/ja/zi-dong-hua/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) を環境に取り込み、ランブックがカバーするタスクに対して、サポートおよび管理スタッフにとって使いやすい、技術知識を必要としないインターフェースを提供します。

### 共有リポジトリからの同期

「上流のランブックと同期」をクリックすることで、共有リポジトリから Azure Automation アカウントへ同期を開始できます。

<https://portal.realmjoin.com/settings/general>

![ランブックの同期を開始する](/files/e281d271173786c9080cbb8082fc5cc3d4312b49)

「同期完了」メッセージが表示されるまでお待ちください。同期処理の実行中はブラウザー ウィンドウを開いたままにしてください。

次の [命名規則](/ja/zi-dong-hua/runbooks/naming-conventions.md) に記載のとおり、これにより接続された Azure Automation アカウントのランブックが追加・更新され、必要に応じて削除され、RealmJoin の共有リポジトリと同期されます。これにより、改善、修正、新機能を含め、ランブックが最新の状態に保たれます。

## Customization

既存および新規のランブックを環境に合わせてカスタマイズできます。たとえば、次のことができます

* オフィス所在地などの共通情報にテンプレートを使用する
* オンボーディング解除時にユーザー オブジェクトを削除できないようにするなど、パラメーターを事前入力／事前設定する
* 特定の入力／パラメーターを非表示にする

参照 [ランブックのカスタマイズ ](/ja/zi-dong-hua/runbooks/runbook-customization.md)詳細については。

## スコープ

RealmJoin Portal のランブックは、環境内のさまざまな種類のオブジェクトに対してスコープ設定されています。たとえば、ライセンス レポートの作成のように、テナント／組織レベルで動作するランブックもあります。パスワードのリセットのように、ユーザー単位でスコープ設定されるランブックもあります。RealmJoin Portal はこのスコープ設定を使用して、適切なコンテキストで適切なランブックを提供します。

参照 [命名規則](/ja/zi-dong-hua/runbooks/naming-conventions.md) ランブックが環境内の特定のオブジェクトにどのようにスコープ設定されるかを学ぶには。

## アクセス制御

特定のランブックを使用するためのアクセス／権限は、ランブック単位で細かく付与できます。たとえば、ランブックの権限は次のような場合に役立ちます:

* このランブックへのアクセスを第 3 次対応オペレーターのみに許可する
* CEO のメール アドレスの変更を VIP サポート担当のみ許可する

参照 [ランブックの権限](/ja/zi-dong-hua/runbooks/runbook-permissions.md) そのようなルールを環境に実装する方法の詳細について。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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=<question>
```

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.
