Apenas mais uma ferramenta: conhecer a configuração do serviço com a Configuração do estado desejado 

• “Descompacte a caixa” com o mecanismo DSC, veja quais são os recursos por padrão e mostre onde obter recursos adicionais;
  
• Vamos ver como descrever a configuração no DSC; 
  
• Aprenderemos como o agente de configuração local do agente interno aplica configurações no servidor, mostra como ele é configurado usando meta-configurações;
  
• vamos passar para casos de configuração mais complexos: configurações parciais e configurações de stub.
  

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

1. Configure o Gerenciador de configuração local (LCM) . Esse é o agente interno responsável pela aplicação das configurações no servidor. Dizemos a ele como as configurações declaradas devem funcionar e em que ordem. 
   
2. Se forem necessários recursos adicionais, instale e conecte-os com antecedência.
   
3. De forma declarativa, escrevemos a ordem de configuração. 
   
4. Nós transmitimos a configuração no formato do arquivo MOF.
   
5. Enviamos a configuração para o servidor recém-implantado ou existente de destino.
   
6. O LCM recebe a configuração (arquivo MOF), além de instruções para configurar o próprio LCM.
   
7. A configuração é aplicada imediatamente por nossa equipe.
   

Recursos 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

• Arquivo - com embalagem e descompactação de arquivos;
  
• Ambiente - com variáveis ​​de ambiente;
  
• Arquivo - com arquivos;
  
• Grupo - com grupos de usuários locais;
  
• Log - com logs;
  
• Pacote - com pacotes de software;
  
• Registro - com chaves do registro e seu status;
  
• Serviço - com serviços e seu status;
  
• Usuário - com contas de usuário local;
  
• WindowsFeature — Windows Server;
  
• WindowsProcess — Windows;
  
• Script —  PowerShell- . 3 : SetScript — -, TestScript — , , GetScript — .
  

Análise de configuração simples

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"

• bloco param com parâmetros que podem ser usados ​​internamente; 
  
• bloquear com chamadas adicionais do PowerShell. Aqui, no início da configuração, sempre executamos Import-Resource para conectar recursos adicionais;
  
• blocos com configurações para servidores específicos do Nó $ 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]]
}

• Nome - o nome da variável de ambiente.
  
• Em DependsOn, especificamos a dependência de outros recursos. É importante lembrar que a operação não será executada até que o recurso especificado aqui seja concluído. 
  
• Em Garantir, especificamos as condições de configuração. Se essa variável estiver ausente, nós a criaremos; se estiver presente, esse recurso não será configurado.
  
• O caminho especifica se a variável de ambiente contém um caminho. 
  
• Em PsDscRunAsCredential, credenciais especificadas.
  
• Valor - o valor da variável de ambiente. 
  
• O alvo pode ser indicado em relação a quem a configuração é aplicada.
  

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 o Gerenciador de configuração 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                 :

• O RefreshMode contém o modo de operação LCM - Push ou Pull. Falaremos mais sobre os modos no segundo artigo.
  
• ConfigurationMode mostra o modo de aplicativo de configuração atual. No nosso caso, é o ApplyAndMonitor - aplique e rastreie as alterações. Os modos ApplyOnly também estão disponíveis (o LCM não rastreará alterações na configuração) e os modos ApplyAndAutocorrect (o LCM não rastreará apenas as alterações, mas também as reverterá para a configuração base).
  
• RebootNodeIfNeeded - pode reiniciar o servidor após a conclusão da configuração, se necessário, para aplicar as configurações. 
  
• ConfigurationModeFrequencyMins - Corrige a frequência com que o LCM verifica as alterações na configuração.
  

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
…

Configurações Parciais 

1. Primeiro, verifique se os módulos necessários estão instalados no servidor.
   
2. Realizamos a configuração, que trará o servidor para o estado desejado.
   

#   
[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. Se a primeira parte da configuração retornou inicialmente FALSE e foi concluída completamente, o LCM não irá para a segunda configuração. De acordo com a lógica do DSC, primeiro você precisa trazer o servidor para o primeiro estado descrito. 
   Como tratar: execute a configuração duas vezes ou automatize todo o processo em um script.
2. Se o servidor após a instalação de qualquer componente exigir uma reinicialização, a configuração não irá além até que nós mesmos reiniciemos o servidor. Mesmo se dissermos ao LCM que RebootNodeIfNeeeded = $ True, o agente aguardará nossa solução durante a configuração.
   Como tratar: o recurso xPendingReboot chega ao resgate , que controla a chave do Registro após a reinicialização. Este recurso reinicia o servidor para nós.
   

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\"
       }
   }
}

Sobre segurança

• credenciais são armazenadas em texto sem formatação,
  
• credenciais criptografadas funcionam apenas no PC onde foram geradas.
  

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

• reboot (recurso xPendingReboot) 
• transferência de credenciais 
• outros recursos que podem afetar o desempenho do servidor em relação a reinicializações ou segurança não planejadas.