Set-SPOApplicationPermission
SharePoint Embedded アプリケーションにアクセスするためのゲスト アプリケーションのアクセス許可を管理します。
構文
Default (既定)
Set-SPOApplicationPermission
[-OwningApplicationId] <Guid>
[-GuestApplicationId] <Guid>
[-PermissionAppOnly] <String[]>
[[-PermissionDelegated] <String[]>]
[<CommonParameters>]
説明
Set-SPOApplicationPermission コマンドレットは、ゲスト アプリケーションが SharePoint Embedded アプリケーションにアクセスするためのアクセス許可を管理します。 これには、ゲスト アプリケーションのアクセス許可の追加、更新、削除が含まれます。 ゲスト アプリケーションは、所有テナントのエンタープライズ アプリケーション内の任意のアプリケーションとして定義されます。
このコマンドレットを実行するには、SharePoint 管理者である必要があります。 SharePoint Online の Windows PowerShell のアクセス許可と最新の情報については、「SharePoint Online 管理シェルの概要」を参照してください。
注:
SharePoint Embedded アプリケーションにアクセスするゲスト アプリケーションでは、アプリ専用のアクセス許可のみがサポートされます。 委任されたアクセス許可はサポートされておらず、既定では None に設定されています。
例
例 1
Set-SPOApplicationPermission -OwningApplicationId a187e399-0c36-4b98-8f04-1edc167a0996 -ApplicationId 12345678-1234-1234-abcd-abcdefghijkl -PermissionAppOnly Read, Write
例 1 では、ID 12345678-1234-1234-abcd-abcdefghijklアプリ専用の読み取り、書き込みアクセス許可を持つゲスト アプリケーションに、ID a187e399-0c36-4b98-8f04-1edc167a0996の所有アプリケーション Microsoft Loopにアクセスできます。
例 2
Set-SPOApplicationPermission -OwningApplicationId 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 -ApplicationId 12345678-1234-1234-abcd-abcdefghijkl -PermissionAppOnly ReadContent, WriteContent -PermissionDelegated None
例 2 では、ID 12345678-1234-1234-abcd-abcdefghijklアプリ専用の ReadContent、WriteContent アクセス許可を持つゲスト アプリケーションに、ID a187e399-0c36-4b98-8f04-1edc167a0996の所有アプリケーション Microsoft Designerにアクセスできるようにします。
例 3
Set-SPOApplicationPermission -OwningApplicationId 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 -ApplicationId 12345678-1234-1234-abcd-abcdefghijkl -PermissionAppOnly None -PermissionDelegated None
例 3 では、ID 12345678-1234-1234-abcd-abcdefghijklを持つゲスト アプリケーションのゲスト アプリケーションのアクセス許可を None に設定します。 これにより、そのゲスト アプリケーションが a187e399-0c36-4b98-8f04-1edc167a0996 の所有アプリケーションにアクセスするための以前のアクセス許可が削除されました。
パラメーター
-ApplicationId
適用対象: SharePoint
ゲスト アプリケーション ID を指定するには、このパラメーターを使用します。 ゲスト アプリケーションは、テナントのエンタープライズ アプリケーション内の任意のアプリケーションです。
パラメーターのプロパティ
| 型: | System.Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OwningApplicationId
適用対象: SharePoint
このパラメーターを使用して、ゲスト アプリケーションへのアクセスが許可される所有アプリケーションを指定します。
パラメーターのプロパティ
| 型: | System.Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionAppOnly
適用対象: SharePoint
ゲスト アプリケーションのアプリ専用アクセス許可を指定するには、このパラメーターを使用します。
パラメーターのプロパティ
| 型: | System.String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PermissionDelegated
適用対象: SharePoint
このパラメーターは、現在ゲスト アプリケーションでサポートされていない委任されたアクセス許可を指定します。
パラメーターのプロパティ
| 型: | System.String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。