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: Segurança & Conformidade

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 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 ponto (.).
• Microsoft Entra 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-AddPublicFolderLocation

Aplicável: Segurança & Conformidade

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: Segurança & Conformidade

O parâmetro AddSharePointLocation especifica os sites do SharePoint 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 não podem ser adicionados à política até que tenham sido indexados.

Propriedades do parâmetro

Conjuntos de parâmetros

-Comment

Aplicável: Segurança & Conformidade

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: Segurança & Conformidade

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer o comando antes de continuar.

Propriedades do parâmetro

Conjuntos de parâmetros

-Enabled

Aplicável: Segurança & Conformidade

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Force

Aplicável: Segurança & Conformidade

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-Identity

Aplicável: Segurança & Conformidade

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: Segurança & Conformidade

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 ponto (.).
• Microsoft Entra 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-RemovePublicFolderLocation

Aplicável: Segurança & Conformidade

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: Segurança & Conformidade

O parâmetro RemoveSharePointLocation especifica os sites do SharePoint 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-RetryDistribution

Aplicável: Segurança & Conformidade

O comutador RetryDistribution especifica se a política deve ser redistribuída para todos os locais do Exchange Online e 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.

Observação: como o processo de repetir a 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 da política seja bem-sucedida antes de executar o comando novamente para a próxima política.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Aplicável: Segurança & Conformidade

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

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters