Set-SmaSchedule

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 Cmdlet Set-SmaSchedule erstellt oder ändert einen Zeitplan in der Service Management Automation (SMA). Geben Sie den Namen und den Typ des Zeitplans und die Anfangs- und Endzeiten an.

Sie können nur die Beschreibung ändern, wenn Sie dieses Cmdlet für einen vorhandenen Zeitplan ausführen. Startzeit, Ablaufzeit und Tagesintervall 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 dann das Objekt in der $StartDate-Variable. Dieses Objekt spiegelt die aktuelle Uhrzeit wider.

Der zweite Befehl erstellt ein Datumsobjekt mithilfe des Cmdlets "Get-Date ", und speichert dann das Objekt in der $EndDate Variablen. Mit dem Befehl wird ein Zeitpunkt angegeben, der in der Zukunft liegt. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Date.

Der letzte Befehl legt den Zeitplan mit dem Namen "Schedule01" fest, der zum Zeitpunkt beginnt, der in $StartDate gespeichert ist und zu dem zeitpunkt, der in $EndDate gespeichert ist.

Parameter

-AuthenticationType

Gibt den Authentifizierungstyp an. Gültige Werte sind:

  • Basic
  • Windows

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

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Credential

Gibt ein PSCredential-Objekt für die Verbindung mit dem SMA-Webdienst an. Verwenden Sie zum Abrufen eines Anmeldeinformationenobjekts das Cmdlet Get-Credential. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

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

-Description

Stellt eine Beschreibung für den Zeitplan bereit.

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

-ExpiryTime

Gibt an, wann, als DateTime-Objekt , der Zeitplan endet. Verwenden Sie zum Abrufen eines DateTime-Objekts das Cmdlet Get-Date. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Date.

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

-Name

Gibt den Namen eines Zeitplans an.

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

-Port

Gibt die Portnummer des SMA-Webdiensts an.

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

-ScheduleType

Gibt den Zeitplantyp an. Gültige Parameterwerte:

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

-StartTime

Gibt an, wann, als DateTime-Objekt , der Zeitplan beginnt. Verwenden Sie zum Abrufen eines DateTime-Objekts das Cmdlet "Get-Date ".

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

-WebServiceEndpoint

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

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

-WhatIf

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

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