XOAPBaselineModuleDSC ist eine Kernkomponente des Configuration Management Moduls. Mit der Verwendung von XOAPBaselineModuleDSC in Konfigurationen erhalten Sie die Möglichkeit, Anwendungen zu installieren, den Compliance-Status Ihrer Knoten zu überwachen und vieles mehr.

Aktuelle Version

Die aktuelle Version des Moduls lautet 0.1.14.

Notwendige Aktualisierung

Das aktualisierte DSC Baseline-Modul enthält kleinere Fehlerkorrekturen und Verbesserungen der Kompatibilität.

Diese Version (0.1.15) ist nun für alle XOAP-Implementierungen erforderlich, um ein konsistentes Verhalten der Basiskonfiguration zu gewährleisten.

Sie können die Basismodul-ZIP-Datei herunterladen. Aus diesem Link.

So aktualisieren Sie

Downloaden Sie das Baseline-Modul und laden Sie es in Ihren XOAP-Arbeitsbereich hoch.

In Configuration Management„Modulen“ klicken Sie auf die Schaltfläche „Neues Modul“.
 

Laden Sie das Modul hoch und klicken Sie auf „Bestätigen“. Das Modul ist nach etwa 10–15 Minuten einsatzbereit.

Jetzt müssen Sie Ihre Konfiguration neu kompilieren.

Gehen Sie Configuration Management zu „Einstellungen“ und suchen Sie Ihre Konfiguration.

Klicken Sie im Menü „Aktionen“ auf „Rekompilieren“.

Für das XOAP Baseline-Modul wählen Sie die Version 0.1.15 und klicken Sie auf „Speichern“.

Der letzte Schritt besteht darin, Ihre Konfigurationsgruppe zu bearbeiten. Ändern Sie die Version auf die neue und klicken Sie auf „Speichern“.

Ihre Konfiguration ist in 10 bis 15 Minuten fertig.

Wichtiger Hinweis:
Es sind keine manuellen Änderungen an Ihren Knoten erforderlich. Aktualisierungen werden automatisch durchgeführt.

The post About XOAP Baseline Module appeared first on XOAP.

Dies dient als Einführung zu Configuration Management, in der die Zielsetzung, die Vorteile und die wichtigsten Funktionen des Programms beschrieben werden.

Configuration Management (Configuration Management) ist eine erweiterte Implementierung der Microsoft PowerShell Desired State Configuration (DSC), einer essentiellen Komponente für die Konfiguration, Verwaltung und Wartung von Windows- und Linux-Nodes. Sie ermöglicht die Festlegung der Konfiguration eines Knotens mithilfe eines deklarativen Modells auf einfache und standardisierte Weise, die sich leicht zu verwalten und zu verstehen ist.

Mit Configuration Management, definiert die Infrastruktur Code als Grundlage, der eine konsistente Konfiguration, Versionierung und Testbarkeit gewährleistet. Server und Clients Configuration Management, die von Configuration Management sind, werden kontinuierlich anhand ihres gewünschten Zustands evaluiert. Darüber hinaus achtet sie auf Konfigurationsabweichungen und stellt sicher, dass diese automatisch korrigiert werden und alle konfigurierten Änderungen angewendet werden, wo immer sie vergeben wurden.

Es ist egal, ob Sie DSC auf Servern oder auf Ihren Arbeitsstationen verwenden.

Schauen Sie sich unser Video an YouTube-Video für eine visuelle Einführung

Wesentliche Merkmale

• Erstellen und sichern Standardisierte Konfigurationen und diese zu Gruppen oder einzelnen Hosts zuweisen
• Der gewünschte Zustand wird kontinuierlich ausgewertet und gegebenenfalls korrigiert – um eine konsequente Konfiguration
• Anpassbar Code für Flexibilität – erstellen Sie Ihre eigenen Konfigurationen oder Module und wenden sie dort an, wo sie benötigt werden
• Schmerzfreie Migration und Verwaltung durch die Integration der Lösung in einem kleinen Umfang an Hostsystemen nebeneinander und mit Ihrem eigenen Tempo voranzukommen
• Du kopierst die Codebasis und ordest sie in mehrere Infrastrukturen ein, um eine reproducibel und unveränderbare Infrastruktur. Sie können demselben Konfigurationssatz Ihre lokalen Knoten oder Knoten unter Public Cloud-Umgebung zuweisen.
• Implementieren Code-Testen Tools, um die Ergebnisse Ihrer Konfigurationen automatisch zu testen
• Ersetzen der manuellen Infrastrukturkonfiguration und Bereitstellung Durch die Verwendung der gewünschten Konfigurationssprache; sie ist so konzipiert, dass sie von Menschen gelesen und verstanden werden kann, sowie einfach zu schreiben und zu erweitern.
• Aktivieren Cloud-Einführung Durch die Nutzung der on-demand-Infrastruktur der Cloud in Verbindung mit einem robusten und benutzerfreundlichen Konfigurationsmanagement-System. Die Infrastruktur passt sich automatisch an Ihren Fortschritt bei der Integration weiterer Hostsysteme in die Lösung an.
• On-Premises-Support – Es ist egal, ob Sie Ihr eigenes Rechenzentrum haben oder Ihre Workloads vollständig in der Cloud bereitstellen. Wir unterstützen viele Umgebungen, die über ein Netzwerk erreichbar sind.

Anwendungsfälle

• Komplettes Konfigurationsmanagement von Microsoft Windows-Infrastrukturdienstleistungen
• Unkomplizierte Konfigurationsverwaltung von Windows-Clients und Desktops
• Gruppenrichtlinien ersetzen und VMs ohne Active Directory-Verbindung konfigurieren (z. B. DMZ-VMs)
• Windows-Funktionen installieren und konfigurieren
• Verwenden Sie unsere intuitive Benutzeroberfläche, um PowerShell DSC an Ihre IT-Mitarbeiter zu liefern
• Paketinstallationen bei Konfigurationsmanagement-Veranstaltungen ausführen (mit Application Management basiert auf PowerShell App Deployment Toolkit)

Top-Vorteile

• Vereinheitliche Infrastrukturaufgaben, indem Sie einen oder mehrere Knoten automatisch konfigurieren.
• Alle Knoten innerhalb einer Rolle gleich konfigurieren
• Verhindern Sie die Abweichung der Konfigurationen im Laufe der Zeit
• Automatisieren Sie die Bereitstellung auf Anfrage oder “massiv”, vollautomatisiert und unabhängig von der Position eines Knotens.

The post About Configuration Management appeared first on XOAP.

Configuration Management

PowerShell

Alle Knoten, die zur Erstellung oder Abgabe von Konfigurationen verwendet werden, sind aktiv. WMF-Version 5.1 oder höher. Autorisierende Knoten, die zur lokalen Erstellung von Konfigurationen verwendet werden, müssen eine Internetverbindung haben, um neue DSC-bezogene Ressourcen herunterzuladen.

Fernverwaltung

Der WS-Management- (WS-MAN-) Datenverkehr ist im Netzwerk erlaubt. Er wird standardmäßig aktiviert bei Knoten, die über die folgenden Eigenschaften verfügen: PowerShell-Version 5 Installiert, aber Sie müssen sicherstellen, dass es nicht durch Firewalls oder andere Netzwerkkomponenten blockiert wird. Lesen Sie weiter für weitere Informationen.

Kommunikation mit unserem Backend

Um mit unserer Backend-Software kommunizieren zu können, müssen die folgenden Ports geöffnet sein: https://api.xoap.io auf dem Hafen 443.

Proxy-Konfiguration für Knoten

Um sicherzustellen, dass PowerShell-DSC-Node einen Proxy-Server verwenden, um mit dem in der Cloud gehosteten Backend zu kommunizieren, müssen einige Anpassungen an der Node-Konfiguration vorgenommen werden, bevor der Node registriert werden kann. DSC kommuniziert nicht im Benutzerkontext und verwendet daher den SYSTEM-Kontext.

Um DSC erfolgreich zu verbinden und den Knoten zu registrieren, passen Sie die folgenden Zeilen in der machine.config in Ihrem .Verzeichnis der .NET-Installation.

Sie sollten die Datei an diesen Speicherorten finden:

32-Bit
**%windir%\Microsoft.NET\Framework\[Version]\config\machine.config**
64-Bit
**%windir%\Microsoft.NET\Framework64\[Version]\config\machine.config**
[Version] sollte der Version v1.0.3705, v1.1.4322, v2.0.50727 oder v4.0.30319 entsprechen. v3.0 und v3.5 enthalten lediglich zusätzliche Bausteine zu v2.0.50727, sodass es keine config\machine.config-Dateien geben sollte. v4.5.x und v4.6.x sind in v4.0.30319 gespeichert.
Fügen Sie dann die folgenden Zeilen hinzu:

Firewalls

Die SSL-Entschlüsselung kann zu Problemen führen, wenn Clients innerhalb Ihres Unternehmensnetzwerks versuchen, mit der Cloud-Back-End-Infrastruktur zu kommunizieren.

DEP

Wir haben einige Virenscanner mit DEP aktiviert gesehen, die verhindern, dass Benutzer erfolgreich in die Cloud-Backends einloggen können.

TLS

Aktivieren TLS 1.2 Sofern möglich. Andernfalls funktioniert das Konfigurationsmanagement nicht erfolgreich.

Stellen Sie dies über PowerShell ein:

Set-ItemProperty -Pfad 'HKLM:\SOFTWARE\Microsoft\.NetFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Wert '1' -Typ DWordSet-ItemProperty -Pfad 'HKLM:\SOFTWARE\Wow6432Node\Microsoft\.NetFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Wert '1' -Typ DWordSet-ItemProperty -Pfad 'HKLM:\SOFTWARE\Microsoft\.NetFramework\v2.0.50727' -Name 'SchUseStrongCrypto' -Wert '1' -Typ DWord[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12

The post Prerequisites appeared first on XOAP.

Schnellübersicht

Node sind Geräte, die in Ihrem XOAP-Arbeitsbereich registriert werden, wenn eine Konfiguration zu ihnen zugeordnet wird. Nachdem sie registriert wurden, sind sie in XOAP sichtbar und können über die Desired State Configuration-Konfigurationen verwaltet und überwacht werden.

Ein Knoten hinzufügen

1. Um einen Knoten zu Ihrem Arbeitsbereich hinzuzufügen (registrieren), verwenden Sie die Konfigurationsgruppe Registrierbefehl/Skript.
2. Gehen Sie zu Configuration Management → Konfigurationsgruppen.
3. Wählen Sie eine Konfigurationsgruppe aus (z. B., XOAP nicht zugewiesen) und öffne die Aktionsmenü (⋮).
4. Wählen Sie Kopieren der Registrierungskommandos Um den Befehl in den Zwischenablage zu kopieren.
5. Öffnen Sie das Programm auf dem Zielgerät. PowerShell als Administrator und fügen Sie den Befehl ein.
6. Führen Sie den Befehl aus, um das Gerät zu registrieren. Der Knoten wird in der entsprechenden Gruppe in Ihrem XOAP-Arbeitsbereich hinzugefügt.

Node aktualisieren

1. Klick auf den Aktionsmenü (⋮) nahe dem Knotenpunkt.
2. Wählen Sie Details Um den vollständigen Systeminventar zu sehen.
3. Auf der Detailseite können Sie die Daten aktualisieren. Tags und Überprüfung Hardware, Software, und Konformität Informationen.

Ein Knoten löschen

1. Klick auf den Aktionsmenü (⋮) und wählen Sie Löschen.
2. Bestätigen Sie die Löschung, indem Sie auf klicken. Löschen.

Weitere nützliche Informationen

Windows- und Linux-Geräte:

Die Knoten können Windows Geräte. Linux Die Geräte werden über die XOAP-Konnektor und sind unter der Bestandsaufnahme Das Modul. Windows-Geräte können auch das XOAP-Konnektor installiert und werden unter dem Bestandsaufnahme Modul, das weiterhin über das Configuration Management parallel.

Konfigurationsgruppe:

Node können nur einer Konfigurationsgruppe zugeordnet werden, und Änderungen können unter dem Bereich „Konfigurationsgruppe“ vorgenommen werden.

Unterstützung für PowerShell:

Die Registrierung und Verwaltung von Nodes ist derzeit nur mit PowerShell 5.1 möglich. PowerShell Core wird nicht unterstützt.

Technische Dokumentation

Node sind Geräte, die in Ihrem XOAP-Arbeitsbereich registriert werden, wenn eine Konfiguration auf sie angewendet wird. Nach der Registrierung sind sie in XOAP sichtbar und können zentral verwaltet und überwacht werden anhand ihrer zugeordneten Konfigurationen, einschließlich Inventarinformationen und des Konformitätsstatus, der Ergebnisse der Konfigurationsausführung sowie der betrieblichen Leistungsfähigkeit. Dies ermöglicht eine einheitliche Einhaltung der Konfigurationsstandards innerhalb der gesamten Umgebung und bietet eine klare Übersicht über den aktuellen Zustand und die Konfigurationsänderungen jedes einzelnen Geräts.

Der Node-Status in XOAP gibt den aktuellen Konfigurationszustand eines Geräts an, basierend auf den neuesten Ergebnissen der Konfigurationsauswertung und -ausführung. Die folgenden Status werden verwendet:

• Konform: Der Knoten entspricht der zugeordneten Konfiguration. Alle erforderlichen Einstellungen werden angewendet, und die letzte Auswertung wurde erfolgreich abgeschlossen, ohne dass Abweichungen festgestellt wurden.
• Nicht konform: Der Knoten entspricht nicht der zugeordneten Konfiguration. Ein oder mehrere erforderliche Einstellungen fehlen, sind fehlerhaft oder konnten bei dem letzten Test nicht implementiert werden.
• Laufen: Eine Konfigurationsprüfung ist derzeit am Knoten im Gange. XOAP führt die Konfiguration aktiv durch oder evaluiert sie, und das endgültige Compliance-Ergebnis steht noch nicht zur Verfügung.

Sie können die Konformitätshistorie auf zwei Arten überprüfen:

• Klick auf den Compliance-Status Icon.
• Öffnen Sie die Aktionsmenü (⋮) und wählen Sie Compliance-Verlauf.

Beide Methoden öffnen dieselbe Ausklappansicht, die die Compliance-Informationen für das letzte Jahr zeigt. 14 Tage. Wenn Sie den Status-Eintrag erneut anklicken, können Sie Details zu einer bestimmten Konfigurationsanwendung anzeigen. Detailprotokolle sind für Ressourcen verfügbar, die sich nicht im gewünschten Zustand befinden.

Um die Details des vollständigen Knotens anzuzeigen, klicken Sie auf Node-Name oder öffnen Sie Aktionsmenü (⋮) und wählen Sie Details.

Die Details view bietet eine detaillierte Darstellung des aktuellen Zustands des Knotens in mehreren Kategorien:

• Hardware: BIOS, Prozessoren, Geräte und Volumes.
• Networking: Alle Details zur Benutzeroberfläche und die Netzwerkkonfigurationen.
• Betriebssystem: Realtime-Listen von Diensten, geplanten Aufgaben und lokalen Benutzern.
• Instandhaltung und Richtlinien: Installierte Updates und Status der DSC-Funktion (Desired State Configuration).

The post Nodes appeared first on XOAP.

Schnellübersicht

A Konfigurationsgruppe ist ein logischer Container in XOAP, der zuweist eine bestimmte Konfiguration a Politik und optional ein Anwendung Rolle zu einer Gruppe von Knoten.

Erstellen einer neuen Konfigurationsgruppe

1. Klicken Sie in der oberen rechten Ecke auf + Gruppeneinstellen.
2. Geben Sie die Gruppenname und auswählen/zusenden Tags.
3. Wählen Sie im Dropdown-Menü oben das gewünschte Element aus. Anwendung Rolle.
4. Verlegen von Knoten aus Verfügbare Knoten zu Ausgewählte Knoten um sie in diese Gruppe einzureihen.
5. Konfiguration und Konfigurationsversion auswählen
6. Wählen Sie „Richtlinie“
7. Klicken Sie auf Erstellen zum Abschluss.

Eine Konfigurationsgruppe bearbeiten

1. Klick auf den Menü Aktion (⋮) und wählen Sie bearbeiten.
2. Aktualisieren Sie den Namen, die Richtlinie, die Anwendungsrolle, die Tags oder ändern Sie die zugeordneten Konfigurationen.
3. Klicken Sie auf Speichern Sie Um alle Änderungen anzuwenden.

Eine Konfigurationsgruppe löschen

1. Klick auf den Menü Aktion (⋮) und wählen Sie Löschen.
2. Bestätigen Sie die Löschung, indem Sie auf klicken. Löschen.

Weitere nützliche Informationen

Konfigurationsgruppen und -knoten:

In den Konfigurationsgruppen können Sie nur Knoten hinzufügen (Verfügbare Knoten), die noch nicht einer anderen Konfigurationsgruppe zugeordnet sind. Knoten können in den Details der Konfigurationsgruppe entfernt werden.

Um einen neuen Knoten zu registrieren (ein Knoten, der noch nicht in Ihrem XOAP-Arbeitsbereich verfügbar ist), führen Sie das Registrierungsskript oder die Registrierungskommandos in PowerShell auf dem Knoten aus. Eine Konfigurationsgruppe kann nur eine Konfigurationsrolle und eine Anwendungrolle zugeordnet haben.

Technische Dokumentation

A Konfigurationsgruppe ist ein logischer Container in XOAP, der eine bestimmte Konfiguration—und optional eine Anwendung Rolle und Politik—zu einem Satz von Knoten. Die durch die Gruppe registrierten Knoten übernehmen diese Zuordnungen, und die Gruppenansicht bietet einen Überblick darüber, wie viele Knoten vorhanden sind. konform, Nicht konform, oder Aktuell läuft die Konfiguration.

Um Knoten in Ihrem Arbeitsbereich zu registrieren, führen Sie den Befehl Registrierungs-Skript (oder Registrierbefehl) auf dem Zielknoten mit Windows PowerShell 5.1 als Administrator.

Das Registrierungsscript/das Kommando finden Sie im Menü „Aktionen“ (⋮):

1. Klick auf den Aktionsmenü (⋮) und wählen Sie Download des Registrierungsskripts oder Kopieren der Registrierungskommandos.
2. Auf dem Zielsystem (Node) öffnen Windows PowerShell 5.1 als Administrator, und entweder:
   • Starten Sie das heruntergeladene Skript, oder
   • Fügen Sie den Registrierungsvorgang ein und führen Sie ihn aus.
3. Die angegebene Konfiguration wird auf den Knoten angewendet. Falls ein Anwendung Rolle Ist die Festlegung erfolgt, werden auch die zugeordneten Anwendungen installiert.
4. Der Knoten wird in der Knotenpunkte Tisch unter Configuration Management.

Beide Methoden verwenden die gleiche Konfiguration und liefern das gleiche Ergebnis.

Massenregistrierung (Bereitstellung an mehrere Knoten)

Um viele Knoten gleichzeitig zu registrieren, verteilen Sie die Registrierbefehl/Skript mit Ihren vorhandenen Softwarebereitstellungs- oder Richtliniemitteln. Die Registrierung muss in einem erhöhten Kontext (Administrator/SYSTEM) ausgeführt werden.

Option 1: Gruppenrichtlinie (GPO) – Scheduled Task oder Startup Script

Verwenden Sie eine Domänen-GPO, um die Registrierung auf den Zielgeräten auszuführen:

• Planmäßige Aufgabe (empfohlen): Erstellen Sie eine GPO-Veranstaltungstaste, die beim Start ausgeführt wird wie SYSTEM und führt den Registrierungsvorgang aus.
• Startup-Skript: Geben Sie ein Startskript fest, das während des Bootens ausgeführt wird (computerübergreifend).
  Diese Methode ist einfach zu handhaben, funktioniert gut bei großen Flotten und stellt sicher, dass das Kommando mit den erforderlichen Berechtigungen ausgeführt wird.

Option 2: Microsoft SCCM / MECM

Die Registrierung als SCCM-Paket/Anwendung bereitstellen:

• Starten Sie den Registrierungsvorgang/Skript wie folgt: Lokales System.
• Ziel ist eine Gerätekollektion (z. B. zunächst eine Pilotgruppe, dann eine breitere Einführung).
  Dies bietet Reporting-, Wiederholungslogik und eine kontrollierte Einführung.

Option 3: Microsoft Intune (proaktive Korrekturmaßnahmen oder Skript-Implementierung)

Für Entra ID-/Intune-verwaltete Geräte:

• Den Registrierungsschriftcode als Gerätsschriftcode bereitstellen oder verwenden Proaktive Sanierungen Um es einmal zu starten und zu überprüfen, ob der Knoten registriert ist.
• Sorgen Sie dafür, dass das Skript in Systemkontext für erforderliche Berechtigungen.

Option 4: Fernausführung (PowerShell Remoting)

Wenn PowerShell Remoting verfügbar ist:

• Verwenden Sie Invoke-Command, um den Registrierungsvorgang auf einer Liste von Zielcomputern unter einem Konto mit lokalen Administratorrechten auszuführen.
  Dies ist nützlich für die schnelle Einführung kleinerer Chargen oder ad-hoc-Gruppen.

Praktische Tipps für die Massenbereitstellung

• Verwenden Sie ein Pilotgruppe Zuerst wird die Konnektivität, die Berechtigungen und das zu erwartende Verhalten überprüft.
• Stellen Sie sicher, dass die Umgebung eine Abrufmöglichkeit für HTTP-Verbindungen (443) zum XOAP-API-Endpunkt ermöglicht.
• Verhindern Sie das Neuverarbeiten von bereits registrierten Nodes, indem Sie die entsprechenden Ziel- bzw. Ausschlusseinstellungen in Ihrem Bereitstellungs-Tool verwenden (z. B. SCCM-Sammlungen oder GPO-Bereichsdefinitionen).

Voraussetzungen zur Registrierung eines Knotens

• Windows-Gerät
• Starten Sie als Administrator
• 64-bit Windows PowerShell (nicht PowerShell ISE)
• Windows PowerShell 5.1 mit DSC (PSDesiredStateConfiguration) Verfügbar
• WinRM / PowerShell Remoting Kann aktiviert und neu gestartet werden
• Ausgangsverkehr HTTPS (443) Zugriff (oder eine funktionierende Proxy-Verknüpfung zu SYSTEM-Zugriff) auf: https://api.xoap.io

The post Groups appeared first on XOAP.

Schnellübersicht

A Modul ist eine verpackte Sammlung von DSC-Ressourcen, die die Bausteine bereitstellen, die zur Erstellung und Kompilierung von XOAP-Konfigurationen verwendet werden. Module legen fest, welche Ressourcen im Konfigurationsassistenten verfügbar sind und welche Einstellungen auf verwalteten Knoten angewendet werden können.

Ein neues Modul hochladen

1. Gehen Sie zu Configuration Management → Module.
2. Klicken Sie auf Modulen hochladen.
3. Laden Sie das Modulpaket hoch (unterstützte Formate: .zip oder .nupkg).
4. Aktivieren Erlauben Sie Überschreibungen, falls sie bereits vorhanden sind Wenn Sie ein bestehendes Modul/eine bestehende Version ersetzen möchten.
5. Klicken Sie auf Weiter, Überprüfen Sie die Details, bearbeiten Sie sie ggf. und füllen Sie die Upload-Anforderung aus.

Modul bearbeiten

1. Klick auf den Aktionsmenü (⋮) Neben einem Modul und wählen Sie Details.
2. Überprüfen Sie Informationen zu Modulen wie Name, Version, Beschreibung, und Veröffentlichungshinweise, und verwaltet Tags Falls erforderlich.
3. Verwenden Sie Herunterladen In der Detailansicht können Sie die ausgewählte Modulversion herunterladen.

Ein Modul löschen

1. Klick auf den Aktionsmenü (⋮) Neben einem Modul und wählen Sie Löschen.
2. Bestätigen Sie die Löschung.

Weitere nützliche Informationen

Unterstützte Modulpaketformate

Module können wie folgt hochgeladen werden: .zip oder .nupkg Pakete.

Modul-Upload für fehlende Ressourcen

Wenn in der Konfigurations-Assistenten keine erforderliche Ressource verfügbar ist, laden Sie das entsprechende Modul in Configuration Management → Module.

Modulversionen

In XOAP können mehrere Versionen desselben Moduls existieren, sodass Konfigurationen anhand spezifischer Modulversionen erstellt werden können.

Moduleabhängigkeiten

Wenn ein Modul Voraussetzungen (Abhängigkeiten) zu anderen Modulen hat, müssen alle erforderlichen Module hochgeladen werden, damit die Ressourcen verfügbar und nutzbar sind.

Zeit für die Modulkompilierung

Wenn Sie ein Modul hochladen, geben Sie bitte 10–15 Minuten Zeit, damit es im Hintergrund kompiliert wird, bevor es im Konfigurationsassistenten verwendet werden kann.

Technische Dokumentation

A Modul ist eine veredelte Version der DSC-Ressourcen, die die Bausteine für XOAP-Konfigurationen. Module legen fest, welche Ressourcen in der Konfigurationsassistent, Die Parameter, die konfiguriert werden können, sowie die Einstellungen, die auf verwalteten Knoten angewendet werden können.

Technisch gesehen ist ein Modul ein Standard-PowerShell-Modul, das eine oder mehrere Recursos de DSC. Jedes Ressource stellt eine “Einheit der Implementierung” dar (z. B. Register, Dienst, Datei oder Funktion) und enthält Parameter, die den gewünschten Zustand beschreiben. XOAP liest die Modulmetadaten, um die folgenden Informationen zu ermitteln:

• Welche Ressourcen sind im Modul enthalten?
• Welche Parameter sind erforderlich und welche optional?
• Parametertypen, zulässige Werte und Standardwerte (falls definiert)

Modulversionen und Kompatibilität

Module werden verknüpft mit Versionen, und die ausgewählte Modulversion hat direkten Einfluss auf:

• Welche Ressourcen stehen zur Verfügung?
• Welche Parameter existieren (neue Versionen können Parameter hinzufügen, umbenennen oder entfernen)?
• Verhaltensänderungen der Ressourcen (Bugs beheben und die Implementierungslogik ändern)

Daher hängt die Konfigurationskompilierung mit der bei der Kompilierung verwendeten Modulversion zusammen. Wenn Sie eine neuere Modulversion hochladen, wird dies in der Regel Neukompilieren Konfigurationen, um sicherzustellen, dass die erzeugte Ausgabe mit den aktualisierten Ressourcendefinitionen übereinstimmt.

Abhängigkeiten (Voraussetzungen)

Einige Module sind von anderen Modulen abhängig (z. B. Hilfslieferdateien oder gemeinsam genutzte DSC-Ressourcen). Wenn eine erforderliche Abhängigkeit fehlt:

• XOAP kann die Konfiguration möglicherweise nicht erfolgreich kompilieren, und/oder
• Die betreffenden Ressourcen sind möglicherweise nicht verfügbar oder in dem Assistenten nicht verwendbar.

Die beste Praxis ist, die vollständige Abhängigkeitskette (alle erforderlichen Module) vor dem Erstellen oder Kompilieren der Konfigurationen hochzuladen.

Was XOAP von einem Modul verlangt

Um ein Modul in XOAP einsetzbar zu machen Configuration Management, muss es in einem unterstützten Format verpackt sein und gültige DSC-Ressourcen enthalten. In der Praxis bedeutet dies Folgendes:

• Das Modul kann mithilfe von PowerShell/DSC-Werkzeugen importiert werden.
• Die Ressourcen können entdeckt werden (die Ressourcen-Schema/Metadaten sind vorhanden)
• Alle erforderlichen Abhängigkeiten sind verfügbar
• Die Modulversion ist mit den Zielknoten kompatibel (Windows PowerShell 5.1 / DSC 1.1).

Operationelle Überlegungen

• Änderungen im Detail: Neue Modulversionen können zu wesentlichen Änderungen führen (z. B. Parameterumbenennungen). Behandeln Sie Modulaktualisierungen wie Software-Updates – validieren Sie sie zunächst in einer Pilotkonfiguration.
• Reproduzierbarkeit: Verknüpfen Sie Pins mit einer bekannten Modulversion, um eine vorhersehbare Auswirkung zu erzielen; führen Sie eine Neuinstallation erst dann durch, wenn die neue Version validiert wurde.
• Fehlersuche: Wenn eine Ressource im Assistenten nicht sichtbar ist oder die Kompilierung fehlschlägt, sind die häufigsten Ursachen fehlende Abhängigkeiten, eine inkompatible Modulstruktur oder nicht unterstützte Ressourcenausstattungen.

In der Praxis verbraucht XOAP Module in Standard-Paketformaten von PowerShell (meistens .nupkg). Wenn ein Modul hochgeladen wird in Configuration Management → Module, Die Ressourcen werden in dem Konfigurationsassistenten zur Auswahl bereitgestellt (Modul/Version → Ressource → Parameter).

Modul herunterladen

Sie können Module herunterladen, um sie offline zu prüfen oder das gleiche Paket in einer anderen Umgebung wiederzuverwenden:

• Unter Configuration Management → Module, öffnen Sie das Modul Aktionsmenü (⋮) und wählen Sie Herunterladen, oder
• Öffnen Details und verwenden Herunterladen Aus der Detailansicht des Moduls.

Wo finden Sie Community-Module?

Die meisten Community-DSC-Module werden über das PowerShell-Galerie. Ein gängiger Workflow sieht folgendermaßen aus:

1. Suchen Sie das Modul in der PowerShell-Galerie.
2. Den Rohcode herunterladen .nupkg Datei (manuelles Herunterladen).
3. Laden Sie die Datei hoch .nupkg in XOAP → → Configuration Management Module.

Voraussetzungen für Module (Verknüpfungen)

Wenn ein Modul Voraussetzungen (Abhängigkeiten) für andere Module hat, Alle erforderlichen Module müssen hochgeladen werden.. Andernfalls sind einige Ressourcen möglicherweise nicht verfügbar oder nicht verwendbar beim Konfigurationserstellen/Kompilieren.

Erstellung eines benutzerdefinierten Moduls

XOAP unterstützt benutzerdefinierte Module genauso wie Community-Module – indem es das resultierende Paket in das Configuration Management → Module.

The post Modules appeared first on XOAP.

Schnellübersicht

A Politik Definiert, wie Konfigurationen auf Knoten angewendet und verwaltet werden. Es steuert das operative Verhalten von DSC, einschließlich Konfigurationsmodus, Ausführungshäufigkeit (Frequenz), Wiederstartverhalten und optionalen Proxy-Einstellungen.

Erstellen Sie eine neue Richtlinie

1. Gehen Sie zu Configuration Management → Richtlinien.
2. Klicken Sie auf + Neue Richtlinie.
3. Geben Sie einen Name.
4. Konfigurieren Sie die erforderlichen Richtlinieneinstellungen:
   • Aktivität nach dem Neustart
   • Konfigurationsmodus
   • Konfigurationsmodus-Frequenz (Min.)
   • Refresh-Frequenz (min)
   • Status-Aufbewahrungszeit (d)
5. (Optional) Konfigurieren Proxy-URL, Proxy-Benutzernamen, und Proxy-Passwort, und/oder hinzufügen Tags.
6. Klicken Sie auf Bestätigen Sie Um die Richtlinie zu erstellen.

Eine Richtlinie bearbeiten

1. In der Politiken Tabelle, klicken Sie auf Aktionsmenü (⋮) nahe der Versicherung.
2. Wählen Sie bearbeiten.
3. Aktualisieren Sie die erforderlichen Felder nach Bedarf.
4. Klicken Sie auf Bestätigen Sie Um die Änderungen zu speichern.

Eine Richtlinie löschen

1. In der Politiken Tabelle, klicken Sie auf Aktionsmenü (⋮) nahe der Versicherung.
2. Wählen Sie Löschen.
3. Bestätigen Sie die Löschung.

Weitere nützliche Informationen

Veränderungen der Richtlinien:

Änderungen an einer XOAP-Richtlinie werden nicht Aktualisieren Sie die Richtlinieneinstellungen automatisch auf den Knoten.

Proxy-Einstellungen:

Proxy-Einstellungen: Konfigurieren Sie Proxy-Felder nur dann, wenn Knoten einen Proxy benötigen, um XOAP zu erreichen; lassen Sie sie andernfalls leer.

Technische Dokumentation

A Politik Definiert, wie DSC auf einem Knoten ausgeführt und verwaltet wird. Es steuert das Konfigurationsausführungsverhalten des Knotens (Konfigurationsmodus), wie oft der Knoten die Konfiguration auswertet und implementiert (Konfigurationsmodus-Frequenz), wie oft er seinen Konfigurationskontext aktualisiert (Refresh-Frequenz) und was nach einem Neustart geschehen soll. Richtlinien können auch Proxy-Einstellungen speichern, um sicherzustellen, dass Knoten in eingeschränkten Netzwerkumgebungen auf XOAP-Services zugreifen können.

Politikfelder

Name

Ein einzigartiger, für Menschen lesbarer Name für die Richtlinie (z. B., XOAP Desktops (kein Neustart)). Verwenden Sie eine Namenskonvention, die die Ziellast und die Erwartungen hinsichtlich einer Neustartung widerspiegelt.

Wählen Sie „Aktion nach Neustart“

Definiert, was der Knoten nach einem Neustart mit der Konfigurationsverarbeitung tun soll. In den meisten Umgebungen wird dies auf Weiter konfigurieren, was bedeutet, dass die Konfigurationsausführung fortgesetzt wird und der Knoten nach dem Neustart mit der Anwendung bzw. Auswertung der zugeordnete Konfiguration beginnt.

Modulübertragung zulassen

Steuert, ob die für die Konfigurationsausführung verwendeten Moduleinhalte überschrieben werden können, wenn eine neue Moduleversion eingeführt wird. Dies wird in der Regel nur dann verwendet, wenn Sie explizit möchten, dass Knoten aktualisierte Moduleversionen ohne manuellen Eingriff akzeptieren.

Konfigurationsmodus

Definiert das DSC-Verhalten im Knoten:

• ApplyOnlyGibt die Konfiguration einmal an; überwacht nicht kontinuierlich nach Abweichungen.
• ApplyAndMonitor: Führt die Konfiguration durch und meldet Drift, repariert sie jedoch nicht automatisch.
• ApplyAndAutoCorrect: Führt die Konfiguration durch und versucht automatisch, die Drift zu beheben, um den Knoten in den gewünschten Zustand zurückzusetzen.

In XOAP, ApplyAndAutoCorrect ist typischerweise für Sicherheitsbaselines und Hardening verwendet, während ApplyOnly ist für Einmalbereitstellungsszenarien besser geeignet.

Konfigurationsmodus-Frequenz (Min.)

Steuert, wie oft der Knoten eine Konsistenzprüfung durchführt, basierend auf der ausgewählten Option. Konfigurationsmodus (besonders relevant für ApplyAndMonitor und ApplyAndAutoCorrect). Dies ist die Haupt-“Ausführungskadenz”, die bestimmt, wie schnell XOAP/DSC Drift erkennt und (wenn aktiviert) diese automatisch korrigiert.

Wichtige Hinweise

• Niedrige Werte = schnellerer Drift-Erkennung und schnellerer Behebung, aber höhere Endpunktlast.
• Höhere Werte = weniger häufige Kontrollen, geringerer Ladevorgang, langsamer Drifterkennung.

Empfohlene Verwendung

• Desktop-Computer: 30–60 Minuten (typisch)
• Server: 60+ Minuten (typisch), es sei denn, strikte Durchsetzung ist erforderlich

Refresh-Frequenz (min)

Stimmt die Häufigkeit der Aktualisierung des Konfigurationsrahmens des Knotens und überprüft die Aktualisierung der Konfigurationsinhalte. Dies beeinflusst die Geschwindigkeit, mit der Änderungen in XOAP (neue Konfigurationsversionen, aktualisierte Ressourcen usw.) vom Knoten erkannt werden.

Wichtige Hinweise

• Niedere Werte = Knoten übernehmen Änderungen schneller, aber mit häufigeren Abfragen.
• Höhere Werte = langsamerer Abruf von Änderungen, geringere Aufwand für die Abfrage.

Empfohlene Verwendung

• Desktop-Computer: 180 Minuten (typisch)
• Server: 360 Minuten (typisch), sofern Sie keine schnellere Verbreitung benötigen

Status-Aufbewahrungszeit (d)

Legt fest, wie lange XOAP die Verlaufs- und Statusdaten von Knoten für Berichte und Fehlerbehebung (z. B. Compliance-Historie) aufbewahrt. Höhere Werte speichern mehr Daten, können jedoch den Speicher- und Aufbewahrungsaufwand erhöhen.

Proxy-URL / Proxy-Benutzernamen / Proxy-Passwort

Optionale Proxy-Einstellungen werden verwendet, wenn Knoten XOAP-Endpunkte über einen Proxy erreichen müssen.

• Proxy-URL: Der Proxy-Endpunkt (z. B., http://proxy.company.local:8080)
• Proxy-Benutzernamen / Proxy-Passwort: Anmeldeinformationen, falls die Autorisierung eine Authentifizierung erfordert
  Verwenden Sie Wählen Sie „Existierendes“ Um gespeicherte Werte in Parameter konsequent.

Node neu starten

Legt fest, ob ein Neustart eines Knotens im Rahmen der Konfigurationsausführung erlaubt ist (sofern zutreffend). Aktivieren Sie diese Option nur, wenn Neustarts für die Zielsysteme akzeptabel sind und Ihre betrieblichen Richtlinien dies erlauben.

Tags

Optionale Metadaten, die für das Filtern und die Organisation verwendet werden (z. B., Server, Schreibtisch, RebootAllowed, PoC).

Konfigurationsmodus Frequenz vs. Aktualisierungsrate (wie sie zusammen funktionieren)

Diese beiden Werte dienen unterschiedlichen Zwecken und sollten nicht als Duplikate behandelt werden:

• Konfigurationsmodus-Frequenz = Wie oft der Knoten den gewünschten Zustand evaluiert bzw. durchsetzt (Entwicklungs- und Korrekturrate).
• Refresh-Frequenz = Wie oft überprüft der Knoten nach aktualisierten Konfigurationsinhalten (wie schnell werden Konfigurationsänderungen verbreitet).

Praktisches Beispiel

• Wenn Sie die Einstellung Konfigurationsmodus Frequenz = 15 Minuten und Refresh-Frequenz = 360 Minuten, Der Knoten wird die aktuelle Konfiguration alle 15 Minuten neu implementieren, aber es kann bis zu ~6 Stunden dauern, bis eine neu aktualisierte Konfigurationsversion verfügbar ist (bis sie aktualisiert wird).

Mindestwerte und praktische Grenzwerte

XOAP setzt Mindestwerte an (abhängig von der Implementierung und den Richtlinien). Die aktuellen Grenzwerte lauten:

• Konfigurationsmodus Frequenz: Mindestens 15 Minuten
• Refresh-Frequenz: mindestens 30 Minuten

Als sichere Best-Practice-Richtlinie:

• Verwenden Sie sehr niedrige Werte nur, wenn Sie eine strenge Notwendigkeit haben und den Einfluss auf die Endpunkte getestet haben. (Werte) Die Funktionen unter dem Mindestwert werden nicht unterstützt. und wird abgelehnt.)
• Halten Refresh-Frequenz  höher als Konfigurationsmodus-Frequenz  Um unnötige Aktualisierungen/Polling zu reduzieren.
• Eine gängige Vorgehensweise ist Konfigurationsmodus Frequenz = 15 Minuten und Refresh-Frequenz = 60–360 Minuten, Je nachdem, wie schnell Sie die Knoten benötigen, um Änderungen zu übernehmen.

The post Policies appeared first on XOAP.

Securing configurations

All uploaded configurations are automatically signed with our code signing certificate. So you do not have to take care of securing your configurations.

During client registration, an additional certificate is installed on the client to identify requests from trusted nodes.

Securing the Pull Server

Our DSC implementation does not run on a web server. We are running containers behind an API gateway with user authentication.

Configure for Strong Cryptography

How to configure .NET Framework to support strong cryptography. Set the SchUseStrongCrypto registry setting to DWORD:00000001. This value disables the RC4 stream cipher and requires a restart. For more information about this setting, see Microsoft Security Advisory 296038.

Make sure to set the following registry keys on any computer that communicates across the network with a TLS 1.2-enabled system. For example, configuration manager clients, remote site system roles not installed on the site server, and the site server itself.

For 32-bit applications that are running on 32-bit OSs and for 64-bit applications that are running on 64-bit OSs, update the following sub-key values:

Registry

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v2.0.50727]
      "SystemDefaultTlsVersions" = dword:00000001
      "SchUseStrongCrypto" = dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]
      "SystemDefaultTlsVersions" = dword:00000001
      "SchUseStrongCrypto" = dword:00000001

For 32-bit applications that are running on 64-bit OSs, update the following subkey:

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v2.0.50727]
      "SystemDefaultTlsVersions" = dword:00000001
      "SchUseStrongCrypto" = dword:00000001

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319]
      "SystemDefaultTlsVersions" = dword:00000001
      "SchUseStrongCrypto" = dword:00000001

The SchUseStrongCrypto setting allows .NET to use TLS 1.1 and TLS 1.2. The SystemDefaultTlsVersions setting allows .NET to use the OS configuration. For more information, see TLS best practices with .NET Framework.

Proxy-Konfiguration für Knoten

In order for PowerShell DSC nodes to be forced to use a proxy server to communicate with the cloud-hosted backend, some adjustments to the node configuration must be done before registering the node.

DSC does not communicate in a user context and therefore uses the SYSTEM context.

For DSC to connect successfully and register the node, adjust the following lines inside the machine.config in your .NET installation directory. You should find the file in these locations:

32-bit

**%windir%\Microsoft.NET\Framework\[version]\config\machine.config** Kopie

64-bit

**%windir%\Microsoft.NET\Framework64\[version]\config\machine.config** Kopie

[version] should be equal to v1.0.3705, v1.1.4322, v2.0.50727 or v4.0.30319. v3.0 and v3.5 just contain additional assemblies to v2.0.50727 so there should be no config\machine.config. v4.5.x and v4.6.x are stored inside v4.0.30319.

Then add the following lines: <defaultProxy> <proxy autoDetect="false" bypassonlocal="false" proxyaddress="http://127.0.0.1:8888" /> </defaultProxy> </system.net> Kopie

PowerShell DSC configuration encryption

PowerShell DSC configurations that are uploaded while adding the configuration are going to be encrypted by using a certificate that is provided by XOAP.

This happens in two cases:

• Adding a configuration by manually uploading configuration files (as ps1) with the upload wizard
• Adding a configuration by using the DSC Configuration Wizard

After the file is encrypted, it is converted to base64 string and pushed to a dedicated backend storage location.

If you are uploading a compiled mof file, it will not be encrypted.

The post Security appeared first on XOAP.

Um PowerShell-DSC-Konfigurationen zu erstellen, benötigen Sie einige Tools, um mit der Arbeit beginnen zu können.

WMF 5.1

Falls es noch nicht installiert ist, sollten Sie es installieren. Windows Management Framework 5.1.

Wenn Sie Windows 10 oder Windows Server 2016 oder eine ältere Version verwenden, sollte diese bereits installiert sein.

PowerShell-Abfrage

Führen Sie die folgenden Befehle als Administrator auf Ihrem Windows-Computer aus:

Installieren Sie die Module mit dem Befehl PowerShellGet -Force

Erfahren Sie mehr über PowerShell-Abfrage.

Code-Editoren

Sie benötigen einen geeigneten Code-Editor, daher empfehlen wir einen der folgenden Programme.

Visual Studio Code

Visual Studio Code ist unser bevorzugter Codeeditor für alle Themen im Zusammenhang mit PowerShell. Er kann heruntergeladen werden. hier. Sie können es für einen einzelnen Benutzer oder als Systeminstallationsprogramm installieren. Wählen Sie das Installationsprogramm aus, das Ihren Bedürfnissen entspricht.

IntelliJ IDEA

Wenn Sie Visual Studio Code nicht mögen, können Sie IntelliJ IDEA als Alternative verwenden. Sie kann heruntergeladen werden. hier.

PowerShell ISE

PowerShell ISE ist ein weiterer Codeeditor, mit dem Sie Ihre DSC-Konfigurationen bearbeiten können, aber wir Ich empfehle dringend eine der beiden oben genannten Optionen..

Zusätzliche DSC-Ressourcen

Zusätzliche DSC-Ressourcen können heruntergeladen werden unter PowerShell-Galerie. Die Module, die Sie herunterladen müssen, hängen von der Konfiguration ab, die Sie erstellen möchten. Durchsuchen Sie die PowerShell-Galerie, um die benötigten Ressourcen zu finden.

Wenn die Ressourcen noch nicht vorhanden sind, können Sie Ihre eigenen erstellen.

Sie werden über PowerShell installiert:

Installieren Sie das Modul mit dem Namen xWindowsUpdate

Namenskonventionen

Führen Sie die nachfolgenden Anweisungen zur korrekten Verarbeitung durch:

• Standardnamen dürfen nur Buchstaben (a-z, A-Z), Zahlen (0-9) und Unterstrich (_) enthalten.
• Der Name darf nicht leer (0) oder mit einem Bindestrich (-) geschrieben sein und sollte mit einem Buchstaben beginnen (a-z, A-Z).

Gültige Namensbeispiele

“XOAP_Any_Apps_And_Monitoring”

“xoap_any_apps_and_monitoring_0_1_9”

“XOAP_Hp_Dl380_Baseline_Configuration”

“xoap_hp_dl380_baseline_configuration”

Ungültiges Namensbeispiel

“XOAP-W10-20H2-Citrix-Optimizer”

“01 XOAP W10 20H2 Citrix Optimizer”

Befehle und Aktionen

Bedürfnisgestützte Zustandskonfiguration (DSC)-Cmdlets für den täglichen Einsatz

Debugging-Cmdlets (DSC)

The post Best practices appeared first on XOAP.

The post Use case: B3S/BSI Technical control mapping appeared first on XOAP.