Set-DeviceTenantRule

Módulo:
Exchange PowerShell

Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..

Use o cmdlet Set-DeviceTenantRule para modificar a regra de locatário de dispositivo móvel da sua organização no Mobilidade básica e segurança no Microsoft 365.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Default) 

Set-DeviceTenantRule
    [-Identity] <ComplianceRuleIdParameter>
    [-ApplyPolicyTo <PolicyResourceScope>]
    [-BlockUnsupportedDevices <Boolean>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExclusionList <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

Description

Os cmdlets em Mobilidade básica e segurança são descritos na lista a seguir:

  • Cmdlets DeviceTenantPolicy e DeviceTenantRule: uma política que define se deve bloquear ou permitir o acesso de dispositivos móveis ao email do Exchange Online por dispositivos sem suporte que usam apenas o Exchange ActiveSync. Essa configuração se aplica a todos os usuários da sua organização. Os cenários de permissão e bloqueio permitem gerar relatórios para dispositivos sem suporte, e você pode especificar exceções para a política com base nos grupos de segurança.
  • Cmdlets DeviceConditionalAccessPolicy e DeviceConditionalAccessRule: políticas que controlam o acesso de dispositivos móveis ao Microsoft 365 para dispositivos com suporte. Essas políticas são aplicadas a grupos de segurança. Os dispositivos sem suporte não têm permissão para se inscrever no Mobilidade básica e segurança.
  • Cmdlets DeviceConfigurationPolicy e DeviceConfigurationRule: políticas que controlam as configurações de dispositivos móveis com suporte. Essas políticas são aplicadas a grupos de segurança.
  • Get-DevicePolicy: retorna todas as políticas básicas de Mobilidade e segurança, independentemente do tipo (DeviceTenantPolicy, DeviceConditionalAccessPolicy ou DeviceConfigurationPolicy).

Para obter mais informações sobre Mobilidade básica e segurança, consulte Visão geral da Mobilidade básica e segurança para Microsoft 365.

Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, confira Permissões no portal do Microsoft Defender ou Permissões no portal de conformidade do Microsoft Purview.

Exemplos

Exemplo 1

Set-DeviceTenantRule -ExclusionList "Research and Development"

Este exemplo modifica a regra de locatário do dispositivo móvel de sua organização, substituindo a lista atual de exclusão pelo grupo de segurança chamado Pesquisa e Desenvolvimento. Os membros desse grupo têm permissão de acesso mesmo que usem dispositivos incompatíveis

Parâmetros

-ApplyPolicyTo

Aplicável: Segurança & Conformidade

O parâmetro ApplyPolicyTo especifica onde aplicar a política em sua organização. O parâmetro PasswordQuality especifica a classificação mínima de qualidade da senha exigida para as senhas dos dispositivo. Qualidade de senha é uma escala numérica que indica a segurança e a complexidade da senha. Um valor de qualidade mais alto indica uma senha mais segura.

  • ExchangeOnline
  • SharePointOnline
  • ExchangeAndSharePoint

Propriedades do parâmetro

Tipo:PolicyResourceScope
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-BlockUnsupportedDevices

Aplicável: Segurança & Conformidade

O parâmetro BlockUnsupportedDevices especifica se o acesso à sua organização deve ser bloqueado por dispositivos sem suporte. O parâmetro PasswordQuality especifica a classificação mínima de qualidade da senha exigida para as senhas dos dispositivo. Qualidade de senha é uma escala numérica que indica a segurança e a complexidade da senha. Um valor de qualidade mais alto indica uma senha mais segura.

  • $true: Dispositivos sem suporte estão bloqueados.
  • $true: os dispositivos sem suporte são bloqueados.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Segurança & Conformidade

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainController

Aplicável: Segurança & Conformidade

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Tipo:Fqdn
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExclusionList

Aplicável: Segurança & Conformidade

O parâmetro ExclusionList especifica os grupos de segurança a serem excluídos dessa política. Os membros dos grupos de segurança especificados que têm dispositivos não compatíveis não são afetados por ações de bloqueio de acesso.

Esse parâmetro usa o valor GUID do grupo. Para localizar esse valor GUID, execute o comando Get-Group | Format-Table Nome,GUID.

Para inserir vários valores e substituir as entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Segurança & Conformidade

O parâmetro Identity especifica o nome da regra de locatário de dispositivo móvel que você deseja modificar, mas há apenas uma em sua organização. O nome da regra é um GUID. Por exemplo, 7577c5f3-05a4-4f55-a0a3-82aab5e98c84. Encontre o valor do nome executando o comando Get-DeviceTenantRule | Format-List Name.

Propriedades do parâmetro

Tipo:ComplianceRuleIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Segurança & Conformidade

A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.