New-SharingPolicy

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。

使用 New-SharingPolicy cmdlet 可以创建共享策略,以控制组织内部的用户如何与组织外部的用户共享日历和联系人信息。 用户只能在 Exchange 中配置联合之后共享此信息。 配置联合身份验证后,用户可以向启用了联合的其他Exchange Server 2010 或更高版本组织中的外部收件人发送符合共享策略的共享邀请。 只有分配给邮箱后共享策略才会生效。 如果没有为邮箱分配特定的共享策略,则默认策略会实施此邮箱允许的共享级别。

共享策略与不同类型的外部用户提供用户建立的日历和联系人信息的人对人共享。 共享策略允许用户共享其忙/闲信息和联系人信息 (包括日历和联系人文件夹) 与其他外部联合 Exchange 组织中的收件人。 对于不在外部联合组织或非 Exchange 组织中的收件人,共享策略允许通过 Internet 日历发布与匿名用户进行人员对人共享其日历信息。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Default (默认值)

New-SharingPolicy
    [-Name] <String>
    -Domains <MultiValuedProperty>
    [-Confirm]
    [-Default]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

New-SharingPolicy -Name "Contoso" -Domains 'mail.contoso.com: CalendarSharingFreeBusyDetail, ContactsSharing'

本示例将为组织外部的域 contoso.com 创建共享策略 Contoso。 此策略允许 contoso.com 域中的用户查看详细的忙/闲信息和联系人。 默认情况下,启用此策略。

示例 2

New-SharingPolicy -Name "SharingPolicy01" -Domains 'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusySimple' -Enabled $false -Default $true

本示例将创建默认的共享策略,该策略适用于没有为它们隐式分配共享策略的所有邮箱。 共享策略 SharingPolicy01 适用于两个不同的域,但此共享策略处于禁用状态。

参数

-Confirm

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Default

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Default 开关指定此共享策略是所有邮箱的默认共享策略。 不必为此开关指定值。

如果未将共享策略应用于邮箱,则会自动应用默认策略。 如果希望在整个组织禁用共享,可以将默认策略设置为禁用。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DomainController

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Domains

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Domains 参数指定共享策略中这些域的域和关联的共享选项。 此参数的值使用基本语法: 'Domain: SharingPolicyAction'

可以将以下值用于 Domain

  • 域:例如 mail.contoso.com。 域不包含子域。 必须单独配置每个子域。
  • *:与外部联合组织共享。 例如,另一个Microsoft 365 组织或本地 Exchange 组织。
  • 匿名:与具有 Internet 访问权限的外部非联合组织和个人共享。

可以将以下值用于 SharingPolicyAction

  • CalendarSharingFreeBusySimple:仅共享忙/闲时间
  • CalendarSharingFreeBusyDetail:共享忙/闲时间、主题和位置
  • CalendarSharingFreeBusyReviewer:共享忙/闲时间、主题、位置和邮件或日历项的正文
  • ContactsSharing:仅共享联系人

可以指定用逗号分隔的多个 'Domain: SharingPolicyAction' 值,也可以为同一个域指定多个 SharingPolicyAction 值(用逗号分隔)。 例如,'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusyDetail, ContactsSharing'

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Enabled

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Enabled 参数指定是否启用新的共享策略。 此参数的有效输入为 $true 或 $false。 默认值为 True。

禁用共享策略后,设置为使用该策略的用户可继续共享信息,直到共享策略助理运行并删除共享文件夹的权限。 可以使用 SharingPolicySchedule 参数在 Set-MailboxServer cmdlet 中指定共享策略助理运行的频率。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Name 参数指定新共享策略的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。