Lekérési ügyfél beállítása a PowerShell 4,0 konfigurációs azonosítóinak használatávalSet up a Pull Client using Configuration IDs in PowerShell 4.0

A következőkre vonatkozik: Windows PowerShell 4,0, Windows PowerShell 5,0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

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 lekéréses ügyfél beállítása előtt be kell állítania egy lekérési kiszolgálót.Before setting up a pull client, you should set up a pull server. Bár ez a sorrend nem kötelező, segít a hibaelhárításban, és segít biztosítani, hogy a regisztráció sikeres legyen.Though this order is not required, it helps with troubleshooting, and helps you ensure that the registration was successful. A lekéréses kiszolgáló beállításához a következő útmutatók használhatók:To set up a pull server, you can use the following guides:

Mindegyik cél csomópont beállítható úgy, hogy a konfigurációkat, erőforrásokat és az állapotukat is letöltsön.Each target node can be configured to download configurations, resources, and even report its status. Az alábbi részekben bemutatjuk, hogyan konfigurálhat egy lekéréses ügyfelet SMB-megosztás vagy HTTP DSC lekéréses kiszolgáló használatával.The sections below show you how to configure a pull client with an SMB share or HTTP DSC Pull Server. Ha a csomópont LCD-hálózata nem frissül, akkor a rendszer a konfigurált konfiguráció elérését fogja elérni.When the Node's LCM refreshes, it will reach out to the configured location to download any assigned configurations. Ha a csomóponton nem léteznek szükséges erőforrások, a rendszer automatikusan letölti azokat a konfigurált helyről.If any required resources do not exist on the Node, it will automatically download them from the configured location. Ha a csomópont egy jelentéskészítő kiszolgálóvalvan konfigurálva, akkor a művelet állapotát fogja jelenteni.If the Node is configured with a Report Server, it will then report the status of the operation.

A lekéréses ügyfél-LCD-eszközök konfigurálásaConfigure the pull client LCM

Az alábbi példák bármelyikének végrehajtása létrehoz egy PullClientConfigID nevű új kimeneti mappát, és ott helyez el egy metaconfiguration MOF-fájlt.Executing any of the examples below creates a new output folder named PullClientConfigID and puts a metaconfiguration MOF file there. Ebben az esetben a metaconfiguration MOF-fájl neve lesz localhost.meta.mof .In this case, the metaconfiguration MOF file will be named localhost.meta.mof.

A konfiguráció alkalmazásához hívja meg a set-DscLocalConfigurationManager parancsmagot, és az elérési utat állítsa a metaconfiguration MOF-fájljának helyére.To apply the configuration, call the Set-DscLocalConfigurationManager cmdlet, with the Path set to the location of the metaconfiguration MOF file. Például:For example:

Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigId –Verbose.

Konfigurációs azonosítóConfiguration ID

Az alábbi példák az LCD ChipOnGlas ConfigurationID tulajdonságát egy olyan GUID azonosítóra állították be, amely korábban már létre lett hozva erre a célra.The examples below set the ConfigurationID property of the LCM to a Guid that had been previously created for this purpose. A ConfigurationID a lekérési kiszolgálón a megfelelő konfiguráció megtalálásához használt eszköz.The ConfigurationID is what the LCM uses to find the appropriate configuration on the pull server. A lekérési kiszolgálón a konfigurációs MOF-fájlt el kell nevezni ConfigurationID.mof , ahol a ConfigurationID a ConfigurationID tulajdonságának értéke.The configuration MOF file on the pull server must be named ConfigurationID.mof, where ConfigurationID is the value of the ConfigurationID property of the target node's LCM. További információ: konfigurációk közzététele egy lekérési kiszolgálón (v4/V5).For more information, see Publish Configurations to a Pull Server (v4/v5).

Az alábbi példában létrehozhat egy véletlenszerű GUID azonosítót .You can create a random Guid using the example below.

[System.Guid]::NewGuid()

Lekéréses ügyfél beállítása a konfigurációk letöltéséhezSet up a Pull Client to download Configurations

Minden ügyfelet lekéréses módban kell konfigurálni, és meg kell adni a lekérési kiszolgáló URL-címét, ahol a konfigurációját tárolja.Each client must be configured in Pull mode and given the pull server url where its configuration is stored. Ehhez konfigurálnia kell a helyi Configuration Manager (LCD-t) a szükséges információkkal.To do this, you have to configure the Local Configuration Manager (LCM) with the necessary information. Az LCD ChipOnGlas konfigurálásához hozzon létre egy speciális konfigurációt egy LocalConfigurationManager blokk használatával.To configure the LCM, you create a special type of configuration, with a LocalConfigurationManager block. Az LCD ChipOnGlas konfigurálásával kapcsolatos további információkért lásd: a helyi Configuration Manager konfigurálása.For more information about configuring the LCM, see Configuring the Local Configuration Manager.

HTTP DSC lekérési kiszolgálóHTTP DSC Pull Server

Ha a lekérési kiszolgáló webszolgáltatásként van beállítva, a DownloadManagerName WebDownloadManager értékre kell állítania.If the pull server is set up as a web service, you set the DownloadManagerName to WebDownloadManager . A WebDownloadManager meg kell adnia egy ServerURL a DownloadManagerCustomData kulcshoz.The WebDownloadManager requires that you specify a ServerUrl to the DownloadManagerCustomData key. A AllowUnsecureConnection értékét is megadhatja az alábbi példában látható módon.You can also specify a value for AllowUnsecureConnection , as in the example below. Az alábbi szkript úgy konfigurálja az LCD ChipOnGlas-t, hogy lekérje a konfigurációkat egy "PullServer" nevű kiszolgálóról.The following script configures the LCM to pull configurations from a server named "PullServer".

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24";
        RefreshMode = "PULL";
        DownloadManagerName = "WebDownloadManager";
        RebootNodeIfNeeded = $true;
        RefreshFrequencyMins = 30;
        ConfigurationModeFrequencyMins = 30;
        ConfigurationMode = "ApplyAndAutoCorrect";
        DownloadManagerCustomData = @{ServerUrl = "http://PullServer:8080/PSDSCPullServer/PSDSCPullServer.svc"; AllowUnsecureConnection = "TRUE"}
    }
}
PullClientConfigId -Output "."

SMB-megosztásSMB Share

Ha a lekérési kiszolgáló SMB-fájlmegosztásként van beállítva, nem pedig webszolgáltatásként, akkor a DownloadManagerName a DscFileDownloadManager helyett a WebDownLoadManager értékre kell állítania.If the pull server is set up as an SMB file share, rather than a web service, you set the DownloadManagerName to DscFileDownloadManager rather than the WebDownLoadManager . A DscFileDownloadManager a SourcePath tulajdonságot kell megadnia a DownloadManagerCustomData .The DscFileDownloadManager requires that you specify a SourcePath property in the DownloadManagerCustomData . A következő parancsfájl úgy konfigurálja az LCD ChipOnGlas-t, hogy a "SmbDscShare" nevű SMB-megosztásból lekérje a konfigurációkat egy "CONTOSO-SERVER" nevű kiszolgálón.The following script configures the LCM to pull configurations from an SMB share named "SmbDscShare" on a server named "CONTOSO-SERVER".

Configuration PullClientConfigId
{
    LocalConfigurationManager
    {
        ConfigurationID = "1C707B86-EF8E-4C29-B7C1-34DA2190AE24";
        RefreshMode = "PULL";
        DownloadManagerName = "DscFileDownloadManager";
        RebootNodeIfNeeded = $true;
        RefreshFrequencyMins = 30;
        ConfigurationModeFrequencyMins = 30;
        ConfigurationMode = "ApplyAndAutoCorrect";
        DownloadManagerCustomData = @{ServerUrl = "\\CONTOSO-SERVER\SmbDscShare"}
    }
}
PullClientConfigId -Output "."

Következő lépésekNext Steps

A lekéréses ügyfél konfigurálása után a következő útmutatók segítségével hajthatja végre a következő lépéseket:Once the pull client has been configured, you can use the following guides to perform the next steps:

Lásd még:See Also