INHALTSVERZEICHNIS


Beschreibung:

Wenn Du die Smart Updates Gruppeneinstellungen wie bspw. die Verzögerung, das Downloadverhalten oder sogar gesetzte Kategorien über alle Deine Kunden hinweg anpassen möchtest, empfehlen wir die Nutzung unseres PowerShell-Skripts "ChangeSUSettings.ps1".

Das Skript kann alle Einstellungen anpassen, die im OCC für die Gruppen anpassbar sind.


Das Skript findest Du hier in unserem GitHub Repository.


Beachte:
Das Skript setzt einen API-Key voraus. Bitte sorge also dafür, dass der Ersteller des API-Keys entsprechend genügend Rechte besitzt und auch alle Kunden in der Verwaltung hat.

Wie Du einen API-Key erstellst: Anleitung - Wie erstelle ich einen API Key?


Vorbereitung

Du benötigst unser Powershell Helper Modul. Falls Du dieses noch nicht installiert hast, führe bitte folgendes FAQ durch:

→ Installation Powershell Helper Modul


Anleitung

Nachdem Du das Skript gespeichert hast, navigiere bitte in Deiner PowerShell in den entsprechenden Ordner, wo das Skript abgelegt ist:

cd "Pfad"


Den AuthToken (API-Key) definierst Du wie folgt als Variable:

$authtoken = "API-Key"


Jetzt folgen einige Beispiel-Befehle, um Smart Updates Einstellungen über das Skript vorzunehmen.



"Verzögerung in Tagen" und "Installationszeitfenster in Tagen"

Get-SECustomer -AuthToken $authtoken | ForEach-Object {.\ChangeSUSettings.ps1 -AuthToken "ApiKey" -CustomerId $_.CustomerID -DelayInstallByDays "7" -InstallWindowInDays "30" -ViewFilterName "Workstation"}

Es wurden für alle Workstation-Gruppen aller Kunden die Verzögerung auf 7 Tage und das Installationszeitfenster auf 30 Tage gesetzt.
Bitte ändere hier also ggf. den Parameter "ViewfilterName" ab zu dem entsprechenden Gruppennamen. Lässt Du den Parameter komplett weg, werden alle Gruppen berücksichtigt.


Update Kategorien

Get-SECustomer -AuthToken $authtoken | ForEach-Object {& '.\ChangeSUSettings.ps1' -AuthToken $authtoken -CustomerId $_.CustomerID -AddCategories DOT_NET_FRAMEWORK_4_8}
Es wurde jeder Gruppe die .NET 4.8. Kategorie hinzugefügt.


Downloadverhalten

Get-SECustomer -AuthToken $authtoken| %{& '.\ChangeSUsettings.ps1' -AuthToken $authtoken -CustomerId $_.CustomerID -DownloadStrategy DIRECT_ONLY}
Es wurden für alle Gruppen das Downloadverhalten auf "ausschließlich direkter Download" gestellt.


Auflistung aller möglichen Parameter

Folgend noch eine Auflistung aller möglichen Skriptparameter, die dem Skript mitgegeben werden können:


    .PARAMETER AuthToken
    Nutzt die Session oder einen ApiKey. Wenn der Parameter nicht gesetzt ist wird 
    die globale servereye Session genutzt.

    .PARAMETER CustomerId
    Die Kunden ID des Kunden, bei dem die Einstellungen geaendert werden sollen. 
    Hier koennen auch mehrere Kunden mitgegeben werden, indem Get-SECustomer 
    an das Skript gepiped wird.

    .PARAMETER ViewFilterName
    Der Name der Gruppe, die angepasst werden soll.

    .PARAMETER DelayInstallByDays
    Dauer, um die die Installation von Updates verzoegert wird. Massgeblich ist der 
    Tag, an dem das Update veroeffentlicht wurde.

    .PARAMETER InstallWindowInDays
    Zeitraum fuer die Installation, bevor ein Alarm ausgeloest wird.

    .PARAMETER EnableRebootNotify
    Bei ausstehenden Updates wird dem Benutzer ein Hinweis auf einen 
    erforderlichen Neustart des Systems angezeigt.

    .PARAMETER MaxRebootNotifyIntervalInHours
    Stunden bis dem Benutzer der Hinweis erneut angezeigt wird.

    .PARAMETER DelayRebootNotifyByDays
    Zeitraum in dem der Benutzer auf einen Systemneustart hingewiesen wird, bevor 
    ein Alarm ausgeloest wird. Das Abbrechen der Installation ist dann nicht mehr 
    moeglich.

    .PARAMETER MaxScanAgeInDays
    Ab wie vielen Tagen ohne Scan moechtest du einen Alarm?

    .PARAMETER DownloadStrategy
    Waehle aus ueber welche Wege die Updates heruntergeladen werden duerfen:
    "FILEDEPOT_ONLY" (Ausschliesslich ueber das FileDepot downloaden),
    "FILEDEPOT_AND_DIRECT" (Primaer ueber das FileDepot downloaden, als Fallback 
    ueber den direkten Weg),
    "DIRECT_ONLY" (Ausschliesslich ueber den direkten Weg downloaden ohne 
    FileDepot)

    .PARAMETER AddCategories
    Update Kategorien die hinzugefuegt werden sollen.

    .PARAMETER RemoveCategories
    Update Kategorien die entfernt werden sollen.