Get-VivaOrgInsightsDelegatedRole
このコマンドレットは、Exchange Online PowerShell モジュール バージョン 3.7.1 以降でのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
Get-VivaOrgInsightsDelegatedRole コマンドレットを使用して、指定した委任者のすべてのデリゲートを表示します。 委任アカウントは、指定された委任者のような組織の分析情報を表示できます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-VivaOrgInsightsDelegatedRole
-Delegator <Guid>
[-ResultSize <Unlimited>]
[<CommonParameters>]
説明
通常、このコマンドレットを Remove-VivaOrgInsightsDelegatedRole コマンドレットと共に使用して、デリゲート アカウントの Microsoft Entra ObjectId 値を検索します。
このコマンドレットを実行するには、移行先のorganizationのMicrosoft Entra IDで次のいずれかの役割グループのメンバーである必要があります。
- グローバル管理者
- Insights 管理者
重要
Microsoft では、最小限の特権の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、organizationの全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常、緊急シナリオや別のロールを使用できない場合に制限する高い特権を持つロールです。
例
例 1
Get-VivaOrgInsightsDelegatedRole -Delegator 043f6d38-378b-7dcd-7cd8-c1a901881fa9
次の使用例は、指定した委任によって結果をフィルター処理します。
パラメーター
-Delegator
適用対象: Exchange Online
Delegator パラメーターは、組織の分析情報を表示できるリーダーのアカウントを指定します。 この機能は、デリゲートに提供されます。
このパラメーターの有効な値は、委任アカウントの ObjectID 値です。 この値を見つけるには、Microsoft Graph PowerShell の Get-MgUser コマンドレットを使用します。
パラメーターのプロパティ
| 型: | Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Online
ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。