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

此参数的默认值为 Windows。 如果使用基本身份验证,则必须使用 Credential 参数提供 凭据

Type:String
Accepted values:Basic, Windows
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Credential

指定连接到 SMA Web 服务的 PSCredential 对象。 若要获取凭据对象,请使用 Get-Credential cmdlet。 要了解详情,请键入 Get-Help Get-Credential

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

-Description

提供计划的说明。

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

-ExpiryTime

指定何时以 DateTime 对象的形式结束计划。 若要获取 DateTime 对象,请使用 Get-Date cmdlet。 要了解详情,请键入 Get-Help Get-Date

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

-Name

指定计划的名称。

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

-Port

指定 SMA Web 服务的端口号。

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

-ScheduleType

指定计划的类型。 此参数的有效值是:

  • OneTimeSchedule
  • DailySchedule
Type:String
Accepted values:OneTimeSchedule, DailySchedule
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StartTime

指定何时(作为 DateTime 对象)开始计划。 若要获取 DateTime 对象,请使用 Get-Date cmdlet。

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

-WebServiceEndpoint

将终结点指定为 SMA Web 服务的 URL。 必须包括协议,例如 http:// 或 https://。

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

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

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