New-TeamsProtectionPolicy
此 cmdlet 仅在基于云的服务中可用。
使用 New-TeamsProtectionPolicy cmdlet 创建Microsoft Teams 保护策略。
注意:如果策略已存在 (Get-TeamsProtectionPolicy cmdlet 返回输出) ,则不能使用此 cmdlet。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
New-TeamsProtectionPolicy
[-Name] <String>
[-Confirm]
[-HighConfidencePhishQuarantineTag <String>]
[-MalwareQuarantineTag <String>]
[-Organization <OrganizationIdParameter>]
[-WhatIf]
[-ZapEnabled <Boolean>]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
New-TeamsProtectionPolicy -Name "Teams Protection Policy"
此示例使用默认值创建 Teams 保护策略。
参数
-Confirm
适用:Exchange Online
适用: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 |
-HighConfidencePhishQuarantineTag
适用:Exchange Online
HighConfidencePhishQuarantineTag 参数指定用于被 ZAP for Teams 隔离为高置信度钓鱼的邮件的隔离策略。 可以使用唯一标识隔离策略的任何值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
隔离策略定义用户可以对隔离邮件执行哪些操作,以及用户是否会收到隔离通知。 有关隔离策略的详细信息,请参阅 隔离策略。
如果不使用此参数,则使用的默认隔离策略名为 AdminOnlyAccessPolicy。 有关此隔离策略的详细信息,请参阅 隔离策略剖析。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-MalwareQuarantineTag
适用:Exchange Online
MalwareQuarantineTag 参数指定用于由 ZAP for Teams 隔离为恶意软件的邮件的隔离策略。 可以使用唯一标识隔离策略的任何值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
隔离策略定义用户可以对隔离邮件执行哪些操作,以及用户是否会收到隔离通知。 有关隔离策略的详细信息,请参阅 隔离策略。
如果不使用此参数,则使用的默认隔离策略名为 AdminOnlyAccessPolicy。 有关此隔离策略的详细信息,请参阅 隔离策略剖析。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Name
适用:Exchange Online
Name 参数指定 Teams 保护策略的唯一名称。 如果值包含空格,则使用引号括住该值。 组织中的 Teams 保护策略的默认名称是 Teams 保护策略。 建议使用此值。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Organization
适用:Exchange Online
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | OrganizationIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:Exchange Online
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ZapEnabled
适用:Exchange Online
ZapEnabled 参数指定是否为 Teams 邮件中的恶意软件和高置信度钓鱼邮件启用零小时自动清除 (ZAP) 。 有效值包含:
- $true:已启用适用于 Teams 中的恶意软件和高置信度钓鱼邮件的 ZAP。 此值为默认值。
- $false:在 Teams 中禁用针对恶意软件和高置信度钓鱼邮件的 ZAP。
参数属性
| 类型: | Boolean |
| 默认值: | False |
| 支持通配符: | 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。