Solo otra herramienta: conocer la configuración del servicio con la Configuración de estado deseada 

• “Desempaquete la caja” con el motor DSC, vea qué recursos están por defecto y muestre dónde obtener recursos adicionales;
  
• Veamos cómo describir la configuración en DSC; 
  
• Aprenderemos cómo el agente de configuración local Local Manager Manager aplica las configuraciones en el servidor, mostraremos cómo se configura usando metaconfiguraciones;
  
• pasemos a casos de configuración más complejos: configuraciones parciales y configuraciones de código auxiliar.
  

• « » Windows PowerShell. 
  DSC PowerShell Windows Management Framework. Linux . , PowerShell. 
• , . 
  , , , . DSC. 
• , .
  DSC , . .
  

1. Configure el Administrador de configuración local (LCM) . Este es el agente integrado que se encarga de aplicar las configuraciones al servidor. Le decimos cómo deberían funcionar las configuraciones declaradas y en qué orden. 
   
2. Si se necesitan recursos adicionales, instálelos y conéctelos con anticipación.
   
3. En forma declarativa, escribimos el orden de configuración. 
   
4. Emitimos la configuración en el formato del archivo MOF.
   
5. Enviamos la configuración al servidor objetivo recién implementado o existente.
   
6. LCM recibe la configuración (archivo MOF) más instrucciones para configurar el propio LCM.
   
7. La configuración es aplicada inmediatamente por nuestro equipo.
   

Recursos de DSC 

PS C:\windows\system32> Get-DscResource | Sort-Object -Property Name | ft ImplementedAs, Name -a
 
ImplementedAs Name
------------- ----
   PowerShell Archive
   PowerShell Environment
       Binary File
   PowerShell Group
    Composite GroupSet
       Binary Log
   PowerShell Package
   PowerShell PackageManagement
   PowerShell PackageManagementSource
    Composite ProcessSet
   PowerShell Registry
   PowerShell Script
   PowerShell Service
    Composite ServiceSet
       Binary SignatureValidation
   PowerShell User
   PowerShell WaitForAll
   PowerShell WaitForAny
   PowerShell WaitForSome
   PowerShell WindowsFeature
    Composite WindowsFeatureSet
   PowerShell WindowsOptionalFeature
    Composite WindowsOptionalFeatureSet
   PowerShell WindowsPackageCab
   PowerShell WindowsProcess

• Archivo - con embalaje y desembalaje de archivos;
  
• Entorno: con variables de entorno;
  
• Archivo - con archivos;
  
• Grupo: con grupos de usuarios locales;
  
• Registro - con registros;
  
• Paquete —– con paquetes de software;
  
• Registro —– con claves de registro y su estado;
  
• Servicio - con servicios y su estado;
  
• Usuario: con cuentas de usuario locales;
  
• WindowsFeature — Windows Server;
  
• WindowsProcess — Windows;
  
• Script —  PowerShell- . 3 : SetScript — -, TestScript — , , GetScript — .
  

Análisis de configuración simple

Configuration EnvironmentVariable_Path
{
param ()
Import-DscResource -ModuleName 'PSDscResources'
Node localhost
    {
        Environment CreatePathEnvironmentVariable
        {
            Name = 'TestPathEnvironmentVariable'
            Value = 'TestValue'
            Ensure = 'Present'
            Path = $true
            Target = @('Process', 'Machine')
        }
    }
}
EnvironmentVariable_Path -OutputPath:"C:\EnvironmentVariable_Path"

• PARAM bloque con los parámetros que se puede utilizar internamente; 
  
• bloque con llamadas adicionales de PowerShell. Aquí, al comienzo de la configuración, siempre ejecutamos Import-Resource para conectar recursos adicionales;
  
• bloques con configuraciones para servidores específicos de Node $ servername. 
  

PS C:\windows\system32> Get-DscResource -Name Environment -Syntax
Environment [String] #ResourceName
{
    Name = [string]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [Path = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [Value = [string]]
}

• Nombre : el nombre de la variable de entorno.
  
• En DependsOn, especificamos la dependencia de otros recursos. Es importante recordar que la operación no se realizará hasta que se complete el recurso especificado aquí. 
  
• En Asegurar, especificamos las condiciones de configuración. Si dicha variable está ausente, la crearemos; si está presente, este recurso no se configurará.
  
• La ruta especifica si la variable de entorno contiene una ruta. 
  
• En PsDscRunAsCredential credenciales especificadas.
  
• Valor : el valor de la variable de entorno. 
  
• El destino puede indicarse con respecto a quién se aplica la configuración.
  

PS C:\windows\system32> EnvironmentVariable_Path -OutputPath:"C:\EnvironmentVariable_Path"
 
    Directory: C:\EnvironmentVariable_Path
 
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       25.02.2020     14:05           2172 localhost.mof

Configurar el administrador de configuración local

PS C:\windows\system32> Get-DscLocalConfigurationManager
 
ActionAfterReboot              : ContinueConfiguration
AgentId                        : 1FB3A2EE-57C9-11EA-A204-58A023EF3A48
AllowModuleOverWrite           : False
CertificateID                  :
ConfigurationDownloadManagers  : {}
ConfigurationID                :
ConfigurationMode              : ApplyAndMonitor
ConfigurationModeFrequencyMins : 15
Credential                     :
DebugMode                      : {NONE}
DownloadManagerCustomData      :
DownloadManagerName            :
LCMCompatibleVersions          : {1.0, 2.0}
LCMState                       : Idle
LCMStateDetail                 :
LCMVersion                     : 2.0
StatusRetentionTimeInDays      : 10
SignatureValidationPolicy      : NONE
SignatureValidations           : {}
MaximumDownloadSizeMB          : 500
PartialConfigurations          :
RebootNodeIfNeeded             : False
RefreshFrequencyMins           : 30
RefreshMode                    : PUSH
ReportManagers                 : {}
ResourceModuleManagers         : {}
PSComputerName                 :

• RefreshMode contiene el modo operativo LCM: Push o Pull. Hablaremos más sobre modos en el segundo artículo.
  
• ConfigurationMode muestra el modo de aplicación de configuración actual. En nuestro caso, es ApplyAndMonitor: aplica y realiza un seguimiento de los cambios. Los modos ApplyOnly también están disponibles (LCM no rastreará los cambios de configuración) y modos ApplyAndAutocorrect (LCM no solo rastreará los cambios, sino que también los revertirá a la configuración base).
  
• RebootNodeIfNeeded : puede reiniciar el servidor una vez completada la configuración, si es necesario para aplicar la configuración. 
  
• ConfigurationModeFrequencyMins : corrige la frecuencia con la que LCM verificará los cambios de configuración.
  

Configuration LCMConfiguration
{
   Node Localhost
   {
       LocalConfigurationManager
       {
           RebootNodeIfNeeeded = $True
       }
   }
}
LCMConfiguration

 
[DSCLocalConfigurationManager()]
Configuration LCMConfiguration
{
   param
   (
       [string[]]$Server = "localhost"
   )

 

#  LCM:
#  ,  
# : PUSH
#    30 
   Node $Server
   {
       Settings
       {
           RebootNodeIfNeeded = $True
           RefreshMode        = 'Push'
           RefreshFrequencyMins = 30
       }
   }
}


#   
LCMConfiguration -Server "localhost" -OutputPath "C:\DSC\MetaConfigurations\EnvironmentVariable_Path\"

PS C:\windows\system32> LCMConfiguration -OutputPath C:\EnvironmentVariable_Path\
 
    Directory: C:\EnvironmentVariable_Path
 
Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       26.02.2020     20:05           1016 Localhost.meta.mof

 

PS C:\windows\system32> Set-DscLocalConfigurationManager -Path C:\EnvironmentVariable_Path\
PS C:\windows\system32> Get-DscLocalConfigurationManager
 
…
RebootNodeIfNeeded             : True
…

Configuraciones parciales 

1. Primero, verifique que los módulos necesarios estén instalados en el servidor.
   
2. Realizamos la configuración, que llevará al servidor al estado deseado.
   

#   
[DSCLocalConfigurationManager()]
configuration MetaPushConfig
{
param
   (
       [ValidateNotNullOrEmpty()]
       [string] $NodeName = 'localhost'
   )

 

   Node $NodeName
   {
 	
 #      LCM,    
       PartialConfiguration ModulesDownloadConfig
       {
               Description = 'Download and install modules'
               RefreshMode = 'Push'
       }

 

       #        
       PartialConfiguration ServerOSConfig
       {
               DependsOn = "[PartialConfiguration]ModulesDownloadConfig"
               Description = 'Configuration'
               RefreshMode = 'Push'
       }

 

       #   LCM
       Settings
       {
               RefreshMode        = 'Push'
               RefreshFrequencyMins = 30
               RebootNodeIfNeeded = $true
       }
   }
}

 
 

#  
MetaPushConfig -NodeName "NewServer.contoso.com" -OutputPath c:\DSC\MetaConfigurations

 

#      
$cred = (Get-Credential -UserName Administrator -Message "Enter admin credentials")

 

#  LCM   
Set-DscLocalConfigurationManager -ComputerName "NewServer.contoso.com" -Credential $cred -Path "c:\DSC\MetaConfigurations" -Verbose -Force

 

#  
Publish-DscConfiguration c:\DSC\Configurations\ModulesDownloadConfig -ComputerName "NewServer.contoso.com" -Credential $cred -Force
Publish-DscConfiguration c:\DSC\Configurations\ServerOSConfig -ComputerName "NewServer.contoso.com" -Credential $cred -Force

 

#    
Start-DscConfiguration -UseExisting -ComputerName "NewServer.contoso.com" -Credential $cred -Force -Verbose

1. Si la primera parte de la configuración inicialmente devolvió FALSO y se completó por completo, entonces LCM no pasará a la segunda configuración. Según la lógica DSC, primero debe llevar el servidor al primer estado descrito. 
   Cómo tratar: ejecute la configuración dos veces o automatice todo el proceso en un script.
2. Si el servidor después de instalar algún componente requiere un reinicio, la configuración no irá más allá hasta que nosotros reiniciemos el servidor. Incluso si le decimos a LCM que RebootNodeIfNeeeded = $ True, el agente esperará nuestra solución durante la configuración.
   Cómo tratar: el recurso xPendingReboot viene al rescate , que controla la clave de registro al reiniciar. Este recurso reinicia el servidor por nosotros.
   

Configuration ModulesDownloadConfig
{
   param
   (
       [string[]]$Server
   )

 

   #   
   Import-DscResource -ModuleName "PSDesiredStateConfiguration"

 

   #  
   Node $Server
   {
       #  IE Security
       Registry DisableIEESC-Admin {
           Key = "HKLM:\SOFTWARE\Microsoft\Active Setup\Installed Components\{A509B1A7-37EF-4b3f-8CFC-4F3A74704073}"
           ValueName = "IsInstalled"
           Ensure = "Present"
           ValueData = 0
           ValueType = "DWORD"
       }

 

       Registry DisableIEESC-User {
           Key = "HKLM:\SOFTWARE\Microsoft\Active Setup\Installed Components\{A509B1A8-37EF-4b3f-8CFC-4F3A74704073}"
           ValueName = "IsInstalled"
           Ensure = "Present"
           ValueData = "0"
           ValueType = "DWORD"
       }

 

	
 #    ,    
       File CreateDistribDir {
           Ensure          = "present"
           DestinationPath = "C:\Install\PSModules"
           Type            = "Directory"
       }

 

	
 #   NetworkingDsc (<a href="https://www.powershellgallery.com/packages/NetworkingDsc/8.0.0-preview0004">https://www.powershellgallery.com/packages/NetworkingDsc/8.0.0-preview0004</a>),      
       Script NetworkingDscDownLoad {
           SetScript = { Invoke-WebRequest -Uri "http://repo.contoso.com/repo/modules/NetworkingDsc.zip" -OutFile "C:\Install\PSModules\NetworkingDsc.zip" }
           GetScript = { return @{ Result = Test-Path "C:\Install\PSModules\NetworkingDsc.zip"
               GetScript = $GetScript; SetScript = $SetScript; TestScript = $TestScript
               }
           }
           TestScript = { Test-Path "C:\Program Files\WindowsPowerShell\Modules\NetworkingDsc" }
       }

 

 #   NetworkingDsc  C:\Program Files\WindowsPowerShell\Modules
       Archive UnpackNetworkingDsc {
           Ensure = "Present"
           DependsOn = "[Script]NetworkingDscDownLoad"
           Path = "C:\Install\PSModules\NetworkingDsc.zip"
           Destination = "C:\Program Files\WindowsPowerShell\Modules\"
       }

 

 #   ComputerManagementDsc (<a href="https://www.powershellgallery.com/packages/ComputerManagementDsc/8.2.1-preview0001">https://www.powershellgallery.com/packages/ComputerManagementDsc/8.2.1-preview0001</a>),      
       Script ComputerManagementDscDownLoad {
           SetScript = { Invoke-WebRequest -Uri "http://repo.contoso.com/repo/modules/ComputerManagementDsc.zip" -OutFile "C:\Install\PSModules\ComputerManagementDsc.zip" }
           GetScript = { return @{ Result = Test-Path "C:\Install\PSModules\ComputerManagementDsc.zip"
               GetScript = $GetScript; SetScript = $SetScript; TestScript = $TestScript
               }
           }
           TestScript = { Test-Path "C:\Program Files\WindowsPowerShell\Modules\ComputerManagementDsc" }
       }

 

	
 #   ComputerManagementDsc  C:\Program Files\WindowsPowerShell\Modules
       Archive UnpackComputerManagementDsc {
           Ensure = "Present"
           DependsOn = "[Script]ComputerManagementDscDownLoad"
           Path = "C:\Install\PSModules\ComputerManagementDsc.zip"
           Destination = "C:\Program Files\WindowsPowerShell\Modules\"
       }

 

	
 #   xPendingReboot (<a href="https://www.powershellgallery.com/packages/xPendingReboot/0.4.0.0">https://www.powershellgallery.com/packages/xPendingReboot/0.4.0.0</a>),      
       Script xPendingRebootDownLoad {
           SetScript = { Invoke-WebRequest -Uri "http://repo.contoso.com/repo/modules/xPendingReboot.zip" -OutFile "C:\Install\PSModules\xPendingReboot.zip" }
           GetScript = { return @{ Result = Test-Path "C:\Install\PSModules\xPendingReboot.zip"
               GetScript = $GetScript; SetScript = $SetScript; TestScript = $TestScript
               }
           }
           TestScript = { Test-Path "C:\Program Files\WindowsPowerShell\Modules\xPendingReboot" }
       }

 

	
 #   xPendingReboot  C:\Program Files\WindowsPowerShell\Modules
       Archive UnpackxPendingReboot {
           Ensure = "Present"
           DependsOn = "[Script]xPendingRebootDownLoad"
           Path = "C:\Install\PSModules\xPendingReboot.zip"
           Destination = "C:\Program Files\WindowsPowerShell\Modules\"
       }
   }
}

Acerca de la seguridad

• las credenciales se almacenan en texto sin formato,
  
• Las credenciales cifradas solo funcionan en la PC donde se generaron.
  

• Azure Automation Run As Accounts Azure Automation State Configuration. « » Azure. , Run As On-Premise . « » , .
  
• DSC -, . 
  

• reiniciar (recurso xPendingReboot) 
• transferencia de credenciales 
• otros recursos que pueden afectar el rendimiento del servidor con respecto a reinicios no planificados o seguridad.