Get-EXOMailboxFolderPermission

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Online

このコマンドレットは、Exchange Online PowerShell モジュールでのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。

Get-ExOMailboxFolderPermission コマンドレットを使用して、メールボックス内のフォルダー レベルのアクセス許可を表示します。

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

構文

Get-EXOMailboxFolderPermission
   [[-Identity] <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-GroupMailbox]
   [-PrimarySmtpAddress <String>]
   [-User <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

説明

このコマンドレットを使用して、メールボックス内のフォルダー レベルのアクセス許可を取得します。

例

例 1

Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports

この例では、John のメールボックスにある Marketing フォルダーの Reports サブフォルダーに対する現在のユーザー アクセス許可の一覧を取得します。

例 2

Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports -User Kim@contoso.com

次の使用例は、John のメールボックス内の同じフォルダーに対するアクセス許可を返しますが、ユーザーの Kim に対してのみアクセス許可を返します。

パラメーター

-ExternalDirectoryObjectId

ExternalDirectoryObjectId パラメーターは、Azure Active Directory の ObjectId によって表示するメールボックスを識別します。

このパラメーターは、Identity、PrimarySmtpAddress、または UserPrincipalName パラメーターでは使用できません。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-GroupMailbox

結果にMicrosoft 365 グループを返すには、GroupMailbox スイッチが必要です。 このスイッチで値を指定する必要はありません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

Identity パラメーターでは、表示するメールボックス フォルダーを指定します。 このパラメーターは、 構文を使用します。 <Mailbox>:\<Folder> 最適なパフォーマンスを得るには、ユーザー ID またはユーザー プリンシパル名 (UPN) を使用してメールボックスを識別することをお勧めします。

それ以外の場合は、メールボックスを一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (DN)
  • 識別名 (DN)
  • LegacyExchangeDN
  • SamAccountName

ExternalDirectoryObjectId、PrimarySmtpAddress、または UserPrincipalName パラメーターでは、このパラメーターを使用できません。

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-PrimarySmtpAddress

PrimarySmtpAddress は、プライマリ SMTP メール アドレス (など navin@contoso.com) で表示するメールボックスを識別します。

ExternalDirectoryObjectId、Identity、または UserPrincipalName パラメーターでは、このパラメーターを使用できません。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-User

User パラメーターは、メールボックス フォルダーに対するアクセス許可を付与された指定のメールボックス、メール ユーザー、メールが有効なセキュリティ グループ (セキュリティ プリンシパル) によって、結果をフィルターします。 ユーザーまたはグループを一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • 電子メール アドレス
  • GUID

注: メールボックス フォルダーにアクセスするためのアクセス許可を持たないユーザーを指定した場合、コマンドは例外をスローします。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UserPrincipalName

UserPrincipalName パラメーターは、 navin@contoso.onmicrosoft.comUPN で表示するメールボックスを識別します (例: )。

ExternalDirectoryObjectId、Identity、PrimarySmtpAddress パラメーターでは、このパラメーターを使用できません。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online