Set-AtpPolicyForO365
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet Set-AtpPolicyForO365 para modificar as definições das seguintes funcionalidades no Microsoft Defender para Office 365:
- Proteção de Links Seguros para aplicativos do Office 365 com suporte.
- Documentos Seguros: utiliza Microsoft Defender para Ponto de Extremidade para digitalizar documentos e ficheiros abertos na Vista Protegida nas aplicações do Microsoft 365 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 (Padrão)
Set-AtpPolicyForO365
[[-Identity] <AtpPolicyForO365IdParameter>]
[-AllowSafeDocsOpen <Boolean>]
[-Confirm]
[-EnableATPForSPOTeamsODB <Boolean>]
[-EnableSafeDocs <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
A proteção de Ligações Seguras para aplicações Office 365 verifica ligações em documentos do Office e não ligações em mensagens de e-mail. Para obter mais informações, veja Definições de Ligações Seguras para aplicações Office 365.
Documentos Seguros analisa documentos e ficheiros abertos na Vista Protegida. Para obter mais informações, consulte Documentos Seguros no Microsoft 365 E5.
Os Anexos Seguros para SharePoint, OneDrive e Microsoft Teams impedem que os utilizadores abram e transfiram ficheiros identificados como maliciosos. 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, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 ativa Documentos Seguros e Anexos Seguros para o SharePoint, OneDrive e Microsoft Teams.
Parâmetros
-AllowSafeDocsOpen
Aplicável: Exchange Online
O parâmetro AllowSafeDocsOpen especifica se os utilizadores podem clicar e ignorar o contentor vista protegida mesmo quando documentos seguros identificam um ficheiro como malicioso. Os valores válidos são:
- $true: os utilizadores podem sair do contentor da Vista Protegida mesmo que o documento seja identificado como malicioso.
- $false: os utilizadores não podem sair da Vista Protegida em caso de deteção maliciosa.
Este 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. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não 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 confirmar 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 ativa ou desativa Anexos Seguros para SharePoint, OneDrive e Microsoft Teams. Os valores válidos são:
- $true: Os Anexos Seguros para o SharePoint, OneDrive e Microsoft Teams estão ativados. Os administradores do SharePoint podem utilizar o parâmetro DisallowInfectedFileDownload no cmdlet Set-SPOTenant para controlar se os utilizadores têm permissão para transferir ficheiros que são considerados maliciosos.
- $false: Os Anexos Seguros para o SharePoint, OneDrive e Microsoft Teams estão desativados. Este valor é a predefiniçã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 ativa ou desativa Documentos Seguros em organizações com licenças Microsoft 365 A5 ou Microsoft 365 E5 Security. Os valores válidos são:
- $true: Os Documentos Seguros estão ativados e carregam ficheiros de utilizador para Microsoft Defender para Ponto de Extremidade para análise e verificação.
- $false: Os Documentos Seguros estão desativados. Este valor é a predefinição.
Para obter mais informações sobre Documentos Seguros, consulte Documentos Seguros no Microsoft 365 A5 ou Segurança E5
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 Identidade especifica a política que pretende modificar. Existe apenas uma política denominada Predefiniçã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 simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.