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 und gegebenenfalls 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 des Diagrammzeitschnitts
  • Die maximal zu speichernden Auftragsdatensätze vor dem Löschen der ältesten Aufträge
  • Das Höchstalter 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 Entwässerungszeit 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 Credential-Parameters 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 Diagrammzeitschnitts 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 Anmeldeinformationsobjekts 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 der Runbook-Worker ausgeführte Aufträge beendet, nachdem ein Runbook-Arbeitsdienst beendet wurde. Während der Host abgelassen wird, erhalten vorhandene Aufträge die angegebene Entwässerungszeit sekunden, um natürlich angehalten oder zu beenden, und es werden keine neuen Aufträge 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 aufbewahrt 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 Runbookaufträge auf den Arbeitshosts. Geben Sie Informationen zu Ausführungsrichtlinien ein Get-Help about_Execution_Policies. 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. Teilen Sie 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 einschließen, 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