Define o objetivo da política para um grupo de proteção.
\n","uid":"DataProtectionManager.Set-DPMPolicyObjective"}]},"_xrefmap":{"DataProtectionManager":{"href":"./","monikerGroup":"594ff497cf66f8c251c1f711aee4ac11","name":"DataProtectionManager","schemaType":"PowershellModule","uid":"DataProtectionManager"},"DataProtectionManager.Set-DPMPolicyObjective":{"href":"set-dpmpolicyobjective","monikerGroup":"594ff497cf66f8c251c1f711aee4ac11","name":"Set-DPMPolicyObjective","schemaType":"PowershellCmdlet","summary":"Define o objetivo da política para um grupo de proteção.
\n","uid":"DataProtectionManager.Set-DPMPolicyObjective"}},"description":"O cmdlet Set-DPMPolicyObjective
Se você especificar o objetivo de proteção usando o cmdlet Set-DPMPolicyObjective, o DPM definirá automaticamente os agendamentos padrão.\nPara alterar os agendamentos padrão, use o cmdlet Get-DPMPolicySchedule seguido pelo cmdlet Set-DPMPolicySchedule.
\n","examples":[{"code":"PS C:\\>$PGroup = Get-ProtectionGroup -DPMServerName \"DPMServer02\"\nPS C:\\> $MPGroup = Get-ModifiableProtectionGroup $PGroup[0]\nPS C:\\> Set-DPMPolicyObjective -ProtectionGroup $MPGroup -RetentionRangeInDays 10 -SynchronizationFrequency 360","description":"O primeiro comando obtém os objetos do grupo de proteção do servidor DPM chamado DPMServer02 e os armazena na variável $PGroup.
\nO segundo comando usa a notação de matriz padrão para especificar o segundo membro da matriz $PGroup no formato editável e armazena o grupo de proteção na variável $MPGroup.
\nO terceiro comando define o objetivo da política para o grupo de proteção em $MPGroup para um intervalo de retenção de 10 dias e a frequência de sincronização de 6 horas, que é de 360 minutos.
\n","summary":"","title":"Exemplo 1: Definir o objetivo da política para um grupo de proteção"},{"code":"PS C:\\>$Rr = New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 1,\"months\"\nPS C:\\> $PGroup = Get-ProtectionGroup -DPMServerName \"DPMServer02\"\nPS C:\\> $MPGroup = Get-ModifiableProtectionGroup $PGroup[0]\nPS C:\\> Set-DPMPolicyObjective -ProtectionGroup $MPGroup -RetentionRange 360 -LongTermBackupFrequency Weekly","description":"O primeiro comando cria um objeto RetentionRange e o armazena na variável $Rr.
\nO segundo comando obtém grupos de proteção do servidor DPM chamado DPMServer02 e os armazena na variável $PGroup.
\nO terceiro comando usa a notação de matriz padrão para especificar o primeiro membro da matriz $PGroup no formato editável e armazena o grupo de proteção editável na variável $MPGroup.
\nO quarto comando define o intervalo de retenção para o grupo de proteção como 360 dias e a frequência de backup de longo prazo como semanal.
\n","summary":"","title":"Exemplo 2: Definir o intervalo de retenção para um servidor DPM"},{"code":"PS C:\\>$PGroup = Get-ProtectionGroup -DPMServerName \"DPMServer02\"\nPS C:\\> $MPGroup = Get-ModifiableProtectionGroup $PGroup[0]\nPS C:\\> Set-DPMPolicyObjective -RetentionRangeInWeeks 12 -ShortTermBackupFrequency Daily -ProtectionGroup $MPGroup","description":"Este exemplo mostra outra maneira de definir um intervalo de retenção para um servidor DPM.
\nO primeiro comando obtém grupos de proteção do servidor DPM chamado DPMServer02 e os armazena na variável $PGroup.
\nO segundo comando usa a notação de matriz padrão para especificar o primeiro membro da matriz $PGroup no formato editável e armazena o grupo de proteção editável na variável $MPGroup.
\nO terceiro comando define o intervalo de retenção para o grupo de proteção como 12 semanas e a frequência de backup de curto prazo como diária.
\n","summary":"","title":"Exemplo 3: Definir um intervalo de retenção"},{"code":"PS C:\\>$RRList = @()\nPS C:\\> $RRList += (New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 180, Days)\nPS C:\\> $RRList += (New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 104, Weeks)\nPS C:\\> $RRList += (New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 60, Month)\nPS C:\\> $RRList += (New-Object -TypeName Microsoft.Internal.EnterpriseStorage.Dls.UI.ObjectModel.OMCommon.RetentionRange -ArgumentList 10, Years)\nPS C:\\> $PGroup = Get-ProtectionGroup -DPMServerName \"DPMServer02\"\nPS C:\\> $MPGroup = Get-ModifiableProtectionGroup -ProtectionGroup $PGroup[0]\nPS C:\\> Set-DPMPolicyObjective -ProtectionGroup $MPGroup -OnlineRetentionRangeList $RRList","description":"O primeiro comando cria uma matriz de objetos RetentionRange armazenada na variável $RRlist.
\nO segundo, o terceiro, o quarto e o quinto comandos criam objetos RetentionRange e os adicionam a $RRlist.
\nO sexto comando obtém grupos de proteção do servidor DPM chamado DPMServer02 e os armazena na variável $PGroup.
\nO sétimo comando usa a notação de matriz padrão para especificar o primeiro membro da matriz $PGroup no formato editável e armazena o grupo de proteção editável na variável $MPGroup.
\nO comando final define os intervalos de retenção online para o grupo de proteção e a frequência de backup online de longo prazo como diárias.
\n","summary":"","title":"Exemplo 4: Definir os intervalos de retenção para proteção online"}],"links":[{"href":"get-dpmpolicyobjective","text":"Get-DPMPolicyObjective"},{"href":"get-dpmpolicyschedule","text":"Get-DPMPolicySchedule"},{"href":"set-dpmpolicyschedule","text":"Set-DPMPolicySchedule"}],"module":"DataProtectionManager","name":"Set-DPMPolicyObjective","notes":"","outputs":[{"description":"","name":"Schedule\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"Especifica o número de dias após o backup mais recente que o DPM aguarda antes de gerar um alerta.
\n","isRequired":true,"name":"AlertThresholdInDays","parameterValueGroup":"","position":"2","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Indica que o DPM executa a sincronização antes de criar pontos de recuperação.
\n","name":"BeforeRecoveryPoint","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Indica se o DPM habilita a colocação.
\n","isRequired":true,"name":"ColocateDatasources","parameterValueGroup":"","position":"2","type":"Boolean\n"},{"aliases":"cf","defaultValue":"False","description":"Solicita a confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Indica que o DPM cria backups incrementais.
\n","name":"CreateIncrementals","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifica uma matriz de frequências de backup que os três objetivos de proteção definem.
\nOs valores aceitáveis para este parâmetro são:
\nAnual
\nSemesto anual
\nTrimestral
\nMensal
\nQuinzenalmente
\nSemanalmente
\nDiário
\n","isRequired":true,"name":"FrequencyList","parameterValueGroup":"","position":"3","type":"Int32[]
\n"},{"aliases":"","defaultValue":"None","description":"Especifica uma matriz de gerações que os três objetivos de proteção definem.
\nOs valores aceitáveis para este parâmetro são:
\nGenerationType[]
\n"},{"aliases":"","defaultValue":"None","description":"Especifica a frequência de backup para proteção de longo prazo.
\nOs valores aceitáveis para este parâmetro são:
\nEspecifica o intervalo de retenção para proteção online.
\n","isRequired":true,"name":"OnlineRetentionRange","parameterValueGroup":"","position":"2","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Especifica uma matriz de períodos de retenção que definem os intervalos de retenção para proteção online.
\n","isRequired":true,"name":"OnlineRetentionRangeList","parameterValueGroup":"","position":"2","type":"RetentionRange[]
\n"},{"aliases":"","defaultValue":"None","description":"Retorna um objeto que representa o item com o qual você está trabalhando.\nPor padrão, esse cmdlet não gera nenhuma saída.
\n","name":"PassThru","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifica um grupo de proteção para o qual esse cmdlet define um objetivo de política.\nPara obter um objeto
Especifica a duração para a qual o DPM mantém os dados em fita para proteção de longo prazo.
\n","isRequired":true,"name":"RetentionRange","parameterValueGroup":"","position":"2","type":"RetentionRange\n"},{"aliases":"RetentionRangeInDays","defaultValue":"None","description":"Especifica o número de dias para os quais o DPM mantém uma réplica.
\n","isRequired":true,"name":"RetentionRangeDays","parameterValueGroup":"","position":"2","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Especifica o número de semanas para as quais o DPM mantém uma réplica.
\n","isRequired":true,"name":"RetentionRangeInWeeks","parameterValueGroup":"","position":"2","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Especifica uma matriz de períodos de retenção que os três objetivos de proteção definem.
\n","isRequired":true,"name":"RetentionRangeList","parameterValueGroup":"","position":"2","type":"RetentionRange[]
\n"},{"aliases":"","defaultValue":"None","description":"Especifica a frequência de backup para proteção de curto prazo.
\nOs valores aceitáveis para este parâmetro são:
\nEspecifica a frequência de sincronização, em minutos.
\n","name":"SynchronizationFrequencyMinutes","parameterValueGroup":"15, 30, 45, 60, 120, 240, 360, 720, 1440","position":"3","type":"Int32\n"},{"aliases":"wi","defaultValue":"False","description":"Mostra o que aconteceria se o cmdlet fosse executado.\nO cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Define o objetivo da política para um grupo de proteção.
\n","syntaxes":["Set-DPMPolicyObjective [-RetentionRangeDays]Define o objetivo da política para um grupo de proteção.
\n","uid":"DataProtectionManager.Set-DPMPolicyObjective"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/dataprotectionmanager/set-dpmpolicyobjective?view=systemcenter-ps-2025","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/dataprotectionmanager/set-dpmpolicyobjective?view=systemcenter-ps-2025"},"pageMetadata":"O cmdlet Set-DPMPolicyObjectiveSe você especificar o objetivo de proteção usando o cmdlet Set-DPMPolicyObjective, o DPM definirá automaticamente os agendamentos padrão.\nPara alterar os agendamentos padrão, use o cmdlet Get-DPMPolicySchedule seguido pelo cmdlet Set-DPMPolicySchedule.
\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\nDefine o objetivo da política para um grupo de proteção.\n\" />\r\n [-ProtectionGroup]