Set-CaseHoldPolicy

Sintaxe

RetryDistribution

Set-CaseHoldPolicy
    [-Identity] <PolicyIdParameter>
    [-RetryDistribution]
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

Identity

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

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"

Parâmetros

-AddExchangeLocation

Aplicável: Conformidade do & de Segurança

O parâmetro AddExchangeLocation especifica as caixas de correio a adicionar à 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, pode utilizar os seguintes valores:

• Nome
• Endereço SMTP. Para especificar uma caixa de correio inativa, preceda o endereço com um ponto final (.).
• Microsoft Entra ObjectId. Utilize os cmdlets Get-MgUser ou Get-MgGroup no Microsoft Graph PowerShell para localizar este valor.

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Propriedades do parâmetro

Conjuntos de parâmetros

-AddPublicFolderLocation

Aplicável: Conformidade do & de Segurança

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-AddSharePointLocation

Aplicável: Conformidade do & de Segurança

O parâmetro AddSharePointLocation especifica os sites do SharePoint a adicionar à lista de sites incluídos quando não estiver a utilizar o valor Tudo 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 não podem ser adicionados à política até serem indexados.

Propriedades do parâmetro

Conjuntos de parâmetros

-Comment

Aplicável: Conformidade do & de Segurança

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”.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Aplicável: Conformidade do & de Segurança

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

Conjuntos de parâmetros

-Enabled

Aplicável: Conformidade do & de Segurança

O parâmetro Enabled especifica se a política está habilitada. Os valores válidos são:

• $true: a política está ativada. Este valor é a predefinição.
• $true: a política está habilitada. Esse é o valor padrão.

Propriedades do parâmetro

Conjuntos de parâmetros

-Force

Aplicável: Conformidade do & de Segurança

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-Identity

Aplicável: Conformidade do & de Segurança

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

Propriedades do parâmetro

Conjuntos de parâmetros

-RemoveExchangeLocation

Aplicável: Conformidade do & de Segurança

O parâmetro RemoveExchangeLocation especifica as caixas de correio existentes a remover 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 ponto final (.).
• Microsoft Entra ObjectId. Utilize os cmdlets Get-MgUser ou Get-MgGroup no Microsoft Graph PowerShell para localizar este valor.

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Propriedades do parâmetro

Conjuntos de parâmetros

-RemovePublicFolderLocation

Aplicável: Conformidade do & de Segurança

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-RemoveSharePointLocation

Aplicável: Conformidade do & de Segurança

O parâmetro RemoveSharePointLocation especifica os sites do SharePoint a remover da lista de sites incluídos quando não estiver a utilizar o valor Tudo 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-RetryDistribution

Aplicável: Conformidade do & de Segurança

O comutador RetryDistribution especifica se pretende redistribuir a política para todas as Exchange Online e localizações do SharePoint. 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Aplicável: Conformidade do & de Segurança

A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters