Set-AppRetentionCompliancePolicy
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 Set-AppRetentionCompliancePolicy para modificar as políticas de conformidade de retenção de aplicações.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddExchangeLocationException <MultiValuedProperty>]
[-AddModernGroupLocation <MultiValuedProperty>]
[-AddModernGroupLocationException <MultiValuedProperty>]
[-Applications <String[]>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemoveExchangeLocationException <MultiValuedProperty>]
[-RemoveModernGroupLocation <MultiValuedProperty>]
[-RemoveModernGroupLocationException <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddAdaptiveScopeLocation <MultiValuedProperty>]
[-Applications <String[]>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-Force]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-DeletedResources <String>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-RetryDistribution]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-Force]
[-WhatIf]
[<CommonParameters>] Description
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 de conformidade do Microsoft Purview.
Exemplos
Exemplo 1
Set-AppRetentionCompliancePolicy -Identity "Regulation 563 Marketing" -Applications "User:MicrosoftTeams","Group:MicrosoftTeams,VivaEngage" -AddExchangeLocation "Scott Smith" -Comment "Added new counsel, 9/9/21"Este exemplo adiciona um novo utilizador à política de retenção de âmbito estático existente denominada Regulamento 563 Marketing configurado para mensagens de canais privados do Teams.
Parâmetros
-AddAdaptiveScopeLocation
O parâmetro AddAdaptiveScopeLocation especifica a localização do âmbito adaptável a adicionar à política. Pode criar âmbitos ajustáveis com o cmdlet New-AdaptiveScope. Pode utilizar qualquer valor que identifique exclusivamente o âmbito adaptável. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-AddExchangeLocation
O parâmetro AddExchangeLocation especifica as caixas de correio a adicionar à lista de caixas de correio incluídas quando não estiver a utilizar o valor All para o parâmetro ExchangeLocation. Os valores válidos são:
- O parâmetro ExchangeLocation especifica as caixas de correio que devem ser incluídas na política. Os valores válidos são:
- Uma caixa de correio
O valor All para todas as caixas de correio. Você só pode usar esse valor sozinho.
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-AddExchangeLocationException
O parâmetro AddExchangeLocationException especifica as caixas de correio a adicionar à lista de caixas de correio excluídas quando estiver a utilizar o valor Tudo para o parâmetro ExchangeLocation. Os valores válidos são:
- Este parâmetro especifica as caixas de correio a serem removidas da lista de caixas de correio excluídas quando você usa o valor All para o parâmetro ExchangeLocation. Os valores válidos são:
- Uma caixa de correio
O valor All para todas as caixas de correio. Você só pode usar esse valor sozinho.
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-AddModernGroupLocation
O parâmetro AddModernGroupLocation especifica o Grupos do Microsoft 365 a adicionar à lista de Grupos do Microsoft 365 incluídos quando não estiver a utilizar o valor All para o parâmetro ModernGroupLocation.
Pode utilizar qualquer valor que identifique exclusivamente o Grupo do Microsoft 365. Por exemplo:
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-AddModernGroupLocationException
O parâmetro AddModernGroupLocationException especifica o Grupos do Microsoft 365 a adicionar à lista de Grupos do Microsoft 365 excluídos quando estiver a utilizar o valor All para o parâmetro ModernGroupLocation.
Pode utilizar qualquer valor que identifique exclusivamente o Grupo do Microsoft 365. Por exemplo:
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-Applications
O parâmetro Aplicações especifica as aplicações a incluir e é relevante apenas para os seguintes parâmetros de localização:
- ExchangeLocation
- ModernGroupLocation
- AdaptiveScopeLocation
Este parâmetro utiliza a seguinte sintaxe: em que "LocationtType:App1,LocationType:App2,...LocationType:AppN LocationType é Utilizador ou Grupo. Por exemplo: "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" ou "User:MicrosoftTeams","User:VivaEngage".
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-Comment
O parâmetro Comment especifica um comentário opcional. Se você especificar um valor que contenha espaços, coloque-o entre aspas ("), por exemplo: “Está é uma observação de administrador”.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-Confirm
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.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-DeletedResources
{{ Descrição de Recursos Eliminados de Preenchimento }}
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-Enabled
O parâmetro Ativado ativa ou desativa a política. Os valores válidos são:
- $true: a política está ativada. Esse é o valor padrão.
- $true: a política está habilitada. Esse é o valor padrão.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-Force
O comutador Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-Identity
O parâmetro Identidade especifica a política de conformidade de retenção de aplicações que pretende modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
| Tipo: | PolicyIdParameter |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-PolicyRBACScopes
O parâmetro PolicyRBACScopes especifica as unidades administrativas a atribuir à política. Um valor válido é o Microsoft Entra ObjectID (valor GUID) da unidade administrativa. Vários valores, separados por vírgulas, podem ser especificados.
As unidades administrativas só estão disponíveis no Microsoft Entra ID P1 ou P2. Pode criar e gerir unidades administrativas no Microsoft Graph PowerShell.
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-RemoveAdaptiveScopeLocation
O parâmetro RemoveAdaptiveScopeLocation especifica a localização do âmbito adaptável a remover da política. Pode criar âmbitos ajustáveis com o cmdlet New-AdaptiveScope. Pode utilizar qualquer valor que identifique exclusivamente o âmbito adaptável. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-RemoveExchangeLocation
O parâmetro RemoveExchangeLocation especifica as caixas de correio a remover da lista de caixas de correio incluídas quando não estiver a utilizar o valor Tudo para o parâmetro ExchangeLocation. Os valores válidos são:
- Este parâmetro especifica as caixas de correio a serem removidas da lista de caixas de correio excluídas quando você usa o valor All para o parâmetro ExchangeLocation. Os valores válidos são:
- Uma caixa de correio
O valor All para todas as caixas de correio. Você só pode usar esse valor sozinho.
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-RemoveExchangeLocationException
O parâmetro RemoveExchangeLocationException especifica as caixas de correio a remover da lista de caixas de correio excluídas quando utiliza o valor Tudo para o parâmetro ExchangeLocation. Os valores válidos são:
- Este parâmetro especifica as caixas de correio a serem removidas da lista de caixas de correio excluídas quando você usa o valor All para o parâmetro ExchangeLocation. Os valores válidos são:
- Uma caixa de correio
O valor All para todas as caixas de correio. Você só pode usar esse valor sozinho.
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-RemoveModernGroupLocation
O parâmetro RemoveModernGroupLocation especifica o Grupos do Microsoft 365 a remover da lista de grupos incluídos quando não estiver a utilizar o valor All para o parâmetro ModernGroupLocation.
Pode utilizar qualquer valor que identifique exclusivamente o Grupo do Microsoft 365. Por exemplo:
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-RemoveModernGroupLocationException
O parâmetro RemoveModernGroupLocationException especifica o Grupos do Microsoft 365 a remover da lista de grupos excluídos quando estiver a utilizar o valor All para o parâmetro ModernGroupLocation.
Pode utilizar qualquer valor que identifique exclusivamente o Grupo do Microsoft 365. Por exemplo:
- Nome
- Nome
- Nome diferenciado (DN)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-RestrictiveRetention
O parâmetro RestrictiveRetention especifica se o Bloqueio de Preservação está ativado para a política. Os valores válidos são:
- $true: O Bloqueio de Preservação está ativado para a política. Ninguém, incluindo um administrador, pode desativar a política ou torná-la menos restritiva.
- $false: O Bloqueio de Preservação não está ativado para a política. Esse é o valor padrão.
Depois de uma política ter sido bloqueada, ninguém pode desativá-la ou desativá-la ou remover aplicações da política. As únicas formas de modificar a política são ao adicionar aplicações à mesma ou ao prolongar a duração. Uma política bloqueada pode ser aumentada ou expandida, mas não pode ser reduzida, desativada ou desativada.
Por conseguinte, antes de bloquear uma política, é fundamental que compreenda os requisitos de conformidade da sua organização e que não bloqueie uma política até ter a certeza de que é o que precisa.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-RetryDistribution
O comutador RetryDistribution especifica se pretende redistribuir a política para todas as localizações. Não é preciso especificar um valor com essa opção.
Locais cujas distribuições iniciais tenham êxito não são incluídos na repetição. Ao usar essa opção, os erros de distribuição de política são relatados.
Nota: uma vez que o processo de repetição da distribuição é uma operação significativa, execute-a apenas se necessário e para uma política de cada vez. Não se destina a ser executado sempre que atualizar uma política. Se executar um script para atualizar várias políticas, aguarde até que a distribuição da política seja bem-sucedida antes de executar o comando novamente para a política seguinte.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |
-WhatIf
A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Security & Compliance |