The VMware.vSphereDSC module is a collection of DSC Resources. This module includes DSC resources that simplify the management of vCenter and ESXi settings, with a simple declarative language.

The VMware.vSphereDSC module contains the following resources:

• VMHostNtpSettings: Used to configure NTP Server property and the Service Policy of the 'ntpd' Service of a ESXi host.
• VMHostDnsSettings: Used to configure the DNS Settings of a ESXi host.
• VMHostSatpClaimRule: Used to create or remove SATP Claim Rules of a ESXi host.
• VMHostTpsSettings: Used to configure TPS Settings of a ESXi host.
• vCenterStatistics: Used to configure the Statistics Settings of a vCenter.
• vCenterSettings: Used to update EventMaxAge Settings, TaskMaxAge Settings and the Logging Level of a vCenter.

VMware.vSphereDSC module contains Windows PowerShell Desired State Configuration Resources. The following table describes the required dependencies for running VMware.vSphereDSC Resources.

For information on how to install PowerShell, please visit Installing Windows PowerShell.

For information on how to install PowerCLI, please visit the PowerCLI Blog.

You also need to configure the DSC LCM on a Windows machine where the resources will run. For more information on how to configure it, please visit Desired State Configuration Quick Start

1. Copy the VMware.vSphereDSC Module to one of the system PowerShell module directories.For more information on installing PowerShell Modules, please visit Installing a PowerShell Module.

2. In PowerShell import the VMware.vSphereDSC Module:

    Import-Module -Name 'VMware.vSphereDSC' 
   

   To check if the module was successfully installed:

    Get-DscResource -Module 'VMware.vSphereDSC'
   

The following example uses VMHostNtpSettings Resource and configures the NTP Server and the 'ntpd' Service Policy.

1. You need to compile the Configuration File to MOF:

    $ntpConfigPath = Join-Path (Join-Path (Join-Path (Get-Module VMware.vSphereDSC -ListAvailable).ModuleBase 'Configurations') 'ESXiConfigs')'VMHostNtpSettings_Config.ps1'
    . $ntpConfigPath -Name '<VMHost Name>' -Server 'Server Name>' -User '<User Name>' -Password '<Password for User>'
   

2. To Test if the NTP Settings are in the desired state:

    Test-DscConfiguration -ComputerName <The name of the machine on which you are applying your configuration> -Path .\VMHostNtpSettings_Config\
   

3. To Apply the NTP Configuration:

    Start-DscConfiguration -ComputerName <The name of the machine on which you are applying your configuration> -Path .\VMHostNtpSettings_Config\ -Wait -Force
   

4. To get the latest applied configuration on your machine:

    Get-DscConfiguration
   

If you want to apply other configurations, you just need to compile the configuration file and pass the path of the created MOF file to the DSC cmdlets.

For more information about the DSC cmdlets please visit the PSDesiredStateConfiguration.

For a full list of resources in VMware.vSphereDSC and examples on their use, check out the Desired State Configuration Resources for VMware wiki.

This is the branch containing the latest release - no contributions should be made directly to this branch.

This is the development branch to which contributions should be proposed by contributors as pull requests. This development branch will periodically be merged to the master branch.

The Desired State Configuration Resources for VMware project team welcomes contributions from the community. For more detailed information, refer to CONTRIBUTING.md.

The Desired State Configuration Resources for VMware is distributed under the BSD-2.

For more details, please refer to the BSD-2 License File.