Move-SPUser
SharePoint 製品のユーザー アカウントを移行します。
構文
Move-SPUser
[-Identity] <SPUserPipeBind>
-NewAlias <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-IgnoreSID]
[-WhatIf]
[<CommonParameters>]
説明
Move-SPUser コマンドレットでは、ユーザー アクセスを 1 つのドメイン ユーザー アカウントから別のドメイン ユーザー アカウントに移行します。 新しいログイン名のエントリが既に存在する場合、このエントリには移行を行うために削除のマークが付けられます。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
------------------ 例 ------------------
$user = Get-SPUser -Identity "DOMAIN\JaneDoe" -Web https://webUrl
Move-SPUser -Identity $user -NewAlias "Domain\JaneSmith" -IgnoreSid
この例では、DOMAIN\JaneDoe を新しいアカウントの DOMAIN\JaneSmith に移行します。
------------------ 例 2 ------------------
$user = Get-SPUser -Identity "DomainA\JaneDoe" -Web https://webUrl
Move-SPUser -Identity $user -NewAlias "DomainB\JaneDoe"
この例では、DOMAIN\JaneDoe を DomainA から、SID 履歴が有効になっている DomainB の DOMAINB\JaneDoe の新しいアカウントに移行します。
------------------ 例 3 ------------------
$user = Get-SPUser -Identity "i:0#.w|DOMAIN\JaneDoe" -Web https://webUrl
Move-SPUser -Identity $user -NewAlias "i:0#.w|Domain\JaneSmith" -IgnoreSid
次の使用例は、Windows 要求を使用するときに DOMAIN\JaneDoe を DOMAIN\JaneSmith の新しいアカウントに移行します。 -IgnoreSid
は、Windows 要求などのクレーム ID を使用する場合は、常に と共 Move-SPUser
に使用する必要があります。
パラメーター
-AssignmentCollection
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Confirm
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Identity
を SPUser
使用して取得されるオブジェクトを Get-SPUser
指定します。
型は有効な SPUser
オブジェクトである必要があります。
Type: | SPUserPipeBind |
Aliases: | UserAlias |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-IgnoreSID
新しいログイン名が古いログイン名に確実に対応するように、Active Directory で SID 履歴属性のクエリが実行されないことを示します (存在する場合)。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-NewAlias
ユーザー アカウントの新しいログイン名を指定します。
型は、DOMAIN\username という形式の有効なログイン名である必要があります。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-WhatIf
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |