Get-VivaOrgInsightsDelegatedRole

モジュール:
Exchange PowerShell

このコマンドレットは、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 値を検索します。

このコマンドレットを実行するには、宛先組織の Microsoft Entra ID で次のいずれかの役割グループのメンバーである必要があります organization:

  • グローバル管理者
  • Insights 管理者

重要

Microsoft では、最小限のアクセス許可の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、組織の全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常は緊急時や別のロールを使用できない場合に限定する、非常に特権のあるロールです。

例

例 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」を参照してください。