Set-SmaSchedule
在 SMA 中建立或修改排程。
Syntax
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
此參數的預設值為 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 |