Set-DeviceTenantPolicy

模块:

ExchangePowerShell

适用于:

Security & Compliance

此 cmdlet 仅在安全性 & 合规性 PowerShell 中可用。 有关详细信息，请参阅 安全性 & 合规性 PowerShell。

使用 Set-DeviceTenantPolicy cmdlet 在 Microsoft 365 中的 基本移动性和安全性 修改组织的移动设备租户策略。

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

语法

Set-DeviceTenantPolicy
   [-Identity <PolicyIdParameter>]
   [-RetryDistribution]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Set-DeviceTenantPolicy
   [-Identity <PolicyIdParameter>]
   [-Comment <String>]
   [-Enabled <Boolean>]
   [-Force]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

说明

以下列表中介绍了 基本移动性和安全性 中的 cmdlet：

• DeviceTenantPolicy 和 DeviceTenantRule cmdlet：一种策略，用于定义是阻止还是允许移动设备访问仅使用 Exchange ActiveSync 不受支持的设备访问Exchange Online电子邮件。 此设置适用于组织中的所有用户。 系统会为不受支持的设备生成有关允许和阻止这两种情况的报告，且可以根据安全组指定策略例外。
• DeviceConditionalAccessPolicy 和 DeviceConditionalAccessRule cmdlet：控制移动设备对受支持设备的 Microsoft 365 的访问的策略。 这些策略适用于安全组。 不允许不受支持的设备注册基本移动性和安全性。
• DeviceConfigurationPolicy 和 DeviceConfigurationRule cmdlet：用于控制受支持设备的移动设备设置的策略。 这些策略适用于安全组。
• Get-DevicePolicy：返回所有基本移动性和安全性策略，而不考虑 deviceTenantPolicy、DeviceConditionalAccessPolicy 或 DeviceConfigurationPolicy) (类型。

有关基本移动性和安全性的详细信息，请参阅 Microsoft 365 的基本移动性和安全性概述。

若要在安全性 & 合规性 PowerShell 中使用此 cmdlet，需要分配权限。 有关详细信息，请参阅Microsoft 365 Defender门户中的权限或Microsoft Purview 合规门户中的权限。

示例

示例 1

Set-DeviceTenantPolicy -Enabled $false

此示例禁用组织的移动设备租户策略。

参数

-Comment

Comment 参数指定可选注释。 如果您指定包含空格的值，为该值加上双引号(")，例如："这是管理员备注"。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-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:	Security & Compliance

-Enabled

Enabled 参数指定是否已启用此策略。 有效值包含:

• $true：策略已启用。 此值为默认值。
• $true：启用此策略。此为默认值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Force

强制开关隐藏警告或确认消息。 不必为此开关指定值。

您可以在以编程方式运行任务时使用此开关，因为此时并不适合提示用户提供管理输入。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Identity

Identity 参数指定要修改的移动设备租户策略的名称，但组织中只有一个。 策略名称是一个 GUID 值。 例如，a6958701-c82c-4064-ac11-64e40e7f4032。 您可以通过运行此命令找到该值： Get-DeviceTenantPolicy | Format-List Name.

Type:	PolicyIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetryDistribution

保留此参数以供 Microsoft 内部使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-WhatIf

WhatIf 开关在安全 & 合规性 PowerShell 中不起作用。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance