Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op: Windows PowerShell 5.0
De Local Configuration Manager (LCM) is de motor van Desired State Configuration (DSC). De LCM wordt uitgevoerd op elk doelknooppunt en is verantwoordelijk voor het parseren en uitvoeren van configuraties die naar het knooppunt worden verzonden. Het is ook verantwoordelijk voor een aantal andere aspecten van DSC, waaronder de volgende.
- Bepalen van de verversingsmodus (duwen of trekken).
- Specificeren hoe vaak een knooppunt configuraties ophaalt en uitvoert.
- Het knooppunt koppelen aan pull-service.
- Gedeeltelijke configuraties opgeven.
U gebruikt een speciaal type configuratie om de LCM te configureren om elk van deze gedragingen op te geven. In de volgende secties wordt beschreven hoe u de LCM configureert.
Windows PowerShell 5.0 introduceerde nieuwe instellingen voor het beheren van Local Configuration Manager. Zie De lokale configuratiemanager configureren in eerdere versies van Windows PowerShell voor meer informatie over het configureren van de LCM in Windows PowerShell 4.0.
Schrijven en uitvoeren van een LCM-configuratie
Als u de LCM wilt configureren, maakt u een speciaal type configuratie en voert u dit uit waarmee LCM-instellingen worden toegepast. Als u een LCM-configuratie wilt opgeven, gebruikt u het kenmerk DscLocalConfigurationManager. Hieronder ziet u een eenvoudige configuratie die de LCM instelt op de push-modus.
[DSCLocalConfigurationManager()]
configuration LCMConfig
{
Node localhost
{
Settings
{
RefreshMode = 'Push'
}
}
}
Het proces van het toepassen van instellingen op LCM is vergelijkbaar met het toepassen van een DSC-configuratie. U maakt een LCM-configuratie, compileert deze naar een MOF-bestand en past deze toe op de node. In tegenstelling tot DSC-configuraties voert u geen LCM-configuratie uit door de cmdlet Start-DscConfiguration aan te roepen. In plaats daarvan roept u Set-DscLocalConfigurationManager aan en geeft u het pad naar de MCF-configuratie van LCM op als parameter. Nadat u de LCM-configuratie hebt uitgevoerd, kunt u de eigenschappen van de LCM bekijken door de cmdlet Get-DscLocalConfigurationManager aan te roepen.
Een LCM-configuratie kan alleen blokken bevatten voor een beperkte set resources. In het vorige voorbeeld is de enige resource die wordt aangeroepen Instellingen. De andere beschikbare bronnen zijn:
- ConfigurationRepositoryWeb: specificeert een HTTP-pull-service voor configuraties.
- ConfigurationRepositoryShare: geeft een SMB-share op voor configuraties.
- ResourceRepositoryWeb: specificeert een HTTP-pull-service voor modules.
- ResourceRepositoryShare: geeft een SMB-share op voor modules.
- ReportServerWeb: geeft een HTTP-pull-service op waarnaar rapporten worden verzonden.
- PartialConfiguration: biedt gegevens om gedeeltelijke configuraties mogelijk te maken.
Basisinstellingen
Met uitzondering van het opgeven van pull-service-eindpunten/-paden en gedeeltelijke configuraties, worden alle eigenschappen van de LCM geconfigureerd in een instellingenblok. De volgende eigenschappen zijn beschikbaar in een blok Instellingen .
| Vastgoed | Typologie | Description |
|---|---|---|
| ActionAfterReboot | touw | Hiermee geeft u op wat er gebeurt na het opnieuw opstarten tijdens de toepassing van een configuratie. De mogelijke waarden zijn "ContinueConfiguration" en "StopConfiguration".
|
| AllowModuleOverwrite | bool | $TRUE als nieuwe configuraties die zijn gedownload van de pull-service zijn toegestaan om de oude op het doelknooppunt te overschrijven. Anders $FALSE. |
| Certificaat-ID | touw | De vingerafdruk van een certificaat dat wordt gebruikt om referenties te beveiligen die in een configuratie worden doorgegeven. Zie Referenties beveiligen in Windows PowerShell Desired State Configuration? voor meer informatie. Opmerking: dit wordt automatisch beheerd als u de Azure Automation DSC-pull-service gebruikt. |
| ConfiguratieDownloadManagers | CimInstance | Obsolete. Gebruik de blokken ConfigurationRepositoryWeb en ConfigurationRepositoryShare om eindpunten voor configuratiepull-services te definiëren. |
| Configuratie-ID | touw | Voor achterwaartse compatibiliteit met oudere pull-serviceversies. Een GUID die het configuratiebestand identificeert dat uit een pull-service moet worden gehaald. Het knooppunt haalt configuraties op de pull-service op als de naam van de configuratie-MOF de naam ConfigurationID.mof heeft. Notitie: Als u deze eigenschap instelt, werkt het registreren van het knooppunt met een pull-service met behulp van RegistrationKey niet. Zie Een pull-client met configuratienamen instellen voor meer informatie. |
| Configuratie-modus | touw | Hiermee geeft u op hoe de LCM de configuratie daadwerkelijk toepast op de doelknooppunten. Mogelijke waarden zijn 'ApplyOnly', 'ApplyAndMonitor' en 'ApplyAndAutoCorrect'.
|
| ConfiguratieModeFrequentieMins | UInt32 | Hoe vaak, in minuten, de huidige configuratie wordt gecontroleerd en toegepast. Deze eigenschap wordt genegeerd als de eigenschap ConfigurationMode is ingesteld op ApplyOnly. De standaardwaarde is 15. |
| Foutopsporingsmodus | touw | Mogelijke waarden zijn Geen, ForceModuleImport en Alle.
|
| RebootNodeIfNeeded | bool | Stel dit in op $true om resources toe te staan het knooppunt opnieuw op te starten met behulp van de $global:DSCMachineStatus vlag. Anders moet u het knooppunt handmatig opnieuw opstarten voor elke configuratie die dit vereist. De standaardwaarde is $false. Als u deze instelling wilt gebruiken wanneer een herstartvoorwaarde wordt uitgevoerd door iets anders dan DSC (zoals Windows Installer), combineert u deze instelling met de PendingReboot-resource in de module ComputerManagementDsc . |
| Vernieuwen | touw | Hiermee geeft u op hoe de LCM configuraties krijgt. De mogelijke waarden zijn "Uitgeschakeld","Push" en "Pull".
|
| RefreshFrequencyMins | Uint32 | Het tijdsinterval, in minuten, waarop de LCM een pull-service controleert om bijgewerkte configuraties te krijgen en de lokale configuratie controleert op drift. De configuratie wordt toegepast ongeacht of er een update is gedownload. Deze waarde wordt genegeerd als de LCM niet is geconfigureerd in de pull-modus. De standaardwaarde is 30. |
| Rapportbeheerders | CimInstance | Obsolete. Gebruik ReportServerWeb-blokken om een eindpunt te definiëren voor het verzenden van rapportagegegevens naar een pull-service. |
| ResourceModuleManagers | CimInstance | Obsolete. Gebruik de blokken ResourceRepositoryWeb en ResourceRepositoryShare om respectievelijk HTTP-eindpunten of SMB-paden voor pull-services te definiëren. |
| Gedeeltelijke configuraties | CimInstance | Niet geïmplementeerd. Niet gebruiken. |
| StatusRetentieTijdInDagen | UInt32 | Het aantal dagen dat het LCM de status van de huidige configuratie bijhoudt. |
Opmerking
De LCM start de ConfigurationModeFrequencyMins-cyclus op basis van:
- Een nieuwe metaconfig met een wijziging in ConfigurationModeFrequencyMins wordt toegepast met behulp van
Set-DscLocalConfigurationManager - Een herstart van de machine
Voor elke omstandigheid waarbij het timerproces een crash ervaart, wordt dat binnen 30 seconden gedetecteerd en wordt de cyclus opnieuw gestart. Een gelijktijdige bewerking kan het starten van de cyclus vertragen, als de duur van deze bewerking de geconfigureerde cyclusfrequentie overschrijdt, start de volgende timer niet. De metaconfig is bijvoorbeeld geconfigureerd met een pull-frequentie van 15 minuten en er vindt een pull plaats op T1. De knoop is 16 minuten niet klaar met werken. De eerste cyclus van 15 minuten wordt genegeerd en de volgende trek vindt plaats op T1+15+15.
De oorspronkelijke bedoeling in Pull-scenario's was dat de RefreshFrequencyMins is ingesteld op een langere tijd dan de ConfigurationModeFrequencyMins. Lokale configuraties zouden voornamelijk worden beheerd om ConfigurationModeFrequencyMins configuratiedrift te voorkomen en RefreshFrequencyMins worden gebruikt om de werkelijke configuratiewijzigingen bij te houden die door de beheerder zijn aangebracht.
Pull service
LCM-configuratie ondersteunt het definiëren van de volgende typen pull-service-eindpunten:
- Configuratieserver: een opslagplaats voor DSC-configuraties. Definieer configuratieservers met behulp van ConfigurationRepositoryWeb (voor webservers) en ConfigurationRepositoryShare (voor SMB-servers) blokken.
- Bronserver: een opslagplaats voor DSC-resources, verpakt als PowerShell-modules. Definieer bronservers met behulp van ResourceRepositoryWeb (voor webservers) en ResourceRepositoryShare (voor SMB-servers) blokken.
- Rapportserver: een service waarnaar DSC rapportgegevens verzendt. Definieer rapportservers met behulp van ReportServerWeb-blokken . Een rapportserver moet een webservice zijn.
Zie voor meer informatie over de pull-service Desired State Configuration Pull Service.
Configuratie serverblokken
Als u een webgebaseerde configuratieserver wilt definiëren, maakt u een ConfigurationRepositoryWeb-blok . Een ConfigurationRepositoryWeb definieert de volgende eigenschappen.
| Vastgoed | Typologie | Description |
|---|---|---|
| AllowUnsecureConnection | bool | Stel in op $TRUE om verbindingen van het knooppunt naar de server zonder verificatie toe te staan. Stel in op $FALSE om verificatie te vereisen. |
| Certificaat-ID | touw | De vingerafdruk van een certificaat dat wordt gebruikt om te verifiëren bij de server. |
| ConfigurationNames | Tekenreeks[] | Een array met namen van configuraties die door het doelknooppunt moeten worden opgehaald. Deze worden alleen gebruikt als het knooppunt is geregistreerd bij de pull-service met behulp van een RegistrationKey. Zie Een pull-client met configuratienamen instellen voor meer informatie. |
| RegistratieKey | touw | Een GUID die het knooppunt registreert met de pull-service. Zie Een pull-client met configuratienamen instellen voor meer informatie. |
| Server-URL | touw | De URL van de configuratieservice. |
| Proxy-URL* | touw | De URL van de http-proxy die moet worden gebruikt bij de communicatie met de configuratieservice. |
| Proxy Credential* | pscredential | Referentie die moet worden gebruikt voor de http-proxy. |
Opmerking
Ondersteund in Windows-versies 1809 en hoger.
Er is een voorbeeldscript beschikbaar om het configureren van de waarde ConfigurationRepositoryWeb voor on-premises knooppunten te vereenvoudigen - zie DSC-metaconfiguraties genereren
Als u een SMB-gebaseerde configuratieserver wilt definiëren, maakt u een ConfigurationRepositoryShare-blok . Een ConfigurationRepositoryShare definieert de volgende eigenschappen.
| Vastgoed | Typologie | Description |
|---|---|---|
| Credential | MSFT_Credential | De referentie die wordt gebruikt om te verifiëren bij de SMB-share. |
| SourcePath | touw | Het pad van het MKB-aandeel. |
Blokken voor bronserver
Als u een webbronserver wilt definiëren, maakt u een ResourceRepositoryWeb-blok . Een ResourceRepositoryWeb definieert de volgende eigenschappen.
| Vastgoed | Typologie | Description |
|---|---|---|
| AllowUnsecureConnection | bool | Stel in op $TRUE om verbindingen van het knooppunt naar de server zonder verificatie toe te staan. Stel in op $FALSE om verificatie te vereisen. |
| Certificaat-ID | touw | De vingerafdruk van een certificaat dat wordt gebruikt om te verifiëren bij de server. |
| RegistratieKey | touw | Een GUID die het knooppunt naar de pull-service identificeert. |
| Server-URL | touw | De URL van de configuratieserver. |
| Proxy-URL* | touw | De URL van de http-proxy die moet worden gebruikt bij de communicatie met de configuratieservice. |
| Proxy Credential* | pscredential | Referentie die moet worden gebruikt voor de http-proxy. |
Opmerking
Ondersteund in Windows-versies 1809 en hoger.
Er is een voorbeeldscript beschikbaar om het configureren van de ResourceRepositoryWeb-waarde voor on-premises knooppunten te vereenvoudigen - zie DSC-metaconfiguraties genereren
Als u een SMB-bronserver wilt definiëren, maakt u een ResourceRepositoryShare-blok . ResourceRepositoryShare definieert de volgende eigenschappen.
| Vastgoed | Typologie | Description |
|---|---|---|
| Credential | MSFT_Credential | De referentie die wordt gebruikt om te verifiëren bij de SMB-share. Zie Een DSC SMB-pull-server instellen voor een voorbeeld van het doorgeven van referenties |
| SourcePath | touw | Het pad van het MKB-aandeel. |
Serverblokkades rapporteren
Als u een rapportserver wilt definiëren, maakt u een ReportServerWeb-blok . De functie van de rapportserver is niet compatibel met de pull-service op basis van SMB. ReportServerWeb definieert de volgende eigenschappen.
| Vastgoed | Typologie | Description |
|---|---|---|
| AllowUnsecureConnection | bool | Stel in op $TRUE om verbindingen van het knooppunt naar de server zonder verificatie toe te staan. Stel in op $FALSE om verificatie te vereisen. |
| Certificaat-ID | touw | De vingerafdruk van een certificaat dat wordt gebruikt om te verifiëren bij de server. |
| RegistratieKey | touw | Een GUID die het knooppunt naar de pull-service identificeert. |
| Server-URL | touw | De URL van de configuratieserver. |
| Proxy-URL* | touw | De URL van de http-proxy die moet worden gebruikt bij de communicatie met de configuratieservice. |
| Proxy Credential* | pscredential | Referentie die moet worden gebruikt voor de http-proxy. |
Opmerking
Ondersteund in Windows-versies 1809 en hoger.
Er is een voorbeeldscript beschikbaar om het configureren van de ReportServerWeb-waarde voor on-premises knooppunten te vereenvoudigen - zie DSC-metaconfiguraties genereren
Gedeeltelijke configuraties
Als u een gedeeltelijke configuratie wilt definiëren, maakt u een PartialConfiguration-blok . Zie Gedeeltelijke DSC-configuraties voor meer informatie over gedeeltelijke configuraties. PartialConfiguration definieert de volgende eigenschappen.
| Vastgoed | Typologie | Description |
|---|---|---|
| Configuratie Bron | string[] | Een matrix met namen van configuratieservers, eerder gedefinieerd in de blokken ConfigurationRepositoryWeb en ConfigurationRepositoryShare , waaruit de gedeeltelijke configuratie wordt opgehaald. |
| Hangt ervan af | snaar{} | Een lijst met namen van andere configuraties die moeten worden voltooid voordat deze gedeeltelijke configuratie wordt toegepast. |
| Description | touw | Tekst die wordt gebruikt om de gedeeltelijke configuratie te beschrijven. |
| ExclusieveBronnen | string[] | Een scala aan bronnen die exclusief zijn voor deze gedeeltelijke configuratie. |
| Vernieuwen | touw | Hiermee geeft u op hoe het LCM deze gedeeltelijke configuratie krijgt. De mogelijke waarden zijn "Uitgeschakeld","Push" en "Pull".
|
| Bron ModuleBron | string[] | Een matrix met namen van bronservers waarvan de vereiste bronnen voor deze gedeeltelijke configuratie moeten worden gedownload. Deze namen moeten verwijzen naar service-eindpunten die eerder zijn gedefinieerd in de blokken ResourceRepositoryWeb en ResourceRepositoryShare . |
Opmerking
gedeeltelijke configuraties worden ondersteund met Azure Automation DSC, maar er kan slechts één configuratie per knooppunt uit elk Automation-account worden opgehaald.
Zie ook
Concepten
Overzicht van de gewenste statusconfiguratie
Aan de slag met Azure Automation DSC