Get-EXOMailboxFolderPermission
このコマンドレットは、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 |