A kívánt állapot konfigurációjának lekérése szolgáltatásDesired State Configuration Pull Service

Fontos

A lekérési kiszolgáló (Windows -szolgáltatás DSC-Service) a Windows Server támogatott összetevője, azonban nincsenek új funkciók vagy képességek kínáló csomagok.The Pull Server (Windows Feature DSC-Service) is a supported component of Windows Server however there are no plans to offer new features or capabilities. Ajánlott megkezdeni a felügyelt ügyfelek átváltását Azure Automation DSC -re (beleértve a Windows Serveren futó lekéréses kiszolgálón túli szolgáltatásokat) vagy az ittfelsorolt közösségi megoldások egyikét.It is recommended to begin transitioning managed clients to Azure Automation DSC (includes features beyond Pull Server on Windows Server) or one of the community solutions listed here.

A helyi Configuration Manager (LCD ChipOnGlas) központilag kezelhető egy lekéréses szolgáltatás megoldásával.Local Configuration Manager (LCM) can be centrally managed by a Pull Service solution. Ezen módszer használatakor a felügyelt csomópont regisztrálva van egy szolgáltatásban, és a konfigurációt az LCD-beállításokban kell kijelölni.When using this approach, the node that is being managed is registered with a service and assigned a configuration in LCM settings. A konfiguráció és az összes olyan DSC-erőforrás, amely a konfiguráció függőségeire van szükség, a rendszer letölti a gépre, és az LCD ChipOnGlas használatával kezeli a konfigurációt.The configuration and all DSC resources needed as dependencies for the configuration are downloaded to the machine and used by LCM to manage the configuration. A rendszer feltölti a felügyelt számítógép állapotára vonatkozó adatokat a jelentéskészítéshez.Information about the state of the machine being managed is uploaded to the service for reporting. Ezt a koncepciót "lekéréses szolgáltatásnak" nevezzük.This concept is referred to as "pull service".

A lekéréses szolgáltatás jelenlegi beállításai a következők:The current options for pull service include:

  • Azure Automation kívánt állapot-konfigurációs szolgáltatásAzure Automation Desired State Configuration service
  • Windows Serveren futó lekéréses szolgáltatásA pull service running on Windows Server
  • A Közösség által karbantartott nyílt forráskódú megoldásokCommunity maintained open-source solutions
  • SMB-megosztásAn SMB share

Az egyes megoldások javasolt skálája a következő:The recommended scale for each solution is as follows:

MegoldásSolution Ügyféloldali csomópontokClient nodes
Windows lekérési kiszolgáló az MDB/ESENT-adatbázis használatávalWindows Pull Server using MDB/ESENT database Legfeljebb 500 csomópontUp to 500 nodes
Windows lekérési kiszolgáló az SQL Database használatávalWindows Pull Server using SQL database Legfeljebb 3500 csomópontUp to 3500 nodes
Azure Automation DSCAzure Automation DSC Kis-és nagyméretű környezetek isBoth small and large environments

A javasolt megoldás, valamint a legtöbb elérhető funkció, Azure Automation DSC.The recommended solution, and the option with the most features available, is Azure Automation DSC. Az Automation-fiókhoz tartozó csomópontok számának felső korlátja nem lett azonosítva.An upper limit for number of nodes per Automation Account has not been identified.

Az Azure-szolgáltatás a helyszíni csomópontokat a privát adatközpontokban vagy nyilvános felhőkben, például az Azure-ban és az AWS-ben is képes kezelni.The Azure service can manage nodes on-premises in private datacenters, or in public clouds such as Azure and AWS. Olyan privát környezetekben, ahol a kiszolgálók nem tudnak közvetlenül csatlakozni az internethez, érdemes lehet csak a közzétett Azure IP-tartományra korlátozni a kimenő forgalmat (lásd: Azure-adatközpont IP-címtartományok).For private environments where servers cannot directly connect to the Internet, consider limiting outbound traffic to only the published Azure IP range (see Azure Datacenter IP Ranges).

A Windows Server lekéréses szolgáltatásában jelenleg nem elérhető online szolgáltatás szolgáltatásai a következők:Features of the online service that are not currently available in the pull service on Windows Server include:

  • Minden adatforgalom titkosítva van az átvitel és a nyugalmi állapotbanAll data is encrypted in transit and at rest
  • Az ügyféltanúsítványok automatikusan jönnek létre és kezelhetőkClient certificates are created and managed automatically
  • Secrets Store a jelszavak és a hitelesítő adatokközpontilag történő kezeléséhez, illetve változókhoz , például kiszolgálónévekhez vagy a kapcsolatok karakterláncáhozSecrets store for centrally managing passwords/credentials, or variables such as server names or connection strings
  • Csomópontos LCD- konfiguráció központi kezeléseCentrally manage node LCM configuration
  • Konfigurációk központi kiosztása az ügyfél csomópontjaihozCentrally assign configurations to client nodes
  • A "Kanári-csoportokra" vonatkozó konfigurációs változások kiadása az éles környezet elérése előttRelease configuration changes to "canary groups" for testing before reaching production
  • Grafikus jelentéskészítésGraphical reporting
    • A részletességi szintű DSC-erőforrás részletességi állapotaStatus detail at the DSC resource level of granularity
    • Részletes hibaüzenetek az ügyfélszámítógépektől a hibaelhárításhozVerbose error messages from client machines for troubleshooting
  • Integráció az Azure log Analytics a riasztásokhoz, automatizált feladatokhoz, Android/iOS-alkalmazásokhoz jelentéskészítéshez és riasztásokhozIntegration with Azure Log Analytics for alerting, automated tasks, Android/iOS app for reporting and alerting

DSC lekéréses szolgáltatás a Windows Server rendszerbenDSC pull service in Windows Server

A lekéréses szolgáltatás beállítható úgy, hogy a Windows Serveren fusson.It is possible to configure a pull service to run on Windows Server. Javasoljuk, hogy a Windows Serverben található lekéréses szolgáltatási megoldás csak a konfigurációk/modulok tárolására szolgáló képességeket tartalmazza, amelyekkel letöltheti és rögzítheti a jelentési adatmennyiségeket egy adatbázisba.Be advised that the pull service solution included in Windows Server includes only capabilities of storing configurations/modules for download and capturing report data into a database. Nem tartalmazza a szolgáltatás által az Azure-ban kínált számos képességet, ezért nem jó eszköz a szolgáltatás használatának kiértékeléséhez.It does not include many of the capabilities offered by the service in Azure and so, is not a good tool for evaluating how the service would be used.

A Windows Server rendszerben kínált lekéréses szolgáltatás egy OData felületet használó webszolgáltatás, amely a DSC konfigurációs fájljait elérhetővé teszi a célként megadott csomópontok számára, amikor ezek a csomópontok kérik őket.The pull service offered in Windows Server is a web service in IIS that uses an OData interface to make DSC configuration files available to target nodes when those nodes ask for them.

A lekéréses kiszolgáló használatára vonatkozó követelmények:Requirements for using a pull server:

  • Egy rendszert futtató kiszolgáló:A server running:
    • WMF/PowerShell 4,0 vagy újabbWMF/PowerShell 4.0 or greater
    • IIS-kiszolgálói szerepkörIIS server role
    • DSC szolgáltatásDSC Service
  • Ideális esetben a tanúsítvány előállításához szükséges hitelesítő adatok biztonságossá tétele a helyi Configuration Manager (LCD ChipOnGlas) számára a célként megadott csomópontokonIdeally, some means of generating a certificate, to secure credentials passed to the Local Configuration Manager (LCM) on target nodes

A Windows Server lekéréses szolgáltatásként való konfigurálásának legjobb módja a DSC-konfiguráció használata.The best way to configure Windows Server to host pull service is to use a DSC configuration. Alább talál egy példát a parancsfájlra.An example script is provided below.

Támogatott adatbázis-rendszerekSupported database systems

WMF 4.0WMF 4.0 WMF 5.0WMF 5.0 WMF 5.1WMF 5.1 WMF 5,1 (Windows Server Insider előzetes verzió 17090)WMF 5.1 (Windows Server Insider Preview 17090)
MDBMDB ESENT (alapértelmezett), MDBESENT (Default), MDB ESENT (alapértelmezett), MDBESENT (Default), MDB ESENT (alapértelmezett), SQL Server, MDBESENT (Default), SQL Server, MDB

A Windows Server 17090-es kiadásával kezdődően SQL Server a lekéréses szolgáltatás (Windows-szolgáltatás DSC-Service) támogatott lehetősége.Starting in release 17090 of Windows Server, SQL Server is a supported option for the Pull Service (Windows Feature DSC-Service). Ez új lehetőséget biztosít a nagy DSC-környezetek méretezésére, amelyek nem lettek áttelepítve a DSC-Azure Automation.This provides a new option for scaling large DSC environments that have not migrated to Azure Automation DSC.

Megjegyzés

SQL Server támogatás nem lesz hozzáadva a WMF 5,1 korábbi verzióihoz (vagy korábbi verziókhoz), és csak a 17090-nál nagyobb vagy azzal egyenlő Windows Server-verziókban lesz elérhető.SQL Server support will not be added to previous versions of WMF 5.1 (or earlier) and will only be available on Windows Server versions greater than or equal to 17090.

A lekéréses kiszolgáló a SQL Server használatára való konfigurálásához állítsa a SqlProvider $true és a sqlConnectionString érvényes SQL Server-kapcsolódási karakterláncra.To configure the pull server to use SQL Server, set SqlProvider to $true and SqlConnectionString to a valid SQL Server Connection String. További információ: SqlClient- kapcsolatok karakterláncai.For more information, see SqlClient Connection Strings. A xDscWebService-vel való SQL Server konfigurációra például először olvassa el a xDscWebService-erőforrást , majd tekintse át Sample_xDscWebServiceRegistration_UseSQLProvider.ps1 a githubon.For an example of SQL Server configuration with xDscWebService, first read Using the xDscWebService resource and then review Sample_xDscWebServiceRegistration_UseSQLProvider.ps1 on GitHub.

A xDscWebService erőforrás használataUsing the xDscWebService resource

A web pull-kiszolgáló beállításának legegyszerűbb módja a xPSDesiredStateConfiguration modulban található xDscWebService -erőforrás használata.The easiest way to set up a web pull server is to use the xDscWebService resource, included in the xPSDesiredStateConfiguration module. A következő lépések azt ismertetik, hogyan használható az a Configuration webszolgáltatást beállító erőforrás.The following steps explain how to use the resource in a Configuration that sets up the web service.

  1. A xPSDesiredStateConfiguration modul telepítéséhez hívja meg az install-Module parancsmagot.Call the Install-Module cmdlet to install the xPSDesiredStateConfiguration module.

    Megjegyzés

    Install-Module a a PowerShell 5,0-es és újabb verziója tartalmazza a PowerShellGet modulban.Install-Module is included in the PowerShellGet module, which is included in PowerShell 5.0 and higher.

  2. Szerezze be a DSC lekérési kiszolgálójának SSL-tanúsítványát egy megbízható hitelesítésszolgáltatótól, akár a szervezetén belül, akár egy nyilvános szolgáltatóban.Get an SSL certificate for the DSC Pull server from a trusted Certificate Authority, either within your organization or a public authority. A szolgáltatótól kapott tanúsítvány általában PFX formátumú.The certificate received from the authority is usually in the PFX format.

  3. Telepítse a tanúsítványt azon a csomóponton, amely a DSC lekérési kiszolgáló lesz az alapértelmezett helyen, amelynek a következőnek kell lennie: CERT:\LocalMachine\My .Install the certificate on the node that will become the DSC Pull server in the default location, which should be CERT:\LocalMachine\My.

    • Jegyezze fel a tanúsítvány ujjlenyomatát.Make a note of the certificate thumbprint.
  4. Válassza ki a regisztrációs kulcsként használni kívánt GUID azonosítót.Select a GUID to be used as the Registration Key. A PowerShell használatával történő létrehozáshoz írja be a következőt a PS parancssorba, majd nyomja le az ENTER billentyűt: [guid]::newGuid() vagy New-Guid .To generate one using PowerShell enter the following at the PS prompt and press enter: [guid]::newGuid() or New-Guid. Ezt a kulcsot az ügyféloldali csomópontok használják megosztott kulcsként a regisztráció során történő hitelesítéshez.This key will be used by client nodes as a shared key to authenticate during registration. További információt az alábbi regisztrációs kulcs című szakaszban talál.For more information, see the Registration Key section below.

  5. A PowerShell ISE-ben indítsa el (F5) a következő konfigurációs parancsfájlt (a xPSDesiredStateConfiguration modul mappájában található Sample_xDscWebServiceRegistration.ps1 ).In the PowerShell ISE, start (F5) the following configuration script (included in the folder of the xPSDesiredStateConfiguration module as Sample_xDscWebServiceRegistration.ps1) . Ez a szkript beállítja a lekérési kiszolgálót.This script sets up the pull server.

    configuration Sample_xDscWebServiceRegistration
    {
        param
        (
            [string[]]$NodeName = 'localhost',
    
            [ValidateNotNullOrEmpty()]
            [string] $certificateThumbPrint,
    
            [Parameter(HelpMessage='This should be a string with enough entropy (randomness) to protect the registration of clients to the pull server.  We will use new GUID by default.')]
            [ValidateNotNullOrEmpty()]
            [string] $RegistrationKey   # A guid that clients use to initiate conversation with pull server
        )
    
        Import-DSCResource -ModuleName PSDesiredStateConfiguration
        Import-DSCResource -ModuleName xPSDesiredStateConfiguration
    
        Node $NodeName
        {
            WindowsFeature DSCServiceFeature
            {
                Ensure = "Present"
                Name   = "DSC-Service"
            }
    
            xDscWebService PSDSCPullServer
            {
                Ensure                  = "Present"
                EndpointName            = "PSDSCPullServer"
                Port                    = 8080
                PhysicalPath            = "$env:SystemDrive\inetpub\PSDSCPullServer"
                CertificateThumbPrint   = $certificateThumbPrint
                ModulePath              = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Modules"
                ConfigurationPath       = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Configuration"
                State                   = "Started"
                DependsOn               = "[WindowsFeature]DSCServiceFeature"
                RegistrationKeyPath     = "$env:PROGRAMFILES\WindowsPowerShell\DscService"
                AcceptSelfSignedCertificates = $true
                UseSecurityBestPractices     = $true
                Enable32BitAppOnWin64   = $false
            }
    
            File RegistrationKeyFile
            {
                Ensure          = 'Present'
                Type            = 'File'
                DestinationPath = "$env:ProgramFiles\WindowsPowerShell\DscService\RegistrationKeys.txt"
                Contents        = $RegistrationKey
            }
        }
    }
    
  6. Futtassa a konfigurációt, és adja át az SSL-tanúsítvány ujjlenyomatát a certificateThumbPrint paraméterként, valamint egy GUID regisztrációs kulcsot a RegistrationKey paraméterként:Run the configuration, passing the thumbprint of the SSL certificate as the certificateThumbPrint parameter and a GUID registration key as the RegistrationKey parameter:

    # To find the Thumbprint for an installed SSL certificate for use with the pull server list all certificates in your local store
    # and then copy the thumbprint for the appropriate certificate by reviewing the certificate subjects
    dir Cert:\LocalMachine\my
    
    # Then include this thumbprint when running the configuration
    Sample_xDscWebServiceRegistration -certificateThumbprint 'A7000024B753FA6FFF88E966FD6E19301FAE9CCC' -RegistrationKey '140a952b-b9d6-406b-b416-e0f759c9c0e4' -OutputPath c:\Configs\PullServer
    
    # Run the compiled configuration to make the target node a DSC Pull Server
    Start-DscConfiguration -Path c:\Configs\PullServer -Wait -Verbose
    

Regisztrációs kulcsRegistration Key

Annak engedélyezéséhez, hogy az ügyféloldali csomópontok regisztráljanak a-kiszolgálóval, hogy a konfigurációs neveket a konfigurációs azonosító helyett tudják használni, a fenti konfiguráció által létrehozott regisztrációs kulcsot a rendszer menti egy nevű fájlba RegistrationKeys.txt C:\Program Files\WindowsPowerShell\DscService .To allow client nodes to register with the server so that they can use configuration names instead of a configuration ID, a registration key that was created by the above configuration is saved in a file named RegistrationKeys.txt in C:\Program Files\WindowsPowerShell\DscService. A regisztrációs kulcs olyan közös titokként működik, amelyet az ügyfél a lekérési kiszolgálóval végzett kezdeti regisztráció során használt.The registration key functions as a shared secret used during the initial registration by the client with the pull server. Az ügyfél olyan önaláírt tanúsítványt fog előállítani, amelyet a rendszer a lekéréses kiszolgáló egyedi hitelesítéséhez használ a regisztráció sikeres befejeződése után.The client will generate a self-signed certificate that is used to uniquely authenticate to the pull server once registration is successfully completed. A Tanúsítvány ujjlenyomata helyileg tárolódik, és a lekérési kiszolgáló URL-címéhez van társítva.The thumbprint of this certificate is stored locally and associated with the URL of the pull server.

Megjegyzés

A regisztrációs kulcsok nem támogatottak a PowerShell 4,0-ben.Registration keys are not supported in PowerShell 4.0.

Ahhoz, hogy a csomópontot a lekérési kiszolgálóval való hitelesítésre konfigurálja, a regisztrációs kulcsnak a lekérési kiszolgálóval regisztrálni kívánt metaconfiguration kell lennie.In order to configure a node to authenticate with the pull server, the registration key needs to be in the metaconfiguration for any target node that will be registering with this pull server. Vegye figyelembe, hogy az alábbi metaconfiguration lévő RegistrationKey a célszámítógép sikeres regisztrálását követően törlődik, és az értéknek meg kell egyeznie a RegistrationKeys.txt lekérési kiszolgálón (ebben a példában a "140a952b-b9d6-406b-b416-e0f759c9c0e4") található fájlban tárolt értékkel.Note that the RegistrationKey in the metaconfiguration below is removed after the target machine has successfully registered, and that the value must match the value stored in the RegistrationKeys.txt file on the pull server ('140a952b-b9d6-406b-b416-e0f759c9c0e4' for this example). Mindig biztonságos módon kezelje a regisztrációs kulcs értékét, mert tudván, hogy bármely célszámítógép regisztrálható a lekérési kiszolgálón.Always treat the registration key value securely, because knowing it allows any target machine to register with the pull server.

[DSCLocalConfigurationManager()]
configuration Sample_MetaConfigurationToRegisterWithLessSecurePullServer
{
    param
    (
        [ValidateNotNullOrEmpty()]
        [string] $NodeName = 'localhost',

        [ValidateNotNullOrEmpty()]
        [string] $RegistrationKey, #same as the one used to set up pull server in previous configuration

        [ValidateNotNullOrEmpty()]
        [string] $ServerName = 'localhost' #node name of the pull server, same as $NodeName used in previous configuration
    )

    Node $NodeName
    {
        Settings
        {
            RefreshMode        = 'Pull'
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL          = "https://$ServerName`:8080/PSDSCPullServer.svc" # notice it is https
            RegistrationKey    = $RegistrationKey
            ConfigurationNames = @('ClientConfig')
        }

        ReportServerWeb CONTOSO-PullSrv
        {
            ServerURL       = "https://$ServerName`:8080/PSDSCPullServer.svc" # notice it is https
            RegistrationKey = $RegistrationKey
        }
    }
}

Sample_MetaConfigurationToRegisterWithLessSecurePullServer -RegistrationKey $RegistrationKey -OutputPath c:\Configs\TargetNodes

Megjegyzés

A ReportServerWeb szakasz lehetővé teszi jelentéskészítési adatküldés küldését a lekérési kiszolgálónak.The ReportServerWeb section allows reporting data to be sent to the pull server.

A metaconfiguration fájl ConfigurationID tulajdonságának hiánya implicit módon azt jelenti, hogy a lekérési kiszolgáló támogatja a lekérési kiszolgáló protokolljának v2-es verzióját, így kezdeti regisztrációra van szükség.The lack of the ConfigurationID property in the metaconfiguration file implicitly means that pull server is supporting the V2 version of the pull server protocol so an initial registration is required. Ezzel szemben a ConfigurationID jelenléte azt jelenti, hogy a lekéréses kiszolgáló protokolljának v1-es verziója van használatban, és nincs regisztrációs feldolgozás.Conversely, the presence of a ConfigurationID means that the V1 version of the pull server protocol is used and there is no registration processing.

Megjegyzés

Egy leküldéses forgatókönyvben hiba történt a jelenlegi kiadásban, amely szükségessé teszi a ConfigurationID tulajdonság definiálását a metaconfiguration-fájlban olyan csomópontok esetében, amelyek még nem regisztráltak lekéréses kiszolgálóval.In a PUSH scenario, a bug exists in the current release that makes it necessary to define a ConfigurationID property in the metaconfiguration file for nodes that have never registered with a pull server. Ez kényszeríti a v1 lekéréses kiszolgáló protokollját, és elkerüli a regisztrációs hibák üzeneteit.This will force the V1 Pull Server protocol and avoid registration failure messages.

Konfigurációk és erőforrások elhelyezésePlacing configurations and resources

A lekérési kiszolgáló telepítésének befejezése után a lekérési kiszolgáló konfigurációjában a ConfigurationPath és a ModulePath tulajdonság által meghatározott mappák a lekéréses csomópontok számára elérhető modulok és konfigurációk helyét fogják elhelyezni.After the pull server setup completes, the folders defined by the ConfigurationPath and ModulePath properties in the pull server configuration are where you will place modules and configurations that will be available for target nodes to pull. Ezeknek a fájloknak egy adott formátumban kell lenniük ahhoz, hogy a lekérési kiszolgáló megfelelően feldolgozza őket.These files need to be in a specific format in order for the pull server to correctly process them.

DSC erőforrás modul csomag formátumaDSC resource module package format

Az egyes erőforrás-modulokat a következő minta szerint kell kibontani és elnevezni {Module Name}_{Module Version}.zip .Each resource module needs to be zipped and named according to the following pattern {Module Name}_{Module Version}.zip.

Például egy xWebAdminstration nevű modul, amely a 3.1.2.0 modul verzióját fogja nevezni xWebAdministration_3.1.2.0.zip .For example, a module named xWebAdminstration with a module version of 3.1.2.0 would be named xWebAdministration_3.1.2.0.zip. Egy modul minden egyes verziójának egyetlen zip-fájlban kell szerepelnie.Each version of a module must be contained in a single zip file. Mivel az egyes zip-fájlokban csak egyetlen verziójú erőforrás található, a WMF 5,0-ben hozzáadott modul formátuma nem támogatott egyetlen címtárban.Since there is only a single version of a resource in each zip file, the module format added in WMF 5.0 with support for multiple module versions in a single directory is not supported. Ez azt jelenti, hogy a DSC-erőforrás moduljainak a lekérési kiszolgálón való használatának megkezdése előtt kis módosítást kell végeznie a címtár struktúráján.This means that before packaging up DSC resource modules for use with pull server you will need to make a small change to the directory structure. A DSC-erőforrást tartalmazó modulok alapértelmezett formátuma a WMF 5,0-ben {Module Folder}\{Module Version}\DscResources\{DSC Resource Folder}\ .The default format of modules containing DSC resource in WMF 5.0 is {Module Folder}\{Module Version}\DscResources\{DSC Resource Folder}\. A lekérési kiszolgáló csomagolása előtt távolítsa el a {Module Version} mappát, hogy az elérési út legyen {Module Folder}\DscResources\{DSC Resource Folder}\ .Before packaging up for the pull server, remove the {Module version} folder so the path becomes {Module Folder}\DscResources\{DSC Resource Folder}\. Ezzel a módosítással zip a mappát a fent leírtak szerint, és helyezze el ezeket a ZIP-fájlokat a ModulePath mappába.With this change, zip the folder as described above and place these zip files in the ModulePath folder.

A használatával New-DscChecksum {module zip file} hozzon létre egy ellenőrzőösszeg-fájlt az újonnan hozzáadott modulhoz.Use New-DscChecksum {module zip file} to create a checksum file for the newly added module.

Konfiguráció MOF-formátumaConfiguration MOF format

A konfigurációs MOF-fájlt egy ellenőrzőösszeg-fájllal kell párosítani, hogy a célként megadott csomóponton lévő LCD-eszközök ellenőrizni tudják a konfigurációt.A configuration MOF file needs to be paired with a checksum file so that an LCM on a target node can validate the configuration. Ellenőrzőösszeg létrehozásához hívja meg a New-DscChecksum parancsmagot.To create a checksum, call the New-DscChecksum cmdlet. A parancsmag egy elérésiút -paramétert használ, amely meghatározza azt a mappát, ahol a konfigurációs MOF található.The cmdlet takes a Path parameter that specifies the folder where the configuration MOF is located. A parancsmag létrehoz egy nevű ellenőrzőösszeg ConfigurationMOFName.mof.checksum -fájlt, ahol a a ConfigurationMOFName konfigurációs MOF-fájl neve.The cmdlet creates a checksum file named ConfigurationMOFName.mof.checksum, where ConfigurationMOFName is the name of the configuration mof file. Ha a megadott mappában több konfigurációs MOF-fájl található, akkor a mappában található minden egyes konfigurációhoz ellenőrzőösszeg jön létre.If there are more than one configuration MOF files in the specified folder, a checksum is created for each configuration in the folder. Helyezze a MOF-fájlokat és a hozzájuk tartozó ellenőrzőösszeg-fájlokat a ConfigurationPath mappába.Place the MOF files and their associated checksum files in the ConfigurationPath folder.

Megjegyzés

Ha bármilyen módon módosítja a konfigurációs MOF-fájlt, akkor újra létre kell hoznia az ellenőrzőösszeg-fájlt is.If you change the configuration MOF file in any way, you must also recreate the checksum file.

EszközökTooling

A lekéréses kiszolgáló telepítésének, ellenőrzésének és felügyeletének megkönnyítéséhez a következő eszközök szerepelnek példaként a xPSDesiredStateConfiguration modul legújabb verziójában:In order to make setting up, validating and managing the pull server easier, the following tools are included as examples in the latest version of the xPSDesiredStateConfiguration module:

  1. Egy modul, amely segítséget nyújt a lekéréses kiszolgálón való használatra a DSC-erőforrás moduljainak és konfigurációs fájljainak használatához.A module that will help with packaging DSC resource modules and configuration files for use on the pull server. PublishModulesAndMofsToPullServer. psm1.PublishModulesAndMofsToPullServer.psm1. Példák alább:Examples below:

        # Example 1 - Package all versions of given modules installed locally and MOF files are in c:\LocalDepot
         $moduleList = @('xWebAdministration', 'xPhp')
         Publish-DSCModuleAndMof -Source C:\LocalDepot -ModuleNameList $moduleList
    
         # Example 2 - Package modules and mof documents from c:\LocalDepot
         Publish-DSCModuleAndMof -Source C:\LocalDepot -Force
    
  2. A lekérési kiszolgálót érvényesítő parancsfájl megfelelően van konfigurálva.A script that validates the pull server is configured correctly. PullServerSetupTests.ps1.PullServerSetupTests.ps1.

Közösségi megoldások a lekéréses szolgáltatáshozCommunity Solutions for Pull Service

A DSC-Közösség több megoldást hozott létre a lekéréses szolgáltatás protokolljának megvalósításához.The DSC community has authored multiple solutions to implement the pull service protocol. A helyszíni környezetek esetében ezek az ajánlatok lekéréses szolgáltatásokkal kapcsolatos képességeket és lehetőséget biztosítanak a Közösségnek a növekményes fejlesztésekkel való újbóli közreműködés érdekében.For on-premises environments, these offer pull service capabilities and an opportunity to contribute back to the community with incremental enhancements.

Ügyfél konfigurációjának lekérésePull client configuration

A következő témakörök részletesen ismertetik a lekéréses ügyfelek beállítását:The following topics describe setting up pull clients in detail:

További információSee also