New-AppRetentionCompliancePolicy
Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, confira PowerShell de Conformidade de Segurança&.
Use o New-AppRetentionCompliancePolicy para criar políticas de conformidade de retenção de aplicativo. As políticas de rotulagem de retenção & de aplicativo visam novas maneiras de escopo e gerenciamento de políticas.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
New-AppRetentionCompliancePolicy
[-Name] <String>
-AdaptiveScopeLocation <MultiValuedProperty>
-Applications <String[]>
[-Confirm]
[-Comment <String>]
[-Enabled <Boolean>]
[-Force]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] New-AppRetentionCompliancePolicy
[-Name] <String>
-Applications <String[]>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] Description
Os cmdlets *-AppRetentionCompliance* são usados para políticas com escopos de política adaptáveis e todas as políticas estáticas que abrangem canais privados do Teams, chats do Yammer e mensagens da comunidade do Yammer. Eventualmente, você usará esses cmdlets para a maioria dos locais de retenção e tipos de política. Os cmdlets *-RetentionCompliance* continuarão a dar suporte principalmente a locais do Exchange e do SharePoint. Para políticas criadas com os cmdlets *-AppRetentionCompliance*, você só pode definir a lista de escopos incluídos ou excluídos para todas as cargas de trabalho incluídas, o que significa que você provavelmente precisará criar uma política por carga de trabalho.
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.
Exemplos
Exemplo 1
New-AppRetentionCompliancePolicy -Name "Regulation 567 Compliance" -Applications "User:MicrosoftTeams,Yammer","Group:MicrosoftTeams,Yammer" -ExchangeLocation "Jennifer Petersen","Kitty Nakamura"Este exemplo cria uma política de retenção de escopo estático chamada Conformidade do Regulamento 567 para as mensagens de usuário do Yammer de Jennifer Petersen e Kitty Nakamura.
Depois de criar a política de retenção, use o cmdlet New-AppRetentionComplianceRule para criar uma regra de retenção e atribuí-la à política de retenção.
Parâmetros
-AdaptiveScopeLocation
O parâmetro AdaptiveScopeLocation especifica o local de escopo adaptável a ser incluído na política. Você cria escopos adaptáveis usando o cmdlet New-AdaptiveScope. Você pode usar qualquer valor que identifique exclusivamente o escopo adaptável. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Applications
O parâmetro Aplicativos especifica os aplicativos a serem incluídos na política e é relevante apenas para os seguintes parâmetros de local:
- ExchangeLocation
- ModernGroupLocation
- AdaptiveScopeLocation
Esse parâmetro usa a seguinte sintaxe: "LocationtType:App1,LocationType:App2,...LocationType:AppN onde o LocationType é Usuário ou Grupo. Por exemplo: "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" ou "User:MicrosoftTeams","User:Yammer".
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 Habilitado habilita ou desabilita a política. 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 |
-ExchangeLocation
O parâmetro ExchangeLocation especifica as caixas de correio a serem incluídas na política. 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.
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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ExchangeLocationException
O parâmetro ExchangeLocationException especifica as caixas de correio excluídas da política quando você usa o valor All 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".
| Type: | MultiValuedProperty |
| 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 |
-ModernGroupLocation
O parâmetro ModernGroupLocation especifica o Grupos do Microsoft 365 a ser incluído na política. Os valores válidos são:
- Um grupo do Microsoft 365
- O valor All para todos os Grupos do Microsoft 365. Você só pode usar esse valor sozinho.
Para identificar o Grupo do Microsoft 365, você pode usar qualquer valor que o identifique exclusivamente. 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ModernGroupLocationException
O parâmetro ModernGroupLocationException especifica o Grupos do Microsoft 365 a excluir da política quando você usa o valor All para o parâmetro ModernGroupLocation.
Você pode usar 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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Name
O parâmetro Name especifica um nome exclusivo para a política de conformidade de retenção de aplicativo. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PolicyRBACScopes
{{ Fill PolicyRBACScopes Description }}
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RestrictiveRetention
O parâmetro RestrictiveRetention especifica se o Bloqueio de Preservação está habilitado para a política. Os valores válidos são:
- $true: o Bloqueio de Preservação está habilitado 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á habilitado para a política. Esse é o valor padrão.
Depois que uma política for bloqueada, ninguém poderá desativá-la ou desativá-la ou remover aplicativos da política. As únicas maneiras de modificar a política são adicionando aplicativos a ela ou estendendo sua duração. Uma política bloqueada pode ser aumentada ou estendida, mas não pode ser reduzida, desabilitada ou desativada.
Portanto, antes de bloquear uma política, é fundamental que você entenda os requisitos de conformidade da sua organização e que não bloqueie uma política até ter certeza de que é o que você precisa.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |