> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# グループとコラボレーションの管理

export const MultiRelatedLinks = ({sections = []}) => {
  if (!sections || sections.length === 0) {
    return null;
  }
  return <div className="space-y-8">
      {sections.map((section, index) => <RelatedLinks key={index} title={section.title} items={section.items} />)}
    </div>;
};

export const RelatedLinks = ({title, items = []}) => {
  const getBadgeClass = badge => {
    if (!badge) return "badge-default";
    const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
    return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
  };
  if (!items || items.length === 0) {
    return null;
  }
  return <div className="my-8">
      {}
      <h3 className="text-sm font-bold uppercase tracking-wider mb-4">{title}</h3>

      {}
      <div className="flex flex-col gap-3">
        {items.map((item, index) => <a key={index} href={item.href} className="py-2 px-3 rounded related_link hover:bg-[#f2f2f2] dark:hover:bg-[#111827] flex items-center gap-3 group no-underline hover:no-underline border-b-0">
            {}
            <span className={`px-2 py-1 rounded-full text-xs font-semibold uppercase tracking-wide flex-shrink-0 ${getBadgeClass(item.badge)}`}>
              {item.badge}
            </span>

            {}
            <span className="text-base">{item.label}</span>
          </a>)}
      </div>
    </div>;
};

export const Link = ({href, children, className, ...props}) => {
  const localizedHref = localizeLink(href);
  return <a href={localizedHref} className={className} {...props}>
      {children}
    </a>;
};

## スクリプト構造

このスクリプトでは、Box CLIを使用して、グループの作成や更新、グループへのユーザーの追加、グループとフォルダの間のコラボレーションの作成を行います。このスクリプトは、2つのパートから構成されています (以下のセクションで詳しく説明します)。両方のパートを実行することも、オプションのフラグを使用して実行するパートを決めることもできます。

### グループの作成または更新

1. このスクリプトでは、`UserGroupAdditionPath`パラメータに指定した`.csv`ファイルを使用します。このファイルには、グループ名とユーザーのメールアドレスが記載されています。このファイルを作成する際には、複数のユーザーに同じグループ名を使用することも、1人のユーザーを複数のグループに割り当てることもできます。以下に例を示します。

   | `GroupName` | `UserEmail`             |
   | ----------- | ----------------------- |
   | Group1      | `ManagedUser1@test.com` |
   | Group1      | `ManagedUser2@test.com` |
   | Group2      | `ManagedUser3@test.com` |
   | Group3      | `ManagedUser1@test.com` |

2. グループが存在しない場合は、スクリプトによってそのグループが作成されます。グループが存在する場合は、指定したデータに基づいてエントリが更新されます。

### コラボレーションの作成または更新

1. このスクリプトでは、`CollaborationsCreationPath`パラメータに指定した`.csv`ファイルを使用します。このファイルには、グループ名、フォルダID、コラボレーションロールが記載されています。

2. スクリプトでは、行ごとに、グループが存在するかどうか、そのグループがすでに対応するフォルダにコラボレータとして追加されていないかどうかを確認します。以下に例を示します。

   | `GroupName` | `FolderId` | `CollaborationRole` |
   | ----------- | ---------- | ------------------- |
   | Group1      | 1111111    | editor              |
   | Group2      | 1111111    | viewer\_uploader    |
   | Group2      | 2222222    | viewer              |
   | Group3      | 1111111    | viewer\_uploader    |

3. 両方の条件を満たしている場合、`CollaborationRole`列で定義されたロールを使用してグループがフォルダに割り当てられます。また、グループはすでに存在していても、`CollaborationRole`を変更した場合、スクリプトの実行時に`-UpdateExistingCollabs`フラグを渡すと、コラボレーションロールが更新されます。

## 前提条件

### Windows

[.NET Core](https://dotnet.microsoft.com/download)の最新バージョンのインストール

### macOSおよびLinux

[PowerShell][pwsh]をインストールします。`pwsh`コマンドを実行して、インストール結果をテストします。

```bash theme={null}
pwsh
```

どのディレクトリでこのコマンドを実行するかに応じて、出力が異なる場合があります。以下に例を示します。

```bash theme={null}
PowerShell 7.2.5
Copyright (c) Microsoft Corporation.

https://aka.ms/powershell
Type 'help' to get help.

PS /Users/user/repos/boxcli/examples>
```

<message>
  問題が発生する場合は、[.NET Core](https://dotnet.microsoft.com/download)と[PowerShell][pwsh]の両方をインストールしたかどうか確認してください。
</message>

### Box CLI

スクリプトを使用するには、Box CLIをインストールし、構成する必要があります。これを実行するには、<Link href="/guides/cli">クイックスタートガイド</Link>の手順に従います。ログインに使用するユーザーは、Boxのメイン管理者または共同管理者である必要があります。

## スクリプトの構成

1. `boxcli` GitHubリポジトリを複製してこの例のフォルダにcdコマンドで移動するか、[`examples`][examples]ディレクトリからファイルをダウンロードします。

   ```bash theme={null}
   git clone https://github.com/box/boxcli.git boxcli
   cd boxcli/examples/Mass\ Groups\ \&\ Collaborations\ Update/
   ```

2. グループとユーザーのメールアドレスのリストが含まれる`.csv`ファイルのパスを設定します。

   ```bash theme={null}
   $UserGroupAdditionPath = "./User_Group_Addition.csv"
   ```

   * `UserEmail`は、Boxにおけるこのユーザーのプライマリメールアドレスです。
   * `GroupName`は、グループの名前です。

3. グループとユーザーのメールアドレスのリストが含まれる`.csv`ファイルに独自のパスを設定します。

   ```bash theme={null}
   $CollaborationsCreationPath = "./Collaborations_Creation.csv"
   ```

   * `GroupName`は、スクリプトによってフォルダにコラボレータとして追加されるグループの名前です。
   * `FolderId`は、コラボレータの追加先となるフォルダIDです。
   * `CollaborationRole`は、コラボレーションの作成時に使用されるロールの名前です。

   使用可能なロールを設定するには、`AvailableCollaborationRoles`パラメータを設定します。

   ```bash theme={null}
   $AvailableCollaborationRoles = @("editor", "viewer", "previewer", "uploader", "previewer_uploader", "viewer_uploader", "co-owner")
   ```

## スクリプトの実行

1. PowerShellコマンドを実行します。

   ```bash theme={null}
   pwsh
   ```

2. スクリプトを実行します。

   ```bash theme={null}
   ./Mass_Groups_Collabs_Update.ps1
   ```

### オプションのフラグ

フラグを使用すると、スクリプトの特定の部分を実行またはスキップできます。

* グループがすでに特定のフォルダのコラボレータとして設定されているものの、その役割が.`csv`ファイルで定義されたものとは異なる場合は、スクリプトによってそのことが通知されます。スクリプトによって既存のコラボレーションが変更されることはありません。`.csv`ファイルで定義された役割で既存のコラボレーションを更新するには、スクリプトを実行する際に追加の`-UpdateExistingCollabs`フラグを設定します。

  ```bash theme={null}
  Mass_Groups_Collabs_Update.ps1 -UpdateExistingCollabs
  ```

* コラボレーションを作成せずにグループを更新するには、スクリプトの実行時に`-SkipCollabsCreation`ブール値フラグを追加します。

  ```bash theme={null}
  Mass_Groups_Collabs_Update.ps1 -SkipCollabsCreation
  ```

* グループを更新せずにコラボレーションを作成するには、スクリプトの実行時に`-SkipGroupsUpdate`ブール値フラグを追加します。

  ```bash theme={null}
  Mass_Groups_Collabs_Update.ps1 -SkipGroupsUpdate
  ```

## ログ

ログは、メインフォルダ内の`logs`フォルダに格納されます。以下のログファイルにアクセスできます。

* `Mass_Groups_Collabs_Update_all.txt`: すべてのログエントリが含まれています。
* `Mass_Groups_Collabs_Update_errors.txt`: エラーのみが含まれています。

[examples]: https://github.com/box/boxcli/tree/main/examples

[pwsh]: https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-7.2

[console]: https://app.box.com/developers/console

[auth]: /guides/authentication/oauth2/oauth2-setup

<RelatedLinks
  title="関連するガイド"
  items={[
{ label: translate("OAuth 2.0 Auth"), href: "/guides/authentication/oauth2/index", badge: "GUIDE" },
{ label: translate("PowerShell script templates"), href: "/guides/cli/scripts/powershell-script-templates", badge: "GUIDE" },
{ label: translate("Deprovision users and archive folders"), href: "/guides/cli/scripts/deprovision-users", badge: "GUIDE" },
{ label: translate("Update user zones"), href: "/guides/cli/scripts/user-zones-mass-update", badge: "GUIDE" },
{ label: translate("Report inactive users"), href: "/guides/cli/scripts/report-inactive-users", badge: "GUIDE" }
]}
/>
