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