Add-ADPermission

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

Add-ADPermission コマンドレットを使用して、Active Directory オブジェクトにアクセス許可を追加します。

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

構文

Add-ADPermission
   [-Identity] <ADRawEntryIdParameter>
   -User <SecurityPrincipalIdParameter>
   [-AccessRights <ActiveDirectoryRights[]>]
   [-ChildObjectTypes <ADSchemaObjectIdParameter[]>]
   [-Confirm]
   [-Deny]
   [-DomainController <Fqdn>]
   [-ExtendedRights <ExtendedRightIdParameter[]>]
   [-InheritanceType <ActiveDirectorySecurityInheritance>]
   [-InheritedObjectType <ADSchemaObjectIdParameter>]
   [-Properties <ADSchemaObjectIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Add-ADPermission
   [-Identity] <ADRawEntryIdParameter>
   -Owner <SecurityPrincipalIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]

Add-ADPermission
   [[-Identity] <ADRawEntryIdParameter>]
   -Instance <ADAcePresentationObject>
   [-AccessRights <ActiveDirectoryRights[]>]
   [-ChildObjectTypes <ADSchemaObjectIdParameter[]>]
   [-Confirm]
   [-Deny]
   [-DomainController <Fqdn>]
   [-ExtendedRights <ExtendedRightIdParameter[]>]
   [-InheritanceType <ActiveDirectorySecurityInheritance>]
   [-InheritedObjectType <ADSchemaObjectIdParameter>]
   [-Properties <ADSchemaObjectIdParameter[]>]
   [-User <SecurityPrincipalIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

説明

ADPermission コマンドレットを使用して、Active Directory アクセス制御リスト (ACL) を直接変更できます。一部の Microsoft Exchange 機能では、引き続き ADPermission コマンドレットを使用してアクセス許可 (送信コネクタや受信コネクタなど) を管理できますが、Exchange 2013 以降のバージョンでは、カスタマイズされた ACL を使用して管理アクセス許可を管理しなくなりました。 Exchange 2013 以降で管理アクセス許可を付与または拒否する場合は、ロールベースのAccess Control (RBAC) を使用する必要があります。 RBAC の詳細については、「Exchange Serverのアクセス許可」を参照してください。

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

例

例 1

Add-ADPermission -Identity "Terry Adams" -User AaronPainter -AccessRights ExtendedRight -ExtendedRights "Send As"

この例では、Aaron Painter の送信者アクセス許可を Terry Adams のメールボックスに対して与えます。

例 2

Add-AdPermission "IP Secured Inbound" -User "NT AUTHORITY\ANONYMOUS LOGON" -ExtendedRights ms-Exch-SMTP-Submit,ms-Exch-SMTP-Accept-Any-Recipient,ms-Exch-Bypass-Anti-Spam

この例では、IP を保護した受信側の受信コネクタが匿名の SMTP メッセージを受け付けるように構成します。

この例では、迷惑な商用電子メールメッセージの送信に受信コネクタを使用できないようにするために、別のセキュリティメカニズムを使用することを前提としています。外部のクライアントに受信コネクタを経由して匿名でメッセージを送信することを許可しないようにお勧めします。

パラメーター

-AccessRights

AccessRights パラメーターは、Active Directory オブジェクトのユーザーに対して追加する権限を指定します。有効な値は次のとおりです。

AccessSystemSecurity
CreateChild
DeleteChild
ListChildren
自分
ReadProperty
WriteProperty
DeleteTree
ListObject
ExtendedRight
削除
ReadControl
GenericExecute
GenericWrite
GenericRead
WriteDacl
WriteOwner
GenericAll
Synchronize

複数の値をコンマで区切って指定できます。

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

Type:	ActiveDirectoryRights[]
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

-ChildObjectTypes

ChildObjectTypes パラメーターには、アクセス許可を適用する必要があるオブジェクトの種類を指定します。

AccessRights パラメーターが CreateChild または DeleteChild に設定されている場合のみ、ChildObjectTypes パラメーターを使用できます。

Type:	ADSchemaObjectIdParameter[]
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

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:	SwitchParameter
Aliases:	cf
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

-Deny

[拒否] スイッチは、追加するアクセス許可が [アクセス許可の拒否] であることを指定します。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
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

-DomainController

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

-ExtendedRights

ExtendedRights パラメーターには、操作を実行するために必要な拡張権利を指定します。

Type:	ExtendedRightIdParameter[]
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 パラメーターには、アクセス許可を追加しようとしているオブジェクトの ID を指定します。オブジェクトの識別名 (DN) またはオブジェクト名 (一意である場合) のいずれかを指定できます。 DN や名前にスペースが含まれている場合、名前を二重引用符 (") で囲んでください。

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

-InheritanceType

InheritType パラメーターは、アクセス許可の継承方法を指定します。有効な値は次のとおりです。

なし
すべて (既定値です)
Children
子孫 [sic]
SelfAndChildren

Type:	ActiveDirectorySecurityInheritance
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

-InheritedObjectType

InheritedObjectType パラメーターは、このアクセス制御エントリ (ACE) を継承するオブジェクトの種類を指定します。

Type:	ADSchemaObjectIdParameter
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

-Instance

Instance パラメーターを使用すると、オブジェクト全体をコマンドに渡して処理することができます。これは主に、オブジェクト全体をコマンドに渡す必要があるスクリプトで使用されます。

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

-Owner

Owner パラメーターは、Active Directory オブジェクトの所有者を指定します。このパラメーターには、次の種類のユーザーまたはグループ (セキュリティプリンシパル) を指定できます。

メールボックスユーザー
メールユーザー
セキュリティグループ

ユーザーまたはグループを一意に識別する任意の値を使用できます。例:

名前
Alias
識別名 (DN)
正規 DN
Domain\Username
電子メールアドレス
GUID
LegacyExchangeDN
SamAccountName
ユーザー ID またはユーザープリンシパル名 (UPN)

AccessRights パラメーターまたは User パラメーターでは、このパラメーターを使用できません。

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

-Properties

Properties パラメーターには、オブジェクトに含まれるプロパティを指定します。

AccessRights パラメーターが ReadProperty、WriteProperty、または Self に設定されている場合のみ、Properties パラメーターを使用できます。

Type:	ADSchemaObjectIdParameter[]
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

-User

User パラメーターは、Active Directory オブジェクトに対するアクセス許可を取得するユーザーを指定します。このパラメーターには、次の種類のユーザーまたはグループ (セキュリティプリンシパル) を指定できます。

メールボックスユーザー
メールユーザー
セキュリティグループ