New-SPUser
権限を指定して既存のユーザーを SharePoint サイトに追加します。
構文
New-SPUser
[-UserAlias] <String>
-Web <SPWebPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-DisplayName <String>]
[-Email <String>]
[-Group <SPGroupPipeBind>]
[-PermissionLevel <String[]>]
[-SiteCollectionAdmin]
[-WhatIf]
[<CommonParameters>]説明
コマンドレットは New-SPUser 、指定されたアクセス許可を持つ SharePoint Web サイトに既存のユーザーを追加します。
このユーザーには、権限を継承するすべてのサブサイトで、指定した権限が付与されます。
ユーザー アカウントがユーザー ディレクトリに既に存在していることが必要です。
環境が Active Directory モードの場合、ユーザーは既に Active Directory Domain Services (AD DS) に存在している必要があり、UserAlias パラメーターのみが必要です。他のすべてのフィールドは AD DS から取得されます。 エイリアスのみが指定され、ファームが Active Directory アカウント作成モードの場合は、Email パラメーターも必要です。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
------------------ 例 1 ----------------------
New-SPUser -UserAlias 'Contoso\Jdow'-DisplayName 'Jane Dow' -Web https://contoso.comこの例では、新しいユーザー Jane Dow を Contoso ドメインに追加します。
------------------ 例 2 ----------------------
Get-SPWeb https://sitename | New-SPUser -UserAlias Contoso\Jdow次の使用例は、サイト コレクション内のすべての Web に Contoso\Jdow を https://sitename 追加します。 このサイト コレクションでは継承された権限を使用するため、操作する必要があるのはトップレベルの Web サイトのみです。
パラメーター
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-DisplayName
ユーザーの表示名とする文字列を指定します。
この型は、有効なユーザー名 (Joe など) であることが必要です。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
新しいユーザーの電子メール アドレスを指定します。
型は、 形式 someone@contoso.comの有効な電子メール アドレスである必要があります。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Group
新しいユーザーが属するユーザー グループを指定します。
| Type: | SPGroupPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-PermissionLevel
ユーザーをアクセス許可レベルに追加します。
この型は、Web アプリケーションの有効なアクセス許可レベルであることが必要です。たとえば、 Full Control 、 Read 、 Contribute 、 All などです。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SiteCollectionAdmin
ユーザーを管理者としてサイト コレクションに追加するかどうかを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-UserAlias
Active Directory ドメイン サービス (AD DS) からユーザーのエイリアスを指定します。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Web
このユーザーを作成する Web サイトの URL または GUID を指定します。
この型は、http://<サーバー名> という形式の有効な URL であるか、1234-5678-9876-0987 という形式の GUID であることが必要です。
| Type: | SPWebPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |