Get-RoleAssignmentPolicy

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

Get-RoleAssignmentPolicy コマンドレットは、組織内の既存の管理役割割り当てポリシーを確認するために使用します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-RoleAssignmentPolicy
   [[-Identity] <MailboxPolicyIdParameter>]
   [-DomainController <Fqdn>]
   [<CommonParameters>]

説明

割り当てポリシーの詳細については、「 管理ロールの割り当てポリシーについて」を参照してください。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-RoleAssignmentPolicy

この例では、すべての既存の役割の割り当てポリシーの一覧が返されます。

例 2

Get-RoleAssignmentPolicy "End User Policy" | Format-List

この例では、指定した割り当てポリシーの詳細が返されます。 Get-RoleAssignmentPolicy コマンドレットの出力は、Format-List コマンドレットにパイプ処理されます。

パイプライン処理とFormat-List コマンドレットの詳細については、「 パイプライン について」と「 コマンド出力の操作」を参照してください。

例 3

Get-RoleAssignmentPolicy | Where { $_.IsDefault -eq $True }

この例では、既定の割り当てポリシーを返します。

Get-RoleAssignmentPolicy コマンドレットの出力は、Where コマンドレットにパイプ処理されます。 Where コマンドレットにより、IsDefault プロパティが $True に設定されたポリシー以外のすべてのポリシーがフィルター処理により排除されます。

パイプライン処理とFormat-List コマンドレットの詳細については、「 パイプライン について」と「 コマンド出力の操作」を参照してください。

パラメーター

-DomainController

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity パラメーターには、表示する割り当てポリシーの名前を指定します。 名前にスペースが含まれている場合、名前を二重引用符 (") で囲みます。

Type:MailboxPolicyIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。