计划性维护 Cmdlet

下面是计划事件维护的命令列表。

参数必须使用粗体格式。

Disable-AmcSchedule

禁用维护计划。

返回值：空

参数	参数说明
JobId（字符串）	要禁用的作业的数字标识符。

Enable-AmcSchedule

启用维护计划。

返回值：空

参数	参数说明
JobId（字符串）	要启用的作业的数字标识符。

Get-AmcSchedule

通过 JobId 检索单一计划性维护。

返回值：MaintenanceHelper.SchedulesDto

参数	参数说明
JobId（字符串）	要检索的作业的数字标识符。

Invoke-AmcRemoveEventsFromDeploymentGroup

从特定部署组中删除事件。

调用计划创建一个指定类型的临时计划，该计划可立即运行，然后自行删除。

返回值：空

参数	参数说明
GroupName（字符串）	要从中删除事件的部署组的名称。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Invoke-AmcRemoveEventsOlderThan

删除超出指定天数的事件。

调用计划创建一个指定类型的临时计划，该计划可立即运行，然后自行删除。

返回值：空

参数	参数说明
Days（字符串）	事件要保留的天数，任何超出此天数的事件都将被删除。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Invoke-AmcRemoveEventsWithId

删除带有特定 ID 的事件。

调用计划创建一个指定类型的临时计划，该计划可立即运行，然后自行删除。

返回值：空

参数	参数说明
EventId（字符串）	要从数据库中删除的事件 ID。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Invoke-AmcRemoveEventsWithIdRange

删除事件 ID 范围内的所有事件。

调用计划创建一个指定类型的临时计划，该计划可立即运行，然后自行删除。

返回值：空

参数	参数说明
End Event Id（字符串）	范围结束时的事件 ID。
Start Event Id	范围开始时的事件 ID。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Invoke-AmcRemovehighVolumeEventsOlderThan

删除超出指定天数的所有大容量事件。

调用计划创建一个指定类型的临时计划，该计划可立即运行，然后自行删除。

返回值：空

参数	参数说明
Days（字符串）	大容量事件应保留的最长期限。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Invoke-AmcRemoveOrphanedAlerts

删除所有没有任何关联事件的警报。

调用计划创建一个指定类型的临时计划，该计划可立即运行，然后自行删除。

返回值：空

参数	参数说明
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Remove-AmcSchedule

删除带有特定作业 ID 的计划。

返回值：空

参数	参数说明
JobId（字符串）	要删除作业的数字标识符，如 Get-AmcSchedules 所示

Set-AmcEncryptionKeyHash

生成 AMC 加密密钥哈希值。此哈希值用于监控在数据库中存储凭据所用的加密密钥。

返回值：空

参数	参数说明
配置器凭据	Cmdlet 用于更改数据库的凭据。如果省略此参数，则 cmdlet 将使用用户的凭据。
配置器 SQL 身份验证（开关）	指定此开关后，配置器凭据提供的凭据将定义为 SQL 身份验证凭据。如果省略此参数，则配置器凭据将充当 Windows 凭据。
数据库服务器	托管数据库的 SQL Server。
数据库名称	SQL Server 上数据库的名称。

Stop-AmcSchedule

取消指定计划。

返回值：空

参数	参数说明
JobId（字符串）	要取消的作业的数字标识符。

New-AmcScheduleRemoveEventsFromDeploymentGroup

添加新计划，以便在每周的指定日期从特定部署组中删除事件。

返回值：空

参数	参数说明
GroupName（字符串）	要从中删除事件的部署组的名称。
Description（字符串）	管理员使用的“自由文本”字段，用于指定计划条目的用途或相关选择的任何其他详细信息。
DayOfWeek (DayOfWeek)	每周应该执行相应操作的那一天。其值的范围为零（表示星期日）到六（表示星期六）。
StartTimeInUTC（字符串）	一个字符串，表示请求的操作应开始的 UTC 时间。必须可解析为 .Net System.DateTime 值。
MaxRunHours（整数）	操作应该持续的时间。即使作业启动延迟（例如计算机电源关闭），但完成时间始终为 StartTimeInUTC + MaxRunHours。
BatchSize (Int)	每批事务中将受到影响的行数。
BatchDelay (TimeSpan)	SQL 将暂停以允许其他事务进行处理来防止事务锁定的时间量（以秒为单位）。

New-AmcScheduleRemoveEventsOlderThan

添加新计划，以便删除超出指定天数的事件。

返回值：空

参数	参数说明
Days（整数）	事件应保留的最长期限。
Description（字符串）	管理员使用的“自由文本”字段，用于指定计划条目的用途或相关选择的任何其他详细信息。
DayOfWeek (DayOfWeek)	每周应该执行相应操作的那一天。其值的范围为零（表示星期日）到六（表示星期六）。
StartTimeInUTC（字符串）	一个字符串，表示请求的操作应开始的 UTC 时间。必须可解析为 .Net System.DateTime 值。
MaxRunHours（整数）	操作应该持续的时间。即使作业启动延迟（例如计算机电源关闭），但完成时间始终为 StartTimeInUTC + MaxRunHours。
BatchSize (Int)	每批事务中将受到影响的行数。
BatchDelay (TimeSpan)	SQL 将暂停以允许其他事务进行处理来防止事务锁定的时间量（以秒为单位）。

New-AmcScheduleRemoveEventsWithId

创建作业计划条目，以便删除带有指定 ID 的所有事件。

返回值：空

参数	参数说明
EventId（整数）	要删除的事件的“事件日志”数字标识符
Description（字符串）	管理员使用的“自由文本”字段，用于指定计划条目的用途或相关选择的任何其他详细信息。
DayOfWeek (DayOfWeek)	每周应该执行相应操作的那一天。其值的范围为零（表示星期日）到六（表示星期六）。
StartTimeInUTC（字符串）	一个字符串，表示请求的操作应开始的 UTC 时间。必须可解析为 .Net System.DateTime 值。
MaxRunHours（整数）	操作应该持续的时间。即使作业启动延迟（例如计算机电源关闭），但完成时间始终为 StartTimeInUTC + MaxRunHours。
BatchSize (Int)	每批事务中将受到影响的行数。
BatchDelay (TimeSpan)	SQL 将暂停以允许其他事务进行处理来防止事务锁定的时间量（以秒为单位）。

New-AmcScheduleRemoveEventsWithIdRange

添加新计划，以便在每周的指定日期从所有部署组中删除特定值范围内的事件。

返回值：空

参数	参数说明
StartEventId（整数）	要删除的值范围开始的“事件日志”数字标识符。
EndEventId (Int)	要删除的值范围结束的“事件日志”数字标识符。
Description（字符串）	管理员使用的“自由文本”字段，用于指定计划条目的用途或相关选择的任何其他详细信息。
DayOfWeek (DayOfWeek)	每周应该执行相应操作的那一天。其值的范围为零（表示星期日）到六（表示星期六）。
StartTimeInUTC（字符串）	一个字符串，表示请求的操作应开始的 UTC 时间。必须可解析为 .Net System.DateTime 值。
MaxRunHours（整数）	操作应该持续的时间。即使作业启动延迟（例如计算机电源关闭），但完成时间始终为 StartTimeInUTC + MaxRunHours。
BatchSize (Int)	每批事务中将受到影响的行数。
BatchDelay (TimeSpan)	SQL 将暂停以允许其他事务进行处理来防止事务锁定的时间量（以秒为单位）。

New-AmcScheduleRemoveHighVolumeEventsOlderThan

添加新计划，以便删除所有超出指定天数的大容量事件。

返回值：空

参数	参数说明
Days（整数）	事件应保留的最长期限。
Description（字符串）	管理员使用的“自由文本”字段，用于指定计划条目的用途或相关选择的任何其他详细信息。
DayOfWeek (DayOfWeek)	每周应该执行相应操作的那一天。其值的范围为零（表示星期日）到六（表示星期六）。
StartTimeInUTC（字符串）	一个字符串，表示请求的操作应开始的 UTC 时间。必须可解析为 .Net System.DateTime 值。
MaxRunHours（整数）	操作应该持续的时间。即使作业启动延迟（例如计算机电源关闭），但完成时间始终为 StartTimeInUTC + MaxRunHours。
BatchSize (Int)	每批事务中将受到影响的行数。
BatchDelay (TimeSpan)	SQL 将暂停以允许其他事务进行处理来防止事务锁定的时间量（以秒为单位）。

New-AmcScheduleRemoveOrphanedAlerts

添加新计划，以便删除所有没有任何关联事件的警报。

返回值：空

参数	参数说明
Description（字符串）	管理员使用的“自由文本”字段，用于指定计划条目的用途或相关选择的任何其他详细信息。
DayOfWeek (DayOfWeek)	每周应该执行相应操作的那一天。其值的范围为零（表示星期日）到六（表示星期六）。
StartTimeInUTC（字符串）	一个字符串，表示请求的操作应开始的 UTC 时间。必须可解析为 .Net System.DateTime 值。
MaxRunHours（整数）	操作应该持续的时间。即使作业启动延迟（例如计算机电源关闭），但完成时间始终为 StartTimeInUTC + MaxRunHours。
BatchSize (Int)	每批事务中将受到影响的行数。
BatchDelay (TimeSpan)	SQL 将暂停以允许其他事务进行处理来防止事务锁定的时间量（以秒为单位）。

Publish-AmcEncryptionKey

AMC 使用加密密钥在 AMC 数据库中安全地存储敏感信息，例如客户端访问凭据。要使多台服务器从同一数据库读取，需要对该密钥进行同步。

此命令将本地 AMC 加密密钥推送到连接的数据库，以便与其他管理服务器同步。

您可以使用 Sync-AmcEncryptionKey 命令在其他服务器上对此密钥进行同步。此密钥使用提供的参数加密并存储在数据库中。所有服务器同步后，应使用 Unpublish-AmcEncryptionKey 删除此密钥。

返回值：空

参数	参数说明
Password（字符串）	密码用于保护存储在数据库中的凭据。您需要使用此相同密码才能检索其他服务器的密钥。
Secure Password（字符串）	密码用于保护存储在数据库中的凭据。您需要使用此相同密码才能检索其他服务器的密钥。
配置器凭据	Cmdlet 用于更改数据库的凭据。如果省略此参数，则 cmdlet 将使用用户的凭据。
配置器 SQL 身份验证（开关）	指定此开关后，配置器凭据提供的凭据将定义为 SQL 身份验证凭据。如果省略此参数，则配置器凭据将充当 Windows 凭据。
数据库服务器	托管数据库的 SQL Server。
数据库名称	SQL Server 上数据库的名称。

Sync-AmcEncryptionKey

AMC 使用加密密钥在 AMC 数据库中安全地存储敏感信息，例如客户端访问凭据。要使多台服务器从同一数据库读取，需要对该密钥进行同步。

此命令可从 AMC 数据库中提取存储的加密密钥，并在本地服务器上使用。您可以使用 Publish-AmcEncryptionKey 命令从其他服务器发布密钥。所有服务器同步后，应使用 Unpublish-AmcEncryptionKey 删除该密钥。

返回值：空

参数	参数说明
Password（字符串）	密码用于从数据库中读取加密密钥。您需要使用“发布”命令中所用的相同密码。
Secure Password（字符串）	密码用于从数据库中读取加密密钥。您需要使用“发布”命令中所用的相同密码。
配置器凭据	Cmdlet 用于更改数据库的凭据。如果省略此参数，则 cmdlet 将使用用户的凭据。
配置器 SQL 身份验证（开关）	指定此开关后，配置器凭据提供的凭据将定义为 SQL 身份验证凭据。如果省略此参数，则配置器凭据将充当 Windows 凭据。
数据库服务器	托管数据库的 SQL Server。
数据库名称	SQL Server 上数据库的名称。

Unpublish-AmcEncyptionKey

AMC 使用加密密钥在 AMC 数据库中安全地存储敏感信息，例如客户端访问凭据。要使多台服务器从同一数据库读取，需要对该密钥进行同步。

在其他管理服务器同步后，此命令可从连接的数据库删除 AMC 加密密钥。密钥仍将安全地存储在每个服务器上，但不再存储于数据库中。

返回值：空

参数	参数说明
配置器凭据	Cmdlet 用于更改数据库的凭据。如果省略此参数，则 cmdlet 将使用用户的凭据。
配置器 SQL 身份验证（开关）	指定此开关后，配置器凭据提供的凭据将定义为 SQL 身份验证凭据。如果省略此参数，则配置器凭据将充当 Windows 凭据。
数据库服务器	托管数据库的 SQL Server。
数据库名称	SQL Server 上数据库的名称。

Test-AmcEncryptionKey

AMC 使用加密密钥在 AMC 数据库中安全地存储敏感信息，例如客户端访问凭据。要使多台服务器从同一数据库读取，需要对该密钥进行同步。

在同步所有服务器的同时，可将密钥存储在数据库中。此命令将测试是否有可用的密钥。

返回值：空

参数	参数说明
配置器凭据	Cmdlet 用于更改数据库的凭据。如果省略此参数，则 cmdlet 将使用用户的凭据。
配置器 SQL 身份验证（开关）	指定此开关后，配置器凭据提供的凭据将定义为 SQL 身份验证凭据。如果省略此参数，则配置器凭据将充当 Windows 凭据。
数据库服务器	托管数据库的 SQL Server。
数据库名称	SQL Server 上数据库的名称。

Test-AmcEncryptionKeyHash

将哈希值与加密密钥进行比较。若哈希值不存在，则创建一个哈希值。若命令返回 false，则表示加密密钥已更改，可使用存储在数据库中的客户端凭据。

返回值：空

参数	参数说明
配置器凭据	Cmdlet 用于更改数据库的凭据。如果省略此参数，则 cmdlet 将使用用户的凭据。
配置器 SQL 身份验证（开关）	指定此开关后，配置器凭据提供的凭据将定义为 SQL 身份验证凭据。如果省略此参数，则配置器凭据将充当 Windows 凭据。
数据库服务器	托管数据库的 SQL Server。
数据库名称	SQL Server 上数据库的名称。

Test-AmcRemoveEventsFromDeploymentGroup

返回要从指定部署组中删除的事件的数量。

返回值：空

参数	参数说明
Group Name（字符串）	要从中删除事件的部署组的名称。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Test-AmcRemoveEventsOlderThan

返回超出指定天数的待删除事件的数量。

返回值：空

参数	参数说明
Days（字符串）	事件要保留的天数，任何超出此天数的事件都将被删除。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Test-AmcRemoveEventsWithId

返回带有特定 ID 的待删除事件的数量。

返回值：空

参数	参数说明
Event Id（字符串）	要从数据库中删除的事件 ID。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Test-AmcRemoveEventsWithIdRange

返回事件 ID 范围内的待删除事件的数量。

返回值：空

参数	参数说明
End Event Id（字符串）	要从数据库中删除的结束事件 ID 范围。
Start Event Id（字符串）	要从数据库中删除的开始事件 ID 范围。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Test-AmcRemoveHighVolumeEventsOlderThan

返回要删除的事件的数量，这些事件是超出指定天数的大容量事件。

返回值：空

参数	参数说明
Days（字符串）	大容量事件应保留的最长期限。
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Test-AmcRemoveOrphanedAlerts

返回没有任何待删除关联事件的警报的数量。

返回值：空

参数	参数说明
BatchDelay	SQL 将暂停以允许事务进行处理的时间量（以毫秒为单位）。
BatchSize	每批事务中将受到影响的行数。

Update-AmcSchedule

从指定的计划对象更新单一计划性维护。此对象可通过 Get-AmcSchedule 命令获取。

可更新的属性为：

• 说明
• StartTimeInUTC
• 参数
• StartDayOfWeek
• MaxRunHours
• BatchSize
• BatchDelayMs

返回值：空

参数	参数说明
计划 (MaintenanceHelper.SchedulesDto)	计划对象，用于存储计划性维护的参数。