Add-PublicFolderClientPermission
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Add-PublicFolderClientPermission cmdlet 可以向公用文件夹添加权限。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Add-PublicFolderClientPermission
[-Identity] <PublicFolderIdParameter>
-AccessRights <MultiValuedProperty>
-User <PublicFolderUserIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Server <ServerIdParameter>]
[-WhatIf]
[<CommonParameters>] 说明
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Add-PublicFolderClientPermission -Identity "\My Public Folder" -User Chris -AccessRights CreateItems -Server "My Server"在 Exchange 2010 中，本示例添加用户 Chris 在服务器“我的服务器”的公用文件夹中创建项目的权限。
示例 2
Add-PublicFolderClientPermission -Identity "\My Public Folder" -User Chris -AccessRights CreateItems本示例为用户 Chris 添加了在 My Public Folder 公用文件夹中创建项目的权限。
参数
-AccessRights
AccessRights 参数指定要为公用文件夹上的用户添加的权限。
您可以指定每个文件夹的权限或角色，这是权限的组合。 您可以指定多个权限和角色，并用逗号分隔。
以下各个权限可用：
- CreateItems：用户有权在指定的公用文件夹中创建项目。
- CreateSubfolders：用户有权在指定的公用文件夹中创建子文件夹。
- DeleteAllItems：用户有权删除指定公用文件夹中的所有项目。
- DeleteOwnedItems：用户有权删除用户拥有的指定公用文件夹中的项目。
- EditAllItems：用户有权编辑指定公用文件夹中的所有项目。
- EditOwnedItems：用户有权编辑用户在指定公用文件夹中拥有的项目。
- FolderContact：用户是指定公用文件夹的联系人。
- FolderOwner：用户是指定公用文件夹的所有者。 用户有权查看和移动公用文件夹以及创建子文件夹。 用户无法读取项目、编辑项目、删除项目或创建项目。
- FolderVisible：用户可以查看指定的公用文件夹，但不能读取或编辑指定公用文件夹中的项目。
- ReadItems：用户有权读取指定公用文件夹中的项目。
除了访问权限，还可以基于角色创建权限，其中包括多种访问权限。 此参数接受下列角色值：
- 作者：CreateItems、DeleteOwnedItems、EditOwnedItems、FolderVisible、ReadItems
- 参与者：CreateItems、FolderVisible
- 编辑器：CreateItems、DeleteAllItems、DeleteOwnedItems、EditAllItems、EditOwnedItems、FolderVisible、ReadItems
- 无：FolderVisible
- NonEditingAuthor：CreateItems、DeleteOwnedItems、FolderVisible、ReadItems
- 所有者：CreateItems、CreateSubfolders、DeleteAllItems、DeleteOwnedItems、EditAllItems、EditOwnedItems、FolderContact、FolderOwner、FolderVisible、ReadItems
- PublishingAuthor：CreateItems、CreateSubfolders、DeleteOwnedItems、EditOwnedItems、FolderVisible、ReadItems
- PublishingEditor：CreateItems、CreateSubfolders、DeleteAllItems、DeleteOwnedItems、EditAllItems、EditOwnedItems、FolderVisible、ReadItems
- 审阅者：FolderVisible、ReadItems
| Type: | MultiValuedProperty |
| 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, Exchange Online |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 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, Exchange Online |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| 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 参数指定代表特定公用文件夹的 GUID 或公用文件夹名称。 还可以使用 TopLevelPublicFolder\PublicFolder 格式包含路径。
可以省略参数标签，以便只提供公用文件夹名称或 GUID。
| Type: | PublicFolderIdParameter |
| 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, Exchange Online |
-Server
此参数仅在 2010 Exchange Server可用。
服务器参数指定要运行此命令的Exchange服务器。 可以使用唯一标识该服务器的任何值。 例如：
- 名称
- FQDN
- 可分辨名称 (DN)
- Exchange 旧版 DN
Exchange 旧版 DN
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-User
User 参数指定用户主体名称 (UPN)、域\用户或为其添加权限的用户的别名。
| Type: | PublicFolderUserIdParameter |
| 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, Exchange Online |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
| Type: | SwitchParameter |
| Aliases: | wi |
| 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, Exchange Online |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。