共用方式為


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>]

Description

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 建立 date 對象,然後將物件儲存在$StartDate變數中。 這個物件會反映目前的時間。

第二個命令會使用 get-Date Cmdlet 建立 date 對象,然後將物件儲存在$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