Freigeben über

Set-SmaSchedule

  • Referenz
Modul:
Microsoft.SystemCenter.ServiceManagementAutomation

Erstellt oder ändert einen Zeitplan in 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>]

Beschreibung

Das Set-SmaSchedule Cmdlet erstellt oder ändert einen Zeitplan in service Management Automation (SMA). Geben Sie den Namen und den Typ des Zeitplans sowie die Start- und Endzeiten an.

Sie können nur die Beschreibung ändern, wenn Sie dieses Cmdlet für einen vorhandenen Zeitplan ausführen. Startzeit, Ablaufzeit und Tagintervall können nur beim Erstellen eines Zeitplans mit diesem Cmdlet festgelegt werden.

Beispiele

Beispiel 1: Erstellen eines Zeitplans

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"

Der erste Befehl erstellt ein Datumsobjekt mithilfe des Cmdlets Get-Date und speichert das Objekt dann in der variablen $StartDate. Dieses Objekt gibt die aktuelle Uhrzeit wieder.

Der zweite Befehl erstellt ein Datumsobjekt mithilfe des Cmdlets Get-Date und speichert das Objekt dann in der variablen $EndDate. Der Befehl gibt eine zukünftige Zeit an. Geben Sie Get-Help Get-Dateein, um weitere Informationen zu erfahren.

Mit dem letzten Befehl wird der Zeitplan "Schedule01" so festgelegt, dass er zu dem in $StartDate gespeicherten Zeitpunkt beginnt und zu dem in $EndDate gespeicherten Zeitpunkt endet.

Parameter

-AuthenticationType

Gibt den Authentifizierungstyp an. Gültige Werte sind:

  • Grundlegend
  • Fenster

Der Standardwert für diesen Parameter ist Windows. Wenn Sie die Standardauthentifizierung verwenden, müssen Sie Anmeldeinformationen mithilfe des Parameters Anmeldeinformationen angeben.

Typ:String
Zulässige Werte:Basic, Windows
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein PSCredential -Objekt für die Verbindung mit dem SMA-Webdienst an. Verwenden Sie das Cmdlet Get-Credential, um ein Anmeldeinformationsobjekt abzurufen. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Stellt eine Beschreibung für den Zeitplan bereit.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExpiryTime

Gibt an, wann der Zeitplan als DateTime- -Objekt endet. Verwenden Sie das cmdlet Get-Date, um ein DateTime--Objekt abzurufen. Geben Sie Get-Help Get-Dateein, um weitere Informationen zu erfahren.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines Zeitplans an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Port

Gibt die Portnummer des SMA-Webdiensts an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScheduleType

Gibt den Typ des Zeitplans an. Gültige Werte für diesen Parameter sind:

  • OneTimeSchedule
  • DailySchedule
Typ:String
Zulässige Werte:OneTimeSchedule, DailySchedule
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StartTime

Gibt an, wann der Zeitplan als DateTime- -Objekt beginnt. Um ein DateTime--Objekt abzurufen, verwenden Sie das Cmdlet Get-Date.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WebServiceEndpoint

Gibt den Endpunkt als URL des SMA-Webdiensts an. Sie müssen das Protokoll einschließen, z. B. http:// oder https://.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False