Set-AtpPolicyForO365
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Set-AtpPolicyForO365 para modificar as configurações dos seguintes recursos no Microsoft Defender para Office 365:
- Proteção de Links Seguros para aplicativos do Office 365 com suporte.
- Documentos Seguros: usa o Microsoft Defender para Ponto de Extremidade para verificar documentos e arquivos abertos no Modo de Exibição Protegido no Microsoft 365 Apps para Grandes Empresas.
- Anexos seguros para SharePoint, OneDrive e Microsoft Teams.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-AtpPolicyForO365
[[-Identity] <AtpPolicyForO365IdParameter>]
[-AllowSafeDocsOpen <Boolean>]
[-Confirm]
[-EnableATPForSPOTeamsODB <Boolean>]
[-EnableSafeDocs <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
A proteção de links seguros para aplicativos do Office 365 verifica links em documentos do Office, não links em mensagens de email. Para obter mais informações, consulte Configurações de links seguros para aplicativos do Office 365.
Documentos Seguros verifica documentos e arquivos abertos no Modo de Exibição Protegido. Para obter mais informações, consulte Documentos Seguros no Microsoft 365 E5.
Os Anexos Seguros para SharePoint, OneDrive e Microsoft Teams impedem que os usuários abram e baixem arquivos identificados como mal-intencionados. Para obter mais informações, consulte Anexos seguros para SharePoint, OneDrive e Microsoft Teams.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Set-AtpPolicyForO365 -EnableATPForSPOTeamsODB $true
Este exemplo habilita Documentos Seguros e Anexos Seguros para SharePoint, OneDrive e Microsoft Teams.
Parâmetros
-AllowSafeDocsOpen
Aplicável: Exchange Online
O parâmetro AllowSafeDocsOpen especifica se os usuários podem clicar no contêiner de Exibição Protegida e ignorá-lo, mesmo quando o Documento Seguro identifica um arquivo como mal-intencionado. Os valores válidos são:
- $true: Os usuários têm permissão para sair do contêiner do Modo de Exibição Protegido, mesmo que o documento seja identificado como mal-intencionado.
- $false: Os usuários não têm permissão para sair do Modo de Exibição Protegido em caso de detecção mal-intencionada.
Esse parâmetro só é significativo quando o valor do parâmetro EnableSafeDocs é $true.
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: Exchange Online
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 |
-EnableATPForSPOTeamsODB
Aplicável: Exchange Online
O parâmetro EnableATPForSPOTeamsODB habilita ou desabilita anexos seguros para SharePoint, OneDrive e Microsoft Teams. Os valores válidos são:
- $true: O recurso Anexos Seguros para SharePoint, OneDrive e Microsoft Teams está habilitado. Os administradores do SharePoint podem usar o parâmetro DisallowInfectedFileDownload no cmdlet Set-SPOTenant para controlar se os usuários têm permissão para baixar arquivos considerados mal-intencionados.
- $false: os anexos seguros para SharePoint, OneDrive e Microsoft Teams estão desabilitados. Esse valor é o padrão.
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 |
-EnableSafeDocs
Aplicável: Exchange Online
O parâmetro EnableSafeDocs habilita ou desabilita Documentos do Cofre em organizações com licenças do Microsoft 365 A5 ou Microsoft 365 E5 Security. Os valores válidos são:
- $true: O Safe Documents está habilitado e carrega arquivos do usuário em Microsoft Defender para Ponto de Extremidade para verificação e verificação.
- $false: Documentos do Cofre está desabilitado. Esse valor é o padrão.
Para obter mais informações sobre Documentos Seguros, consulte Documentos Seguros no Microsoft 365 A5 ou E5 Security
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 |
-Identity
Aplicável: Exchange Online
O parâmetro Identity especifica a política que você deseja modificar. Há apenas uma política chamada Padrão.
Propriedades do parâmetro
| Tipo: | AtpPolicyForO365IdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Online
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
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.