Register-SPAppPrincipal

モジュール:

SharePointServer

適用対象:

SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

オンプレミス管理者がアプリ プリンシパルを登録できるようにします。

構文

Register-SPAppPrincipal
        -DisplayName <String>
        -NameIdentifier <String>
        -Site <SPWebPipeBind>
        [-AssignmentCollection <SPAssignmentCollection>]
        [<CommonParameters>]

説明

コマンドレットを Register-SPAppPrincipal 使用して、オンプレミスのファーム管理者がアプリ プリンシパル管理サービスを登録できるようにします。

SharePoint 製品のWindows PowerShellに関するアクセス許可と最新の情報については、 のオンライン ドキュメントを参照してくださいhttps://go.microsoft.com/fwlink/p/?LinkId=251831(https://go.microsoft.com/fwlink/p/?LinkId=251831)。

例

------------------ 例 -----------------------

$site = Get-SPSite "https://<urlofsite>"
Register-SPAppPrincipal -site $site.RootWeb -NameIdentifier "00000003-0000-0ff1-ce00-000000000000@f686d426-8d16-42db-81b7-cb578e110ccd" -DisplayName "Contoso"

次の使用例は、Contoso という名前のアプリ プリンシパルを登録します。

パラメーター

-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 2013, SharePoint Server 2016, SharePoint Server 2019

-DisplayName

登録されるアプリケーション プリンシパルで使うフレンドリ名を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-NameIdentifier

アプリ管理サービスに追加する必要があるアプリ プリンシパルの名前識別子を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Site

{{Fill Site Description}}

Type:	SPWebPipeBind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

関連リンク

• Get-SPAppPrincipal