Get-EXOMailboxFolderPermission

モジュール:
Exchange PowerShell

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

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

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

構文

Default (既定) 

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

適用対象: Exchange Online

ExternalDirectoryObjectId パラメーターは、Microsoft Entra ID の ObjectId で表示するメールボックスを識別します。

このパラメーターは、Identity、PrimarySmtpAddress、または UserPrincipalName パラメーターと一緒に使用することはできません。

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-GroupMailbox

適用対象: Exchange Online

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Online

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

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

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

このパラメーターを ExternalDirectoryObjectId、PrimarySmtpAddress、または UserPrincipalName パラメーターと一緒に使用することはできません。

注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:0
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-PrimarySmtpAddress

適用対象: Exchange Online

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

このパラメーターを ExternalDirectoryObjectId、Identity、または UserPrincipalName パラメーターと一緒に使用することはできません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-User

適用対象: Exchange Online

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

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

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-UserPrincipalName

適用対象: Exchange Online

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

このパラメーターを ExternalDirectoryObjectId、Identity、または PrimarySmtpAddress パラメーターと一緒に使用することはできません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。