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
第二個命令會使用 get-Date Cmdlet 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 |
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 |