Freigeben über


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 Cmdlet ändert verwaltungskonfigurationseinstellungen in Service Management Automation (SMA). Geben Sie den Webdienstendpunkt und 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.
  • Entwässerungszeit
  • Skriptausführungsrichtlinie
  • Beispielgröße für Diagrammzeitsegmente
  • Die maximalen Auftragsdatensätze, die gespeichert werden sollen, bevor die ältesten Aufträge gelöscht werden
  • 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

Mit diesem Befehl wird die Entwässerungszeit auf 60 Sekunden festgelegt.

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

-ChartTimeSliceSampleSize

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

  • Klein
  • Mittel
  • Groß
  • ExtraLarge
Typ:ChartTimeSliceSampleSize
Zulässige Werte:Small, Medium, Large, ExtraLarge
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

-DrainTimeInSeconds

Gibt die Zeit in Sekunden an, nach der die Runbook-Workerhosts die Ausführung von Aufträgen beenden, nachdem ein Runbook-Workerdienst beendet wurde. Während der Host entwässert, erhalten vorhandene Aufträge die angegebene Entwässerungszeit Sekunden, um natürlich angehalten oder beendet zu werden, und es werden keine neuen Aufträge akzeptiert.

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

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

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

-MaxJobRecords

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

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
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

-PurgeJobsOlderThanCountDays

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

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

-ScriptExecutionPolicy

Bestimmt die Windows PowerShell-Ausführungsrichtlinie für Runbookaufträge auf den Arbeitshosts. Geben Sie Get-Help about_Execution_Policiesein, um Informationen zu Ausführungsrichtlinien zu erfahren. Gültige Werte für diesen Parameter sind:

  • 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.
  • Frei. Keine Einschränkungen; Sie können alle Windows PowerShell-Skripts ausführen.
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Telemetry

Gibt an, ob Diagnose- und Nutzungsdaten für Microsoft freigegeben werden sollen. Die zulässigen Werte für diesen Parameter sind:

  • $True. Geben Sie Diagnose- und Nutzungsdaten für Microsoft weiter.
  • $False. Geben Sie keine Diagnose- und Nutzungsdaten für Microsoft weiter.
Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
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