> 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).

# ランブック

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

RealmJoin では、管理者が次を使用してタスクを自動化できるようになります [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) を実行するために [PowerShell Runbook](https://docs.microsoft.com/en-us/azure/automation/automation-runbook-types#powershell-runbooks).

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

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

* ユーザーのライフサイクル操作（ユーザーのオンボーディング/オフボーディング）
* Temporary Access Pass (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 で「Runtime Environment」エクスペリエンスが有効になっていることを確認してください。
{% endhint %}

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

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

{% hint style="info" %}
〜のため **処理時間のばらつき** により 404 のようなエラーが発生する可能性があるため、 **もう一度同期してください**。また、移行後に最初の runbook を開始する前に数分待ってください。
{% endhint %}

{% hint style="warning" %}
**カスタム / 未同期の runbook は自動的にアップグレードされません。**

これらの runbook では Azure Portal を使用し、「Edit in Portal」から手動で移行できます。変更を有効にするには、runbook を「publish」してください。
{% endhint %}

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

## 共通 Runbook

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

RealmJoin Portal では、これらの runbook を次を介してインポートできます: [RealmJoin Runbook Management App](/ja/zi-dong-hua/connecting-azure-automation/required-permissions.md#b31d828b-8bcb-45fc-8d72-5418777a5376) を環境に取り込み、runbook がカバーするタスクに対して、サポートおよび管理担当者向けの簡単で非技術的なインターフェースを提供します。

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

次の場所で「Sync runbooks with upstream」をクリックすると、共有リポジトリから Azure Automation アカウントへの同期を開始できます:

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

![runbook の同期を開始](/files/e281d271173786c9080cbb8082fc5cc3d4312b49)

「Sync completed」メッセージをお待ちください。同期処理が実行中は、ブラウザー ウィンドウを開いたままにしてください。

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

## Customization

既存および新規の runbook を、環境に合わせてカスタマイズできます。たとえば、次のようなことができます:

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

詳細は [Runbook のカスタマイズ ](/ja/zi-dong-hua/runbooks/runbook-customization.md)詳細については。

## スコープ

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

詳細は [命名規則](/ja/zi-dong-hua/runbooks/naming-conventions.md) runbook が環境内の特定のオブジェクトにどのようにスコープ設定されているかを知るために

## アクセス制御

特定の runbook を使用するためのアクセス/権限は、runbook レベルできめ細かく付与できます。たとえば、Runbook 権限は次のような場面で役立ちます:

* この runbook へのアクセスを第3レベルのオペレーターにのみ許可する
* CEO のメール アドレスの変更を VIP サポート チームのみに許可する

詳細は [Runbook 権限](/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, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
