ユーザーのゾーンの更新
ユーザーのゾーンの更新
このスクリプトは、マルチゾーンのBoxテナント内の特定のデータ保管場所のゾーンにユーザーをプロビジョニングします。スクリプトによって以下の手順が実行されます。
- 管理者または共同管理者のログインメールアドレスを使用して、関連付けられた企業とその企業に割り当てられているゾーンポリシーを検索します。割り当てられているゾーンポリシーは、特に指定がない限り、すべてのユーザーが継承します。これは、デフォルトゾーンとも呼ばれることもあります。
- ユーザーのメールアドレスとゾーンマッピングが含まれる入力
.csv
ファイルに基づいて、ゾーン割り当てを行います。
ゾーンの割り当てに管理コンソールを使用する場合は、こちらのガイドを参照してください。Box Zonesの詳細については、公式ウェブサイトを参照してください。
前提条件
Windows
.NET Coreの最新バージョンのインストール
macOSおよびLinux
PowerShellをインストールします。pwsh
コマンドを実行して、インストール結果をテストします。
pwsh
どのディレクトリでこのコマンドを実行するかに応じて、出力が異なる場 合があります。以下に例を示します。
PowerShell 7.2.5
Copyright (c) Microsoft Corporation.
https://aka.ms/powershell
Type 'help' to get help.
PS /Users/user/repos/boxcli/examples>
JWT認証を使用するアプリケーションの設定
このスクリプトを使用するには、JWT認証を使用するBox CLIをインストールし、構成する必要があります。
アプリを作成する際は、[構成] タブで以下の設定を構成します。
- [アプリアクセスレベル] で [
App + Enterprise Access
] を選択します。 - [アプリケーションスコープ] > [管理操作] の順に移動して、[
Manage Enterprise Properties
]、[Manage Users
] を選択します。 - [高度な機能] で [
Generate user access tokens
] を選択します。
管理者設定の調整
Boxの管理者または共同管理者にManage Users
以上の権限があることを確認します。この設定を確認するには、以下の手順に従います。
- 管理コンソールの [ユーザーとグループ] セクションに移動します。
- 確認するユーザーアカウントをクリックします。
- [ユーザーアクセス権限を編集] セクションに移動して、ユーザーとグループに管理者権限を付与します。
.csv
ファイルの準備
.csv
ファイルには、EmailとRegionというヘッダーを設定した2つの列が必要です。
- Email列には、Boxユーザーのプライマリメールアドレスを含めます。
- Region列には、スクリプトでユーザーを割り当てるゾーンのユーザーフレンドリ名 (ユーザーが理解しやすい名前) を含めます。この名前は、ゾーンの定義に使用するZonesTableというハッシュテーブルで指定します。キーはゾーンのユーザーフレンドリ名であり、対応する値はゾーンのグローバルIDです。
$ZonesTable = @{
US = "100001" #US
GermanyIreland = "100002" #Germany/Ireland with in region uploads/downloads/previews
Australia = "100003" #Australia
Japan = "100004" #Japan with in region uploads/downloads/previews
Canada = "100005" #Canada
JapanSingapore = "100007" #Japan/Singapore with in region uploads/downloads/previews
UKGermany = "100008" #UK/Germany
UK = "100009" #UK with in region uploads/downloads/previews
France = "100012" #France
}
このスクリプトには、以下のようなメールアドレスとゾーン名が含まれているサンプル入力.csv
ファイルが用意されています。
Region | |
---|---|
betty@company.com | US |
roger@company.com | France |
sally@company.com | JapanSingapore |
スクリプトの構成
この.csv
ファイルを指すようにUserZonesUpdatePath
を設定します。
$UserZonesUpdatePath = "./your_file_name.csv"
adminEmail
を、このスクリプトでゾーンの割り当てに使用するアカウントの管理者またはco-admin
のログインメールアドレスに更新します。この値を指定しない場合、スクリプト実行時に指定するよう求められます。
$adminEmail = "john@box.com"
スクリプトの実行
PowerShellコマンドを実行します。
pwsh
スクリプトを実行します。
./Mass_Update_User_Zones.ps1
オプションのフラグ
シミュレーションモードでスクリプトを実行するには、simulate
ブール値フラグを追加します。
./Mass_Update_User_Zones.ps1 -DryRun
ログ
ログは、メインフォルダ内のlogs
フォルダに格納されます。以下のログファイルにアクセスできます。
Mass_Update_User_Zones_all.txt
: すべてのログエントリが含まれています。Mass_Update_User_Zones_errors.txt
: エラーのみが含まれています。