你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzureRmBackupRetentionPolicyObject

模块:

AzureRM.Backup

创建备份保留策略。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

New-AzureRmBackupRetentionPolicyObject
   [-DailyRetention]
   -Retention <Int32>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureRmBackupRetentionPolicyObject
   [-WeeklyRetention]
   -DaysOfWeek <String[]>
   -Retention <Int32>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureRmBackupRetentionPolicyObject
   [-MonthlyRetentionInDailyFormat]
   -DaysOfMonth <System.Collections.Generic.List`1[System.String]>
   -Retention <Int32>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureRmBackupRetentionPolicyObject
   [-MonthlyRetentionInWeeklyFormat]
   -DaysOfWeek <String[]>
   -WeekNumber <String[]>
   -Retention <Int32>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureRmBackupRetentionPolicyObject
   [-YearlyRetentionInDailyFormat]
   -DaysOfMonth <System.Collections.Generic.List`1[System.String]>
   -MonthsOfYear <String[]>
   -Retention <Int32>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureRmBackupRetentionPolicyObject
   [-YearlyRetentionInWeeklyFormat]
   -DaysOfWeek <String[]>
   -WeekNumber <String[]>
   -MonthsOfYear <String[]>
   -Retention <Int32>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

New-AzureRmBackupRetentionPolicyObject cmdlet 创建Azure 备份保留策略。 保留策略定义备份保留恢复点的时间。 保留类型如下：

• 每日
• 每周
• 每月
• 每年为计划使用的每种保留类型创建一个保留策略。 一个备份策略至少与一个保留策略相关联。 若要创建备份策略，请使用 New-AzureRmBackupProtectionPolicy cmdlet。 可以改为向 Enable-AzureRmBackupProtection cmdlet 提供保留策略。

示例

示例 1：为每日保留创建保留策略

PS C:\>$Daily = New-AzureRmBackupRetentionPolicyObject -DailyRetention -Retention 30
PS C:\> $Daily
RetentionType      Retention          RetentionTimes
-------------      ---------          --------------
Daily              30

第一个命令创建保留策略，每日保留期为 30 天，然后将其存储在$Daily变量中。 第二个命令显示$Daily的内容。

示例 2：创建每月保留策略

PS C:\>$Monthly = New-AzureRmBackupRetentionPolicyObject -MonthlyRetentionInDailyFormat -DaysOfMonth (10, 20) -Retention 12
PS C:\> $Monthly | select *
RetentionFormat : Daily
DaysOfMonth     : {10, 20}
WeekNumber      : 
DaysOfWeek      : 
RetentionType   : Monthly
Retention       : 12
RetentionTimes  :

第一个命令创建一个保留策略，该策略将备份保留到每月第 10 和 20 个月 12 个月。 该命令将保留策略存储在$Monthly变量中。 第二个命令显示$Monthly的内容。

参数

-DailyRetention

指示此 cmdlet 创建每日保留策略。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysOfMonth

指定月份的天数，用于标识备份保留的恢复点以及保留多长时间。 此参数的可接受值为：从 1 到 28 和 Last 的整数。 如果指定 DailyRetention、MonthlyRetentionInDailyFormat 和 YearlyRetentionInDailyFormat 参数，请指定此参数。

Type:	List<T>[String]
Accepted values:	1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, Last
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysOfWeek

指定一个星期几数组。 此 cmdlet 指定用于标识备份保留的恢复点以及保留多长时间的天数。 此参数的可接受值为：

• 星期一
• 星期二
• 星期三
• 星期四
• 星期五
• 星期六
• 如果指定 WeeklyRetention、MonthlyRetentionInWeeklyFormat 和 YearlyRetentionInWeeklyFormat 参数，则指定此参数。 确保为备份选择的一周中的天数和保留期保持一致。 例如，如果为星期六设置了备份，则保留策略也必须使用星期六。

Type:	String[]
Accepted values:	Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthlyRetentionInDailyFormat

指示此 cmdlet 以每日格式创建每月策略。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthlyRetentionInWeeklyFormat

指示此 cmdlet 以“每周”格式创建每月策略。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MonthsOfYear

指定备份每年保留的恢复点的月份。 此参数的可接受值为：月份的名称，例如 1 月或 2 月。

Type:	String[]
Accepted values:	January, February, March, April, May, June, July, August, September, October, November, December
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Retention

指定备份存储备份点的保留期（以天、月或年为单位）。 该单位取决于此 cmdlet 是选择每日、每月还是每年保留选项。 例如，如果指定 DailyRetention 参数，则 cmdlet 会将当前参数解释为天数。

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WeeklyRetention

指示此 cmdlet 创建每周保留策略。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WeekNumber

指定一个月的几周，用于确定备份保留的恢复点以及保留多长时间。 此参数的可接受值为：

• 第一个
• 第二个
• 第三个
• 第四
• Last

Type:	String[]
Accepted values:	First, Second, Third, Fourth, Last
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-YearlyRetentionInDailyFormat

指示此 cmdlet 以每日格式创建每年保留策略。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-YearlyRetentionInWeeklyFormat

指示此 cmdlet 以每周格式创建每年保留策略。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

AzureRMBackupRetentionPolicy

备注

• 无

相关链接

• Enable-AzureRmBackupProtection
• New-AzureRmBackupProtectionPolicy