Set-SmaSchedule
在 SMA 中创建或修改计划。
语法
Set-SmaSchedule
-Name <String>
[-Description <String>]
-ScheduleType <String>
-StartTime <DateTime>
-ExpiryTime <DateTime>
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
Set-SmaSchedule cmdlet 在 Service Management Automation （SMA） 中创建或修改计划。 指定计划的名称和类型，以及开始和结束时间。
仅当针对现有计划运行此 cmdlet 时，才能修改说明。 仅当使用此 cmdlet 创建计划时，才能设置开始时间、到期时间和日间隔。
示例
示例 1：创建计划
PS C:\> $StartDate = Get-Date
PS C:\> $EndDate = Get-Date -Day 12 -Month 6 -Year 2023
PS C:\> Set-SmaSchedule -StartTime $StartDate -ExpiryTime $EndDate -Name "Schedule01" -ScheduleType "DailySchedule" -WebServiceEndpoint "https://contoso.com/app01"第一个命令使用 Get-Date cmdlet 创建日期对象，然后将对象存储在$StartDate变量中。 此对象反映当前时间。
第二个命令使用 Get-Date cmdlet 创建日期对象，然后将对象存储在$EndDate变量中。
该命令指定将来的时间。
有关详细信息，请键入 Get-Help Get-Date。
最后一个命令将名为 Schedule01 的计划设置为从存储在$StartDate的时间开始，并在存储在$EndDate的时间结束
参数
-AuthenticationType
指定身份验证类型。 有效值为：
- 基本
- 窗户
此参数的默认值为 Windows。 如果使用基本身份验证，则必须使用 Credential 参数提供凭据。
| 类型: | String |
| 接受的值: | Basic, Windows |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Credential
为连接到 SMA Web 服务指定 PSCredential 对象。
若要获取凭据对象，请使用 Get-Credential cmdlet。
有关详细信息，请键入 Get-Help Get-Credential。
| 类型: | PSCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
提供计划的说明。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ExpiryTime
指定在 DateTime 对象时，计划结束的时间。
若要获取 DateTime 对象，请使用 Get-Date cmdlet。
有关详细信息，请键入 Get-Help Get-Date。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定计划的名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Port
指定 SMA Web 服务的端口号。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ScheduleType
指定计划的类型。 此参数的有效值为：
- OneTimeSchedule
- DailySchedule
| 类型: | String |
| 接受的值: | OneTimeSchedule, DailySchedule |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-StartTime
指定何时以 DateTime 对象的形式启动计划。 若要获取 DateTime 对象，请使用 Get-Date cmdlet。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WebServiceEndpoint
将终结点指定为 SMA Web 服务的 URL。 必须包括协议，例如 http:// 或 https://。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |