注: PowerShellとの連携には、ShareGate MigrateのProまたはEnterpriseサブスクリプションが必要です。Essentialsプランでは利用できません。
コマンド
Copy-ObjectPermissions
説明
Copy-ObjectPermissionsを使用すると、サイトやドキュメントなどのSharePointオブジェクト、またはファイル共有のフォルダーやドキュメントのアクセス許可をコピーできます。
アクセス許可をコピーできるのは、同じActive Directory(AD)/Entra IDドメインを使用し、同一のSharePointグループを持つ環境間のみです。
Copy-ObjectPermissionsには制限があり、次のことは行われません。
コピー先にユーザーまたはグループが存在するかどうかを確認する。存在しない場合でもエラーや警告は表示されません。
コピー元のグループにあるメンバーのうち、コピー先のグループに不足しているメンバーを追加する。
例
サイトのアクセス許可をコピーする
$site1 = Connect-Site "http://myfarm/sites/mysite1"$site2 = Connect-Site "http://myfarm/sites/mysite2"Copy-ObjectPermissions -Source $site1 -Destination $site2
ファイル共有のアクセス許可を複数のSharePointコピー先にコピーする
$sourcefile = Get-Folder -Path "C:\\Temp"$site1 = Connect-Site "http://farm1/sites/mysite1"$site2 = Connect-Site "http://farm2/sites/mysite2"$list1 = Get-List -Site $site1 -Name "Documents"$list2 = Get-List -Site $site2 -Name "Documents"$spfile = Get-File -List $list1 -Path "Files/file.txt"$folder = Get-Folder -List $list2 -Path "Folder Path"Copy-ObjectPermissions -Source $sourcefile -Destination $site1,$site2,$list1,$list2,$spfile,$folder
MySiteライブラリのアクセス許可をOneDriveにコピーする
$MySite = Connect-Site "http://myfarm/personal/myusername"$PersonalDocuments = Get-List -Site $MySite -Name "Personal Documents"$OneDrive = Connect-Site "http://mytenant-my.sharepoint.com/personal/myusername"$OneDriveDocuments = Get-List -Site $OneDrive -Name "Documents"$DocumentsFolder = Get-Folder -List $OneDriveDocuments -Path "Personal Documents"Copy-ObjectPermissions -Source $PersonalDocuments -Destination $DocumentsFolder
構文
Copy-ObjectPermissions
-Source <ISecurable>
-Destination <ISecurable[]>
[-MappingSettings <MappingSettings>]
[-TaskName <String>]
パラメーター
-Destination <ISecurable[]>
コピーしたアクセス許可の適用先となる(ファイル システム以外の)コピー先オブジェクトを指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-MappingSettings <MappingSettings>
マッピング設定を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-Source <ISecurable>
アクセス許可のコピー元となるオブジェクトを指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可するか | True (ByValue; ByPropertyName) |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
-TaskName <String>
タスクの名前を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可するか | False |
ワイルドカード文字を許可するか | False |
パラメーターセット名 | (All) |
エイリアス | None |
この記事はAIによって翻訳されています。ご不明な点がある場合は、英語の原文をご確認ください。