Set-CaseHoldPolicy
Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, consulte PowerShell de Conformidade de Segurança&.
Use o cmdlet Set-CaseHoldPolicy para modificar as políticas de retenção de casos existentes no portal de conformidade do Microsoft Purview.
Observação: a execução desse cmdlet causa uma sincronização completa em toda a sua organização, que é uma operação significativa. Se você precisar atualizar várias políticas, aguarde até que a distribuição da política seja bem-sucedida antes de executar o cmdlet novamente para a próxima política. Se você precisar atualizar uma política várias vezes, faça todas as alterações em uma única chamada do cmdlet. Para obter informações sobre o status de distribuição, consulte Get-CaseHoldPolicy.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-RetryDistribution]
[-Confirm]
[-WhatIf]
[<CommonParameters>] Set-CaseHoldPolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddPublicFolderLocation <MultiValuedProperty>]
[-AddSharePointLocation <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemovePublicFolderLocation <MultiValuedProperty>]
[-RemoveSharePointLocation <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Description
Para usar esse cmdlet no PowerShell de Conformidade de Segurança & , você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.
Observação: não use um comando de Foreach-Object encanado ao adicionar ou remover locais de escopo: "Value1","Value2",..."ValueN" | Foreach-Object {Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}.
Exemplos
Exemplo 1
Set-CaseHoldPolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"Este exemplo faz as seguintes alterações na política de bloqueio de caso existente chamada "Regulamentação de conformidade 123":
- Adiciona a caixa de correio para a usuária Brenda Fernandes.
- Adiciona o site
https://contoso.sharepoint.com/sites/teams/financedo SharePoint Online . - Remove as pastas públicas.
- Atualiza o comentário.
Parâmetros
-AddExchangeLocation
O parâmetro AddExchangeLocation especifica as caixas de correio a serem adicionadas à lista de caixas de correio incluídas. 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
Para especificar uma caixa de correio ou um grupo de distribuição, você pode usar os seguintes valores:
- Nome
- Endereço SMTP. Para especificar uma caixa de correio inativa, preceda o endereço com um período (.).
- Azure AD ObjectId. Use os cmdlets Get-MgUser ou Get-MgGroup no Microsoft Graph PowerShell para localizar esse valor.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddPublicFolderLocation
O parâmetro AddPublicFolderLocation especifica que você deseja adicionar todas as pastas públicas à política de bloqueio de caso. Use o valor All para esse parâmetro.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSharePointLocation
O parâmetro AddSharePointLocation especifica os sites do SharePoint Online a serem adicionados à lista de sites incluídos quando você não estiver usando o valor All para o parâmetro SharePointLocation. Você pode identificar o site pelo valor da URL.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Os sites do SharePoint Online não podem ser adicionados à política até que tenham sido indexados.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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”.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, cmdlets 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Enabled
O parâmetro Enabled especifica se a política está habilitada. Os valores válidos são:
- $true: a política está habilitada. Esse é o valor padrão.
- $true: a política está habilitada. Esse é o valor padrão.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Force
A opção 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
O parâmetro Identity especifica a política de bloqueio de caso que você deseja modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
| Type: | PolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocation
O parâmetro RemoveExchangeLocation especifica as caixas de correio existentes a serem removidas da política. 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
- Endereço SMTP. Para especificar uma caixa de correio inativa, preceda o endereço com um período (.).
- Azure AD ObjectId. Use os cmdlets Get-MgUser ou Get-MgGroup no Microsoft Graph PowerShell para localizar esse valor.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemovePublicFolderLocation
O parâmetro RemovePublicFolderLocation especifica que você deseja remover todas as pastas públicas da política de bloqueio de caso. Use o valor All para esse parâmetro.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocation
O parâmetro RemoveSharePointLocation especifica os sites do SharePoint Online a serem removidos da lista de sites incluídos quando você não estiver usando o valor All para o parâmetro SharePointLocation. Você pode identificar o site pelo valor da URL.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetryDistribution
A opção RetryDistribution especifica se a política deve ser redistribuída para todos os locais do Exchange Online e do SharePoint Online. 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.
Observação: como o processo de repetição da distribuição é uma operação significativa, execute-a somente se necessário e para uma política por vez. Ele não se destina a ser executado sempre que você atualizar uma política. Se você executar um script para atualizar várias políticas, aguarde até que a distribuição de política seja bem-sucedida antes de executar o comando novamente para a próxima política.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-WhatIf
A opção WhatIf não funciona no PowerShell de Conformidade de Segurança & .
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |