Set-AutoSensitivityLabelPolicy

O parâmetro AddExchangeLocation adiciona mensagens de e-mail à política se ainda não estiverem incluídas. O valor válido para este parâmetro é Tudo.

Se a política ainda não incluir mensagens de e-mail (na saída do cmdlet Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation está em branco), pode utilizar este parâmetro nos seguintes procedimentos:

• Se utilizar -AddExchangeLocation All por si só, a política aplica-se ao e-mail de todos os utilizadores internos.

• Para incluir e-mails de utilizadores internos ou externos específicos na política, utilize -AddExchangeLocation All com o parâmetro ExchangeSender no mesmo comando. Apenas o e-mail dos utilizadores especificados está incluído na política.

• Para incluir o e-mail de membros específicos do grupo na política, utilize -AddExchangeLocation All com o parâmetro ExchangeSenderMemberOf no mesmo comando. Apenas o e-mail dos membros dos grupos especificados está incluído na política.

• Para excluir o e-mail de utilizadores internos específicos da política, utilize -AddExchangeLocation All com o parâmetro ExchangeSenderException no mesmo comando. Apenas o e-mail dos utilizadores especificados é excluído da política.

• Para excluir o e-mail de membros específicos do grupo da política, utilize -AddExchangeLocation All com o parâmetro ExchangeSenderMemberOfException no mesmo comando. Apenas o e-mail dos membros dos grupos especificados é excluído da política.

Não pode especificar inclusãos e exclusões na mesma política.

O parâmetro AddOneDriveLocation especifica o OneDrive for Business sites a adicionar à lista de sites incluídos quando não estiver a utilizar o valor Tudo para o parâmetro OneDriveLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

O parâmetro AddOneDriveLocationException especifica o OneDrive for Business sites a adicionar à lista de sites excluídos quando utiliza o valor Tudo para o parâmetro OneDriveLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

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

Os sites do SharePoint Online não podem ser adicionados à política até serem indexados.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

O parâmetro AddSharePointLocationException especifica os sites do SharePoint Online a adicionar à lista de sites excluídos quando utiliza o valor Tudo para o parâmetro SharePointLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

O parâmetro ApplySensitivityLabel seleciona a etiqueta a utilizar para a política. Esta ação substituirá a etiqueta anterior na política.

O parâmetro AutoEnableAfter permite-lhe ativar automaticamente a política após um período de tempo definido na simulação sem modificações à política. Tem de definir explicitamente este parâmetro após cada edição de política para manter ou repor a ativação automática linha do tempo.

Para especificar um valor, insira-o como um período de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Um valor válido é entre 1 hora e 25 dias. Para limpar uma agenda AutoEnableAfter existente associada a uma política, utilize o valor $null.

Tem de utilizar este parâmetro com o parâmetro -StartSimulation.

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

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.

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.

O parâmetro ExceptIfOneDriveSharedBy especifica os utilizadores a excluir da política (os sites da OneDrive for Business contas de utilizador estão incluídos na política). Identifica os utilizadores por UPN (laura@contoso.onmicrosoft.com).

Para utilizar este parâmetro, uma das seguintes instruções tem de ser verdadeira:

• A política já inclui OneDrive for Business sites (na saída de Get-AutoSensitivityLabelPolicy, o valor da propriedade OneDriveLocation é Tudo, que é o valor predefinido).
• Utilize -AddOneDriveLocation All no mesmo comando com este parâmetro.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Não pode utilizar este parâmetro com o parâmetro OneDriveSharedBy.

{{ Preenchimento ExcetoIfOneDriveSharedByMemberOf Description }}

{{ Fill ExchangeAdaptiveScopes Description }}

{{ Fill ExchangeAdaptiveScopesException Description }}

O parâmetro ExchangeSender especifica os utilizadores cujo e-mail está incluído na política. Especifique os utilizadores por endereço de e-mail. Pode especificar endereços de e-mail internos ou externos.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Para utilizar este parâmetro, uma das seguintes instruções tem de ser verdadeira:

• A política já inclui mensagens de e-mail (na saída do cmdlet Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é Tudo).
• Utilize -AddExchangeLocation All no mesmo comando com este parâmetro.

Não pode utilizar este parâmetro com os parâmetros ExchangeSenderException ou ExchangeSenderMemberOfException.

O parâmetro ExchangeSenderException especifica os utilizadores internos cujo e-mail é excluído da política. Identifica os utilizadores por endereço de e-mail.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Para utilizar este parâmetro, uma das seguintes instruções tem de ser verdadeira:

• A política já inclui mensagens de e-mail (na saída de Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é Tudo).
• Utilize -AddExchangeLocation All no mesmo comando com este parâmetro.

Não pode utilizar este parâmetro com os parâmetros ExchangeSender ou ExchangeSenderMemberOf.

O parâmetro ExchangeSenderMemberOf especifica os grupos de distribuição ou grupos de segurança com capacidade de correio a incluir na política (o e-mail dos membros do grupo está incluído na política). Você identifica os grupos por endereço de email.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Para utilizar este parâmetro, uma das seguintes instruções tem de ser verdadeira:

• A política já inclui mensagens de e-mail (na saída de Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é Tudo).
• Utilize -AddExchangeLocation All no mesmo comando com este parâmetro.

Não pode utilizar este parâmetro com os parâmetros ExchangeSenderException ou ExchangeSenderMemberOfException.

Não pode utilizar este parâmetro para especificar Grupos do Microsoft 365.

O parâmetro ExchangeSenderMemberOfException especifica os grupos de distribuição ou grupos de segurança com capacidade de correio a excluir da política (o e-mail dos membros do grupo é excluído da política). Você identifica os grupos por endereço de email.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Para utilizar este parâmetro, uma das seguintes instruções tem de ser verdadeira:

• A política já inclui mensagens de e-mail (na saída de Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é Tudo).
• Utilize -AddExchangeLocation All no mesmo comando com este parâmetro.

Não pode utilizar este parâmetro com os parâmetros ExchangeSender ou ExchangeSenderMemberOf.

Não pode utilizar este parâmetro para especificar Grupos do Microsoft 365.

O parâmetro ExternalMailRightsManagementOwner especifica o endereço de e-mail de uma caixa de correio de utilizador que é utilizada para encriptar mensagens de e-mail recebidas de remetentes externos através do RMS.

Este parâmetro só funciona em localizações do Exchange e a política tem de aplicar uma etiqueta que tenha uma ação de encriptação.

Para limpar um endereço de e-mail existente, utilize o valor $null.

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.

O parâmetro Identidade especifica a política de etiquetagem automática que pretende modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

• Nome
• DN (nome diferenciado)
• GUID

{{ Descrição de Localizações de Preenchimento }}

O parâmetro Modo especifica o nível de ação e notificação da política de etiquetagem automática. Os valores válidos são:

• Ativar: a política está ativada para ações e notificações.
• Enable: a política está habilitada para notificações e ações. Este é o valor padrão.
• TestWithNotifications: não suportado.
• TestWithoutNotifications: um modo de auditoria no qual não são efetuadas ações e não são enviadas notificações (modo de teste).

{{ Fill OneDriveAdaptiveScopes Description }}

{{ Fill OneDriveAdaptiveScopesException Description }}

O parâmetro OneDriveSharedBy especifica os utilizadores a incluir na política (os sites da OneDrive for Business contas de utilizador estão incluídos na política). Identifica os utilizadores por UPN (laura@contoso.onmicrosoft.com).

Para utilizar este parâmetro, uma das seguintes instruções tem de ser verdadeira:

• A política já inclui OneDrive for Business sites (na saída de Get-AutoSensitivityLabelPolicy, o valor da propriedade OneDriveLocation é Tudo, que é o valor predefinido).
• Utilize -AddOneDriveLocation All no mesmo comando com este parâmetro.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Não pode utilizar este parâmetro com o parâmetro ExceptIfOneDriveSharedBy.

{{ Preencher OneDriveSharedByMemberOf Description }}

O parâmetro OverwriteLabel especifica se deve substituir uma etiqueta manual. Os valores válidos são:

• $true: substitua a etiqueta manual.
• $false: não substitua a etiqueta manual. Esse é o valor padrão.

Este parâmetro só funciona em localizações do Exchange.

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.

Esse parâmetro está reservado para uso interno da Microsoft.

O parâmetro Priority especifica um valor de prioridade para a política que determina a ordem do processamento de políticas. Um valor inteiro inferior indica uma prioridade mais alta, o valor 0 é a prioridade mais alta e as políticas não podem ter o mesmo valor de prioridade.

Os valores válidos e o valor predefinido para este parâmetro dependem do número de políticas existentes. Por exemplo, se existirem 5 políticas existentes:

• Os valores de prioridade válidos para as 5 políticas existentes são de 0 a 4.
• Os valores de prioridade válidos para uma nova 6ª política são de 0 a 5.
• O valor predefinido para uma nova 6ª política é 5.

Se modificar o valor de prioridade de uma política, a posição da política na lista é alterada para corresponder ao valor de prioridade que especificar. Por outras palavras, se definir o valor de prioridade de uma política para o mesmo valor que uma política existente, o valor de prioridade da política existente e de todas as outras políticas de prioridade inferior após ser aumentado em 1.

O parâmetro RemoveExchangeLocation remove as mensagens de e-mail da política, se já estiverem incluídas. O valor válido para este parâmetro é Tudo.

Se a política já incluir mensagens de e-mail (na saída do cmdlet Get-AutoSensitivityLabelPolicy, o valor da propriedade ExchangeLocation é Tudo), pode utilizar -RemoveExchangeLocation All para impedir que a política seja aplicada às mensagens de e-mail.

Não pode utilizar este parâmetro se o e-mail (o valor Exchange) for utilizado por qualquer uma das regras associadas.

O parâmetro RemoveOneDriveLocation especifica o OneDrive for Business sites a remover da lista de sites incluídos quando não estiver a utilizar o valor All para o parâmetro OneDriveLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

Este parâmetro RemoveOneDriveLocationException especifica o OneDrive for Business sites a remover da lista de sites excluídos quando utiliza o valor Tudo para o parâmetro OneDriveLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

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

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

O parâmetro RemoveSharePointLocationException especifica os sites do SharePoint Online a remover da lista de sites excluídos quando utiliza o valor Tudo para o parâmetro SharePointLocation. Você pode identificar o site pelo valor da URL.

Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>".

O comutador RetryDistribution redistribui a política para todas as OneDrive for Business e localizações 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.

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.

{{ Preencher SharePointAdaptiveScopes Descrição }}

{{ Fill SharePointAdaptiveScopesException Description }}

O parâmetro SpoAipIntegrationEnabled ativa ou desativa a etiquetagem incorporada para ficheiros suportados do Office no SharePoint e no OneDrive. Os valores válidos são:

• $true: os utilizadores podem aplicar as etiquetas de confidencialidade no Office para a Web. Os utilizadores veem o botão Confidencialidade no friso para que possam aplicar etiquetas e ver o nome de qualquer etiqueta aplicada na barra de status.
• $false: os utilizadores não podem aplicar as etiquetas de confidencialidade no Office para a Web. Além disso, a cocriação, a Deteção de Dados Eletrónicos, a prevenção de perda de dados do Microsoft Purview, a pesquisa e outras funcionalidades de colaboração não funcionam para ficheiros encriptados.

Utilize o parâmetro StartSimulation para reiniciar a simulação para obter resultados atualizados. Os valores válidos são:

• $true: Reinicie a simulação para obter resultados atualizados. As edições a uma política de etiquetagem automática requerem o reinício da simulação com este valor.
• $false: este é o valor predefinido

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