Get-UnifiedAuditLogRetentionPolicy
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..
Utilize o cmdlet Get-UnifiedAuditLogRetentionPolicy para ver as propriedades das políticas de retenção do registo de auditoria no portal do Microsoft Defender ou no portal de conformidade do Microsoft Purview.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
Get-UnifiedAuditLogRetentionPolicy
[-Operation <String>]
[-RecordType <AuditRecordType>]
[-RetentionDuration <UnifiedAuditLogRetentionDuration>]
[-UserId <String>]
[<CommonParameters>]
Description
As políticas de retenção de registos de auditoria são utilizadas para especificar uma duração de retenção para os registos de auditoria para os quais são gerados pela atividade de administrador e utilizador. Uma política de retenção de registo de auditoria pode especificar a duração da retenção com base no tipo de atividades auditadas, no serviço do Microsoft 365 em que as atividades são realizadas ou nos utilizadores que realizaram as atividades. Para saber mais, confira Gerenciar políticas de retenção de log de auditoria.
Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, veja Permissões no portal do Microsoft Defender ou Permissões no portal de conformidade do Microsoft Purview.
Exemplos
Exemplo 1
Get-UnifiedAuditLogRetentionPolicy | Sort-Object -Property Priority | Format-List Priority,Name,Description,RecordTypes,Operations,UserIds,RetentionDuration
Este exemplo lista as propriedades configuráveis para todas as políticas de retenção de registos de auditoria na sua organização. O comando também lista as políticas por ordem da prioridade mais alta para a mais baixa.
Exemplo 2
Get-UnifiedAuditLogRetentionPolicy -RecordType ExchangeItem | Format-List Name,Description,RecordTypes,Operations,UserIds,RetentionDuration,Priority
Este exemplo lista as propriedades configuráveis para todas as políticas de retenção de registos de auditoria que se aplicam aos registos de auditoria do tipo de registo do ExchangeItem.
Parâmetros
-Operation
Aplicável: Conformidade do & de Segurança
O parâmetro Operações filtra os resultados pelas operações especificadas na política. Para obter uma lista dos valores disponíveis para este parâmetro, veja Atividades auditadas.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-RecordType
Aplicável: Conformidade do & de Segurança
O parâmetro RecordType filtra os resultados pelos tipos de registo definidos na política. Para obter detalhes sobre os valores disponíveis, veja AuditLogRecordType.
Propriedades do parâmetro
| Tipo: | AuditRecordType |
| 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 |
-RetentionDuration
Aplicável: Conformidade do & de Segurança
O parâmetro RetentionDuration filtra os resultados da política pela duração de retenção especificada na política. Os valores válidos são:
- TrêsMonths
- SixMonths
- Nove Meses
- Doze Meses
- Dez Anos
Propriedades do parâmetro
| Tipo: | UnifiedAuditLogRetentionDuration |
| Valor padrão: | None |
| Valores aceitos: | ThreeMonths, SixMonths, NineMonths, TwelveMonths, TenYears |
| 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 |
-UserId
Aplicável: Conformidade do & de Segurança
O parâmetro UserIds filtra os resultados da política pelo ID dos utilizadores especificados na política.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Propriedades do parâmetro
| Tipo: | String |
| 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 |
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.