watermint toolbox - The multi-purpose utility command-line tool for web services

メンバー管理コマンド

情報コマンド

以下のコマンドは、チームメンバーの情報を取得するためのものです.

コマンド 説明
dropbox team member list チームメンバーの一覧
dropbox team member feature メンバーの機能設定一覧
dropbox team member folder list 各メンバーのフォルダーを一覧表示
dropbox team member quota list メンバーの容量制限情報を一覧します
dropbox team member quota usage チームメンバーのストレージ利用状況を取得
dropbox team activity user ユーザーごとのアクティビティ

基本管理コマンド

以下のコマンドは、チームメンバーのアカウントを管理するためのものです. これらのコマンドは、CSVファイルによる一括処理を行うためのものです.

コマンド 説明
dropbox team member batch invite メンバーを招待します
dropbox team member batch delete メンバーを削除します
dropbox team member batch detach Dropbox for teamsのアカウントをBasicアカウントに変更する
dropbox team member batch reinvite 招待済み状態メンバーをチームに再招待します
dropbox team member update batch email メンバーのメールアドレス処理
dropbox team member update batch profile メンバーのプロフィール変更
dropbox team member update batch visible メンバーへのディレクトリ制限を無効にします
dropbox team member update batch invisible メンバーへのディレクトリ制限を有効にします
dropbox team member quota batch update チームメンバーの容量制限を変更

メンバープロファイル設定コマンド

メンバープロフィールコマンドは、メンバーのプロフィール情報を一括して更新するためのものです. メンバーのメールアドレスを更新する必要がある場合は、member update emailコマンドを使用します. コマンドmember update emailは、CSVファイルを受信してメールアドレスを一括更新します. メンバーの表示名を更新する必要がある場合は、member update profileコマンドを使用します.

コマンド 説明
dropbox team member update batch email メンバーのメールアドレス処理
dropbox team member update batch profile メンバーのプロフィール変更

メンバーのストレージ クォータ制御コマンド

dropbox team member quota listdropbox team member quota usage コマンドを使えば、既存のメンバーのストレージクォータの設定や使用状況を見ることができる。メンバーのクォータを更新する必要がある場合は、dropbox team member quota updateコマンドを使用します。コマンド dropbox team member quota update はストレージのクォータ設定を一括更新するためにCSV入力を受け取ります。

コマンド 説明
dropbox team member quota list メンバーの容量制限情報を一覧します
dropbox team member quota usage チームメンバーのストレージ利用状況を取得
dropbox team member quota batch update チームメンバーの容量制限を変更

メンバーの一時停止/停止解除には、2種類のコマンドがあります. メンバーを一人ずつサスペンド/アンサスペンドしたい場合は、dropbox team member suspend または dropbox team member unsuspend を使ってください。その他、CSVファイルを通してメンバーのサスペンド/アンサスペンドを行いたい場合は、dropbox team member batch suspendまたはdropbox member batch unsuspendコマンドを使用してください。

メンバーの一時停止/停止解除

コマンド 説明
dropbox team member suspend メンバーの一時停止処理
dropbox team member unsuspend メンバーの一時停止を解除する
dropbox team member batch suspend メンバーの一括一時停止
dropbox team member batch unsuspend メンバーの一括停止解除

ディレクトリ制限コマンド

ディレクトリ制限は、Dropbox for teamsの機能で、メンバーを他のメンバーから隠すことができます。以下のコマンドは、この設定を更新して、他の人からメンバーを隠したり、設定を解除したりします.

コマンド 説明
dropbox team member update batch visible メンバーへのディレクトリ制限を無効にします
dropbox team member update batch invisible メンバーへのディレクトリ制限を有効にします

グループのコマンド

グループ管理コマンド

以下のコマンドはグループを管理するためのものです.

コマンド 説明
dropbox team group add グループを作成します
dropbox team group batch add グループの一括追加
dropbox team group batch delete グループの削除
dropbox team group delete グループを削除します
dropbox team group list グループを一覧
dropbox team group rename グループの改名
dropbox team group update type グループ管理タイプの更新

グループメンバー管理コマンド

グループメンバーの追加・削除・更新は、以下のコマンドで行うことができます. CSVファイルでグループメンバーを追加・削除・更新したい場合は、dropbox team group member batch adddropbox team group member batch deletedropbox team group member batch deleteを使用します。

コマンド 説明
dropbox team group member add メンバーをグループに追加
dropbox team group member delete メンバーをグループから削除
dropbox team group member list グループに所属するメンバー一覧を取得します
dropbox team group member batch add グループにメンバーを一括追加
dropbox team group member batch delete グループからメンバーを削除
dropbox team group member batch update グループからメンバーを追加または削除

未使用のグループの検索と削除

未使用のグループを探すには2つのコマンドがあります. 最初のコマンドはdropbox team group listである。dropbox team group listコマンドは各グループのメンバー数を表示します。0の場合は、フォルダに権限を追加するためのグループが現在使用されていません. どのフォルダが各グループを使用しているかを確認したい場合は、dropbox team group folder listコマンドを使用します。dropbox team group folder listはグループとフォルダのマッピングを報告します。group_with_no_foldersというレポートでは、フォルダがないグループが表示されます. グループの削除は、メンバー数とフォルダ数の両方を確認すれば、安全に行うことができます. 確認後、dropbox team group batch deleteコマンドを使ってグループを一括削除することができます。

コマンド 説明
dropbox team group list グループを一覧
dropbox team group folder list 各グループのフォルダーを一覧表示
dropbox team group batch delete グループの削除

チームコンテンツのコマンド

管理者はDropbox Business APIを通じて、チームフォルダ、共有フォルダ、メンバーフォルダのコンテンツを扱うことができます。これらのコマンドの使用には注意が必要です. 名前空間とは、Dropbox APIの中で、フォルダの権限や設定を管理するための用語です. 共有フォルダ、チームフォルダ、チームフォルダ内のネストしたフォルダ、メンバーのルートフォルダ、メンバーのアプリフォルダなどのフォルダタイプは、すべて名前空間として管理されます. 名前空間コマンドでは、チームフォルダやメンバーズフォルダなど、あらゆる種類のフォルダを扱うことができます. しかし、特定のフォルダタイプのコマンドは、より多くの機能や詳細な情報がレポートに含まれています.

チームフォルダ操作コマンド

以下のコマンドを使って、チームフォルダーの作成、アーカイブ、完全に削除ができます. 複数のチームフォルダを処理する必要がある場合は、dropbox team teamfolder batchコマンドの使用を検討してください。

コマンド 説明
dropbox team teamfolder add チームフォルダを追加します
dropbox team teamfolder archive チームフォルダのアーカイブ
dropbox team teamfolder batch archive 複数のチームフォルダをアーカイブします
dropbox team teamfolder batch permdelete 複数のチームフォルダを完全に削除します
dropbox team teamfolder batch replication チームフォルダの一括レプリケーション
dropbox team teamfolder file size チームフォルダのサイズを計算
dropbox team teamfolder list チームフォルダの一覧
dropbox team teamfolder permdelete チームフォルダを完全に削除します
dropbox team teamfolder policy list チームフォルダのポリシー一覧
dropbox team teamfolder sync setting list チームフォルダーの同期設定を一覧表示
dropbox team teamfolder sync setting update チームフォルダ同期設定の一括更新

チームフォルダの権限コマンド

チームフォルダーやサブフォルダーにメンバーを一括で追加・削除するには、以下のコマンドを使います.

コマンド 説明
dropbox team teamfolder member list チームフォルダのメンバー一覧
dropbox team teamfolder member add チームフォルダへのユーザー/グループの一括追加
dropbox team teamfolder member delete チームフォルダからのユーザー/グループの一括削除

チームフォルダと共有フォルダのコマンド

以下のコマンドは、チームフォルダとチームの共有フォルダの両方に対応しています. 特定のフォルダーを実際に使用している人を知りたい場合は、dropbox team content mount listコマンドの使用を検討してください。マウントは、ユーザーが自分のDropboxアカウントに共有フォルダを追加した状態です.

コマンド 説明
dropbox team content member list チームフォルダや共有フォルダのメンバー一覧
dropbox team content member size チームフォルダや共有フォルダのメンバー数をカウントする
dropbox team content mount list チームメンバーのマウント済み/アンマウント済みの共有フォルダをすべてリストアップします.
dropbox team content policy list チームフォルダと共有フォルダのポリシー一覧

名前空間コマンド

コマンド 説明
dropbox team namespace list チーム内すべての名前空間を一覧
dropbox team namespace summary チーム・ネームスペースの状態概要を報告する.
dropbox team namespace file list チーム内全ての名前空間でのファイル・フォルダを一覧
dropbox team namespace file size チーム内全ての名前空間でのファイル・フォルダを一覧
dropbox team namespace member list チームフォルダ以下のファイル・フォルダを一覧

チームのファイルリクエスト コマンド

コマンド 説明
dropbox team filerequest list チームないのファイルリクエストを一覧します

メンバーファイルのコマンド

コマンド 説明
dropbox team member file permdelete チームメンバーの指定したパスのファイルまたはフォルダを完全に削除します

チーム インサイト

チーム インサイトは Dropbox Business の機能で、チーム フォルダのサマリーを表示します.

コマンド 説明
dropbox team insight scan チームデータをスキャンして分析
dropbox team insight scanretry 前回のスキャンでエラーがあった場合、スキャンを再試行する
dropbox team insight summarize 分析のためにチームデータをまとめる
dropbox team insight report teamfoldermember チームフォルダーメンバーを報告

チーム共有リンクコマンド

チーム共有リンクコマンドは、チーム内のすべての共有リンクを一覧表示したり、指定した共有リンクを更新・削除することができます.

コマンド 説明
dropbox team sharedlink list 共有リンクの一覧
dropbox team sharedlink cap expiry チーム内の共有リンクに有効期限の上限を設定
dropbox team sharedlink cap visibility チーム内の共有リンクに可視性の上限を設定
dropbox team sharedlink update expiry チーム内の公開されている共有リンクについて有効期限を更新します
dropbox team sharedlink update password 共有リンクのパスワードの設定・更新
dropbox team sharedlink update visibility 共有リンクの可視性の更新
dropbox team sharedlink delete links 共有リンクの一括削除
dropbox team sharedlink delete member メンバーの共有リンクをすべて削除

コマンド dropbox team sharedlink update は共有リンクに値を設定するためのコマンドです。コマンド dropbox team sharedlink cap は共有リンクに上限値を設定するためのコマンドです。 例えば、dropbox team sharedlink update expiryで有効期限を2021-05-06に設定した場合。このコマンドは、既存のリンクが2021-05-04のように短い有効期限を持っている場合でも、有効期限を2021-05-06に更新します. 一方、dropbox team sharedlink cap expiryは、リンクの有効期限が2021-05-07のように長い場合、リンクを更新する。

同様に、dropbox team sharedlink cap visibilityコマンドは、リンクが保護されている可視性が低い場合にのみ可視性を制限します。例えば、パスワードのない共有リンクをteam_onlyにしたい場合などです. dropbox team sharedlink cap visibility` は、リンクが公開されていてパスワードがない場合にのみ、チームの可視性を更新します。

例(リンクの一覧):

チーム内のすべてのパブリックリンクをリストアップ:

tbx team sharedlink list -visibility public

結果は、CSV、xlsx、JSON形式で保存されます. 共有リンクを更新するためのレポートを変更することができます. jqというコマンドに慣れていれば、以下のように直接CSVファイルを作成することができます.

tbx team sharedlink list -output json | jq '.sharedlink.url' > all_links.csv

リンク所有者のメールアドレスでフィルタリングされたリンクを一覧表示します:

tbx team sharedlink list -output json | jq 'select(.member.profile.email == "username@example.com") | .sharedlink.url'

例(リンクの削除):

CSVファイルに記載されているすべてのリンクを削除する

tbx team sharedlink delete links -file /PATH/TO/DATA.csv

jqコマンドに慣れていれば、以下のようにパイプから直接データを送ることができます(標準入力から読み込む場合は、-fileオプションにシングルダッシュ -を渡します).

tbx team sharedlink list -visibility public -output json | tbx team sharedlink delete links -file -

ファイルロック

ファイルロックコマンドは、現在のファイルロックを一覧表示したり、管理者としてファイルロックを解除することができます.

メンバーのファイルロックコマンド

コマンド 説明
dropbox team member file lock all release メンバーのパスの下にあるすべてのロックを解除します
dropbox team member file lock list パスの下にあるメンバーのロックを一覧表示
dropbox team member file lock release メンバーとしてパスのロックを解除します

チームフォルダのファイルロックコマンド

コマンド 説明
dropbox team teamfolder file list チームフォルダの一覧
dropbox team teamfolder file lock all release チームフォルダのパスの下にあるすべてのロックを解除する
dropbox team teamfolder file lock list チームフォルダ内のロックを一覧表示
dropbox team teamfolder file lock release チームフォルダ内のパスのロックを解除

アクティビティ ログ コマンド

チーム活動ログのコマンドでは、特定のフィルターや視点で活動ログをエクスポートすることができます.

コマンド 説明
dropbox team activity batch user 複数ユーザーのアクティビティを一括取得します
dropbox team activity daily event アクティビティーを1日ごとに取得します
dropbox team activity event イベントログ
dropbox team activity user ユーザーごとのアクティビティ

接続されたアプリケーションとデバイスのコマンド.

以下のコマンドは、チーム内で接続されているデバイスやアプリケーションの情報を取得することができます.

コマンド 説明
dropbox team device list チーム内全てのデバイス/セッションを一覧します
dropbox team device unlink デバイスのセッションを解除します
dropbox team linkedapp list リンク済みアプリを一覧
dropbox team backup device status Dropbox バックアップ デバイスのステータスが指定期間内に変更された場合

その他の使用例

External ID

External IDは、Dropboxのどのユーザーインターフェースにも表示されない属性です. この属性は、Dropbox AD ConnectorなどのID管理ソフトウェアによって、DropboxとIDソース(Active Directoryや人事データベースなど)との関係を維持するためのものです. Dropbox AD Connectorを使用していて、新しいActive Directoryツリーを構築した場合は、以下のようになります. 古いActive Directoryツリーと新しいツリーとの関係を切断するために、既存の外部IDをクリアする必要があるかもしれません. External IDのクリアを省略すると、Dropbox AD Connectorが新しいツリーへの構成中に意図せずアカウントを削除してしまう可能性があります. 既存の外部IDを見たい場合は、dropbox team member listコマンドを使ってください。しかし、このコマンドはデフォルトでは外部IDを含みません. 以下のようにexperiment report_all_columnsオプションを追加してください

tbx member list -experiment report_all_columns
コマンド 説明
dropbox team member list チームメンバーの一覧
dropbox team member clear externalid メンバーのexternal_idを初期化します
dropbox team member update batch externalid チームメンバーのExternal IDを更新します.
dropbox team group list グループを一覧
dropbox team group clear externalid グループの外部IDをクリアする

データ移行補助コマンド

データ移行補助コマンドは、メンバーフォルダやチームフォルダを別のアカウントやチームにコピーします. 実際にデータを移行する前に、これらのコマンドを使用してテストしてください.

コマンド 説明
dropbox team member folder replication フォルダを他のメンバーの個人フォルダに複製します
dropbox team member replication チームメンバーのファイルを複製します
dropbox team teamfolder partial replication 部分的なチームフォルダの他チームへのレプリケーション
dropbox team teamfolder replication チームフォルダを他のチームに複製します

チーム情報コマンド

コマンド 説明
dropbox team feature チームの機能を出力します
dropbox team filesystem チームのファイルシステムのバージョンを特定する
dropbox team info チームの情報

Paperコマンド

レガシーPaperコマンド

チームのレガシーPaperコンテンツのコマンドです. レガシーペーパーとマイグレーションの詳細については、公式ガイドをご覧ください.

コマンド 説明
dropbox team content legacypaper count メンバー1人あたりのPaper文書の枚数
dropbox team content legacypaper list チームメンバーのPaper文書リスト出力
dropbox team content legacypaper export チームメンバー全員のPaper文書をローカルパスにエクスポート.

チーム管理者用コマンド

以下のコマンドは、チーム管理者を管理するためのものです.

コマンド 説明
dropbox team admin list メンバーの管理者権限一覧
dropbox team admin role add メンバーに新しいロールを追加する
dropbox team admin role clear メンバーからすべての管理者ロールを削除する
dropbox team admin role delete メンバーからロールを削除する
dropbox team admin role list チームの管理者の役割を列挙
dropbox team admin group role add グループのメンバーにロールを追加する
dropbox team admin group role delete 例外グループのメンバーを除くすべてのメンバーからロールを削除する

チームメンバーとして実行するコマンド

チームメンバーとしてコマンドを実行することができます. 例えば、dropbox team runas file sync batch upを使ってメンバーのフォルダにファイルをアップロードすることができます。

コマンド 説明
dropbox team runas file list メンバーとして実行するファイルやフォルダーの一覧
dropbox team runas file batch copy ファイル/フォルダーをメンバーとして一括コピー
dropbox team runas file sync batch up メンバーとして動作する一括同期
dropbox team runas sharedfolder list 共有フォルダーの一覧をメンバーとして実行
dropbox team runas sharedfolder isolate 所有する共有フォルダの共有を解除し、メンバーとして実行する外部共有フォルダから離脱する.
dropbox team runas sharedfolder mount add 指定したメンバーのDropboxに共有フォルダを追加する
dropbox team runas sharedfolder mount delete 指定されたユーザーが指定されたフォルダーをアンマウントする.
dropbox team runas sharedfolder mount list 指定されたメンバーがマウントしているすべての共有フォルダーをリストアップします.
dropbox team runas sharedfolder mount mountable メンバーがマウントできるすべての共有フォルダーをリストアップ.
dropbox team runas sharedfolder batch leave 共有フォルダからメンバーとして一括退出
dropbox team runas sharedfolder batch share メンバーのフォルダを一括で共有
dropbox team runas sharedfolder batch unshare メンバーのフォルダの共有を一括解除
dropbox team runas sharedfolder member batch add メンバーの共有フォルダにメンバーを一括追加
dropbox team runas sharedfolder member batch delete メンバーの共有フォルダからメンバーを一括削除

リーガルホールド

リーガルホールドでは、管理者はチームのメンバーをリーガルホールドし、そのメンバーが作成または変更したすべてのコンテンツを表示およびエクスポートすることができます.

コマンド 説明
dropbox team legalhold add 新しいリーガル・ホールド・ポリシーを作成する.
dropbox team legalhold list 既存のポリシーを取得する
dropbox team legalhold member batch update リーガル・ホールド・ポリシーのメンバーリスト更新
dropbox team legalhold member list リーガルホールドのメンバーをリストアップ
dropbox team legalhold release Idによるリーガルホールドを解除する
dropbox team legalhold revision list リーガル・ホールド・ポリシーのリビジョンをリストアップする
dropbox team legalhold update desc リーガルホールド・ポリシーの説明を更新
dropbox team legalhold update name リーガルホールドポリシーの名称を更新

注意事項:

Dropbox for teamsのコマンドを実行するには、管理者権限が必要です。認証トークンは、Dropboxのサポートを含め、誰とも共有してはいけません.

}