Applicare, ottenere e testare le configurazioni in un nodo
Questa Guida illustrerà come usare le configurazioni in un nodo di destinazione. Questa guida è suddivisa nei seguenti passaggi:
Applicare una configurazione
Per applicare e gestire una configurazione, è necessario generare un file "MOF". Il codice seguente rappresenta una configurazione semplice che verrà usata in questa guida.
Configuration Sample
{
# This will generate two .mof files, a localhost.mof, and a server02.mof
Node localhost, server02
{
File SampleFile
{
DestinationPath = 'C:\Temp\temp.txt'
Contents = 'This is a simple resource to show Configuration functionality on a Node.'
}
}
}
# The -OutputPath parameter is built into every Configuration automatically.
# The value of -OutputPath determines where the .mof file should be stored, once compiled.
Sample -OutputPath "C:\Temp\"
La compilazione di questa configurazione restituirà due file "MOF".
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 11/27/2018 7:29 AM 2.13KB localhost.mof
-a---- 11/27/2018 7:29 AM 2.13KB server02.mof
Per applicare una configurazione usare il cmdlet Start-DscConfiguration. Il parametro -Path specifica una directory in cui risiedono i file "MOF". Se non è specificato -Computername, Start-DSCConfiguration tenterà di applicare ogni configurazione al nome del computer specificato dal nome del file MOF (<computername>.mof). Specificare -Verbose per Start-DSCConfiguration per visualizzare un output più dettagliato.
Start-DSCConfiguration -Path C:\Temp\ -Verbose
Se -Wait non è specificato, viene visualizzato un processo creato. Il processo creato disporrà di un ChildJob per ogni file "MOF" elaborato da Start-DSCConfiguration.
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
45 Job45 Configuratio... Running True localhost,server02 Start-DSCConfiguration...
Se una configurazione sta richiedendo molto tempo e si vuole arrestarla, è possibile usare Stop-DSCConfiguration per arrestare l'applicazione nel nodo locale.
Stop-DSCConfiguration -Force
Al termine dell'operazione, è possibile visualizzare lo stato dei processi tramite l'oggetto processo restituito da Get-Job.
$job = Get-Job
$job.ChildJobs
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
49 Job49 Configuratio... Completed True localhost Start-DSCConfiguration...
50 Job50 Configuratio... Completed True server02 Start-DSCConfiguration...
Per visualizzare l'output dettagliato, usare i seguenti comandi per visualizzare il flusso dettagliato per ogni ChildJob. Per altre informazioni sui processi di PowerShell, vedere le informazioni sui processi.
# View the verbose output of the localhost job using array indexing.
$job.ChildJobs[0].Verbose
Perform operation 'Invoke CimMethod' with following parameters, ''methodName' = SendConfigurationApply,
'className' = MSFT_DSCLocalConfigurationManager,'namespaceName' = root/Microsoft/Windows/DesiredStateConfiguration'.
An LCM method call arrived from computer SERVER01 with user sid S-1-5-21-124525095-708259637-1543119021-1282804.
[SERVER01]: LCM: [ Start Set ]
[SERVER01]: LCM: [ Start Resource ] [[File]SampleFile]
[SERVER01]: LCM: [ Start Test ] [[File]SampleFile]
[SERVER01]: [[File]SampleFile] The destination object was found and no action is required.
[SERVER01]: LCM: [ End Test ] [[File]SampleFile] in 0.0370 seconds.
[SERVER01]: LCM: [ Skip Set ] [[File]SampleFile]
[SERVER01]: LCM: [ End Resource ] [[File]SampleFile]
[SERVER01]: LCM: [ End Set ]
[SERVER01]: LCM: [ End Set ] in 0.2400 seconds.
Operation 'Invoke CimMethod' complete.
A partire da PowerShell 5.0, il parametro -UseExisting è stato aggiunto a Start-DSCConfiguration. Specificando -UseExisting, si indica al cmdlet di usare la configurazione esistente applicata invece di quella specificata dal parametro -Path.
Start-DSCConfiguration -UseExisting -Verbose -Wait
Test di una configurazione
È possibile testare una configurazione attualmente applicata mediante Test-DSCConfiguration.
Test-DSCConfiguration restituirà True se il nodo è conforme e False in caso contrario.
Test-DSCConfiguration
A partire da PowerShell 5.0, è stato aggiunto il parametro -Detailed che restituisce un oggetto con le raccolte per ResourcesInDesiredState e ResourcesNotInDesiredState
Test-DSCConfiguration -Detailed
A partire da PowerShell 5.0 è possibile testare una configurazione senza applicarla. Il parametro -ReferenceConfiguration accetta il percorso di un file "MOF" per eseguire il test del nodo. Non vengono intraprese azioni Set sul nodo. In PowerShell 4.0, sono disponibili soluzioni alternative per testare una configurazione senza applicarla, ma non sono descritte qui.
Recuperare i valori della configurazione
Il cmdlet Get-DSCConfiguration restituisce i valori correnti per qualsiasi risorsa configurata nella configurazione attualmente applicata.
Get-DSCConfiguration
L'output della configurazione di esempio ha un aspetto simile al seguente se la configurazione è stata applicata correttamente.
ConfigurationName : Sample
DependsOn :
ModuleName : PSDesiredStateConfiguration
ModuleVersion :
PsDscRunAsCredential :
ResourceId : [File]SampleFile
SourceInfo :
Attributes : {archive}
Checksum :
Contents :
CreatedDate : 11/27/2018 7:16:06 AM
Credential :
DestinationPath : C:\Temp\temp.txt
Ensure : present
Force :
MatchSource :
ModifiedDate : 11/27/2018 7:16:06 AM
Recurse :
Size : 75
SourcePath :
SubItems :
Type : file
PSComputerName :
CimClassName : MSFT_FileDirectoryConfiguration
Ottenere lo stato della configurazione
A partire da PowerShell 5.0 il cmdlet Get-DSCConfigurationStatus consente di visualizzare la cronologia delle configurazioni applicate al nodo. PowerShell DSC tiene traccia delle ultime configurazioni applicate {{N}} in modalità Push o Pull. Ciò include eventuali verifiche di coerenza eseguite da Gestione configurazione locale (LCM). Per impostazione predefinita, Get-DSCConfigurationStatus mostra solo l'ultima voce di cronologia.
Get-DSCConfigurationStatus
Status StartDate Type Mode RebootRequested NumberOfResources
------ --------- ---- ---- --------------- -----------------
Success 11/27/2018 7:18:40 AM Consistency PUSH False 1
Usare il parametro -All per visualizzare tutta la cronologia dello stato di configurazione.
Nota
L'output viene troncato per brevità.
Get-DSCConfigurationStatus -All
Status StartDate Type Mode RebootRequested NumberOfResources
------ --------- ---- ---- --------------- -----------------
Success 11/27/2018 7:18:40 AM Consistency PUSH False 1
Success 11/27/2018 7:16:06 AM Initial PUSH False 1
Success 11/27/2018 7:04:53 AM Initial PUSH False 1
Success 11/27/2018 7:03:45 AM Consistency PUSH False 2
Success 11/27/2018 7:03:40 AM Consistency PUSH False 2
Success 11/27/2018 6:48:40 AM Consistency PUSH False 2
Success 11/27/2018 6:33:44 AM Consistency PUSH False 2
Success 11/27/2018 6:33:40 AM Consistency PUSH False 2
Success 11/27/2018 6:18:40 AM Consistency PUSH False 2
Success 11/27/2018 6:03:44 AM Consistency PUSH False 2
Gestire i documenti di configurazione
Gestione configurazione locale (LCM) gestisce la configurazione del nodo usando i documenti di configurazione. I file MOF risiedono nella directory C:\Windows\System32\Configuration.
A partire da PowerShell 5.0 Remove-DSCConfigurationDocument consente di rimuovere i file "MOF" per interrompere verifiche coerenza future o per rimuovere una configurazione che restituisce errori quando applicata. Il parametro -Stage consente di specificare quale file "MOF" si desidera rimuovere.
Remove-DSCConfigurationDocument -Stage Current
Nota
In PowerShell 4.0 è comunque possibile rimuovere i file "MOF" direttamente usando Remove-Item.
Pubblicare le configurazioni
A partire da PowerShell 5.0 è stato aggiunto il cmdlet Publish-DSCConfiguration. Questo cmdlet consente di pubblicare un file "MOF" in computer remoti, senza applicarlo.
Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)
Vedere anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per