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

# Runbook

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

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 で自動化できる一般的なタスクには、次のようなものがあります:

* ユーザーのライフサイクル操作（ユーザーのオンボーディング／オフボーディング）
* 一時的なアクセス パス（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」が作成され、同期された runbooks はこの環境に移動されます。必要に応じて、必要な PowerShell モジュールが自動的にインポートされます。

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

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

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

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

## 一般的な Runbooks

RealmJoin は、一般的な Runbooks のコレクションを維持しています [共有オンライン runbook リポジトリ](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 が扱うタスクに対する簡単で非技術的なインターフェースを提供します。

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

共有リポジトリから Azure Automation account への同期は、at で「Sync runbooks with upstream」をクリックすることで開始できます

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

![runbooks の同期を開始する](/files/e281d271173786c9080cbb8082fc5cc3d4312b49)

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

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

## カスタマイズ

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

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

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

## スコープ

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

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

## アクセス制御

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

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

参照 [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.
