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-Credential
ein, 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_Policies
ein, 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 |