Set-SmaAdminConfiguration

Ändert administrative Konfigurationseinstellungen in SMA.

Syntax

Set-SmaAdminConfiguration
   [-Telemetry <Boolean>]
   [-DrainTimeInSeconds <Int32>]
   [-ScriptExecutionPolicy <String>]
   [-MaxJobRecords <Int32>]
   [-PurgeJobsOlderThanCountDays <Int32>]
   [-Force]
   [-ChartTimeSliceSampleSize <ChartTimeSliceSampleSize>]
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SmaAdminConfiguration ändert die Verwaltungskonfigurationseinstellungen in der Dienstverwaltungsautomatisierung (SMA). Geben Sie den Webdienstendpunkt an, und geben Sie ggf. einen Port an.

Verwenden Sie dieses Cmdlet, um die folgenden Einstellungen zu konfigurieren:

  • Gibt an, ob Diagnose- und Nutzungsdaten für Microsoft freigegeben werden sollen
  • Abflusszeit
  • Skriptausführungsrichtlinie
  • Beispielgröße des Diagrammdatenschnitts
  • Die maximalen Auftragsdatensätze, die gespeichert werden sollen, bevor sie die ältesten Aufträge löschen
  • Das maximale Alter eines Auftrags, bevor er gelöscht wird

Beispiele

Beispiel 1: Ändern einer Administrativen Konfigurationseinstellung

PS C:\> Set-SmaAdminConfiguration -WebServiceEndpoint "https://contoso.com/app01" -DrainTimeInSeconds 60

Dieser Befehl legt die Ablaufzeit auf 60 Sekunden fest.

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

-ChartTimeSliceSampleSize

Gibt die Beispielgröße des Diagrammdatenschnitts an. Gültige Werte sind:

  • Klein
  • Medium
  • Groß
  • Extragroß
Type:ChartTimeSliceSampleSize
Accepted values:Small, Medium, Large, ExtraLarge
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

-DrainTimeInSeconds

Gibt die Zeit in Sekunden an, nach der die Runbook-Worker-Hosts die Ausführung von Aufträgen beenden, nachdem ein Runbook-Arbeitsdienststopp initiiert wurde. Während der Host entleert wird, erhalten vorhandene Aufträge die angegebenen Ablaufzeit sekunden, um natürlich angehalten oder zu beenden, und keine neuen Aufträge werden akzeptiert.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-MaxJobRecords

Gibt die maximale Anzahl von Auftragsdatensätzen an, die beibehalten werden.

Type:Int32
Position:Named
Default value:None
Required:False
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

-PurgeJobsOlderThanCountDays

Gibt die Anzahl der Tage des Auftragsverlaufs an. Aufträge, die älter als dieser Wert sind, werden gelöscht.

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

-ScriptExecutionPolicy

Bestimmt die Windows PowerShell Ausführungsrichtlinie für Runbook-Aufträge auf den Arbeitshosts. Geben Sie Get-Help about_Execution_PoliciesInformationen zu Ausführungsrichtlinien ein. Gültige Parameterwerte:

  • Eingeschränkt. Skripts können nicht ausgeführt werden. Sie können Windows PowerShell nur im interaktiven Modus verwenden.
  • AllSigned. Sie können nur Skripts ausführen, die von einem vertrauenswürdigen Herausgeber signiert sind.
  • RemoteSigned. Heruntergeladene Skripts müssen von einem vertrauenswürdigen Herausgeber signiert werden, bevor Sie die Skripts ausführen können.
  • Unrestricted. Keine Einschränkungen; Sie können alle Windows PowerShell Skripts ausführen.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Telemetry

Gibt an, ob Diagnose- und Nutzungsdaten für Microsoft freigegeben werden sollen. Zulässige Werte für diesen Parameter:

  • $True. Freigeben von Diagnose- und Nutzungsdaten mit Microsoft.
  • $False. Teilen Sie Diagnose- und Nutzungsdaten nicht mit Microsoft.
Type:Boolean
Position:Named
Default value:None
Required:False
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