Частичные конфигурации службы настройки требуемого состояния PowerShell
Область применения: Windows PowerShell 5.0 и более поздних версий.
В PowerShell 5.0 служба настройки требуемого состояния (DSC) разрешает доставлять конфигурации фрагментами и из нескольких источников. Локальный диспетчер конфигураций (LCM) на целевом узле объединяет фрагменты перед тем, как применить их в качестве единой конфигурации. Эта возможность позволяет разделять конфигурацию между командами или отдельными пользователями. Например, если несколько команд разработчиков совместно работают над службой, возможно, каждая из них хочет создать конфигурацию для управления своей частью службы. Каждую из этих конфигураций можно извлекать с разных опрашивающих серверов и добавлять на разных этапах разработки. Частичные конфигурации позволяют разным пользователям или командам контролировать различные аспекты настройки узлов без координации изменений в едином документе конфигурации. Например, одна команда может отвечать за развертывание виртуальной машины и операционной системы, тогда как другая — развертывать другие приложения и службы в этой виртуальной машине. С частичными конфигурациями каждая команда может создать собственную конфигурацию без излишних сложностей.
Вы можете использовать частичные конфигурации в режиме принудительной отправки, в режиме запроса или в сочетании.
Частичные конфигурации в режиме принудительной отправки
Чтобы использовать частичные конфигурации в режиме принудительной отправки, настройте LCM на целевом узле для получения частичных конфигураций. Каждая частичная конфигурация должна принудительно отправляться на целевой узел с использованием командлета Publish-DSCConfiguration. Затем целевой узел добавляет частичную конфигурацию в единую. Применить конфигурацию можно, вызвав командлет Start-DscConfiguration.
Настройка LCM для частичных конфигураций в режиме принудительной отправки
Чтобы настроить LCM для частичных конфигураций в режиме принудительной отправки, создайте конфигурацию DSCLocalConfigurationManager с одним блоком PartialConfiguration для каждой частичной конфигурации. Дополнительные сведения о настройке LCM см. в разделе Настройка локального диспетчера конфигураций в Windows. В следующем примере показана конфигурация LCM, в которой ожидаются две частичные конфигурации: та, которая развертывает ОС, и та, которая развертывает и настраивает SharePoint.
[DSCLocalConfigurationManager()]
configuration PartialConfigDemo
{
Node localhost
{
PartialConfiguration ServiceAccountConfig
{
Description = 'Configuration to add the SharePoint service account to the Administrators group.'
RefreshMode = 'Push'
}
PartialConfiguration SharePointConfig
{
Description = 'Configuration for the SharePoint server'
RefreshMode = 'Push'
}
}
}
PartialConfigDemo
RefreshMode для каждой частичной конфигурации имеет значение "Push". Имена блоков PartialConfiguration (в этом случае ServiceAccountConfig и SharePointConfig) должны точно совпадать с именами конфигураций, отправляемых на целевой узел.
Примечание
Название каждого блока PartialConfiguration должно совпадать с фактическим названием конфигурации (которое указано в сценарии конфигурации), а не с именем MOF-файла, которое должно быть названием целевого узла или localhost.
Публикация и запуск частичных конфигураций в режиме принудительной отправки
Затем вызовите Publish-DSCConfiguration для каждой конфигурации, передав папки с документами конфигурации, в качестве параметров Path.
Publish-DSCConfiguration помещает конфигурацию MOF-файлов на целевые узлы. После публикации обеих конфигураций вы можете вызвать Start-DSCConfiguration –UseExisting на целевом узле.
Например, если вы скомпилировали следующую конфигурацию документов MOF на узле разработки:
Get-ChildItem -Recurse
Directory: C:\PartialConfigTest
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 8/11/2016 1:55 PM ServiceAccountConfig
d----- 11/17/2016 4:14 PM SharePointConfig
Directory: C:\PartialConfigTest\ServiceAccountConfig
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 8/11/2016 2:02 PM 2034 TestVM.mof
Directory: C:\PartialConfigTest\SharePointConfig
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a---- 11/17/2016 4:14 PM 1930 TestVM.mof
Публикация и запуск конфигураций выполняются следующим образом:
Publish-DscConfiguration .\ServiceAccountConfig -ComputerName 'TestVM'
Publish-DscConfiguration .\SharePointConfig -ComputerName 'TestVM'
Start-DscConfiguration -UseExisting -ComputerName 'TestVM'
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
17 Job17 Configuratio... Running True TestVM Start-DscConfiguration...
Примечание
Пользователь, запускающий командлет Publish-DSCConfiguration, должен иметь права администратора на целевом узле.
Частичные конфигурации в режиме запросов
Частичные конфигурации можно запросить с одного опрашивающего сервера или нескольких (дополнительные сведения об опрашивающих серверах см. в разделе Опрашивающие сервера настройки требуемого состояния Windows PowerShell). Для этого необходимо настроить в LCM на целевом узле извлечение частичных конфигураций, а также назвать документы конфигурации и указать их расположение на опрашивающих серверах.
Настройка LCM для конфигураций опрашивающего узла
Чтобы настроить в LCM опрос частичных конфигураций с опрашивающего сервера, определите опрашивающий сервер в блоке ConfigurationRepositoryWeb (для опрашивающего HTTP-сервера) или ConfigurationRepositoryShare (для опрашивающего SMB-сервера). Затем создайте блоки PartialConfiguration, которые ссылаются на опрашивающий сервер, используя свойство ConfigurationSource. Кроме того, вам потребуется создать блок параметров, чтобы указать, что LCM использует режим запросов, и задать ConfigurationNames или ConfigurationID для опрашивающего сервера и целевого узла в целях определения конфигураций. В следующей метаконфигурации задан опрашивающий HTTP-сервер с именем CONTOSO-PullSrv и две частичные конфигурации, использующие этот опрашивающий сервер.
Дополнительные сведения о настройке LCM с использованием ConfigurationNames см. в разделе Настройка опрашивающего клиента с помощью имен конфигурации. Дополнительные сведения о настройке LCM с использованием ConfigurationID см. в разделе Настройка опрашивающего клиента с помощью идентификатора конфигурации.
Настройка LCM для конфигураций режима запросов с использованием имен конфигурации
[DscLocalConfigurationManager()]
Configuration PartialConfigDemoConfigNames
{
Settings
{
RefreshFrequencyMins = 30;
RefreshMode = "PULL";
ConfigurationMode ="ApplyAndAutocorrect";
AllowModuleOverwrite = $true;
RebootNodeIfNeeded = $true;
ConfigurationModeFrequencyMins = 60;
}
ConfigurationRepositoryWeb CONTOSO-PullSrv
{
ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
RegistrationKey = 5b41f4e6-5e6d-45f5-8102-f2227468ef38
ConfigurationNames = @("ServiceAccountConfig", "SharePointConfig")
}
PartialConfiguration ServiceAccountConfig
{
Description = "ServiceAccountConfig"
ConfigurationSource = @("[ConfigurationRepositoryWeb]CONTOSO-PullSrv")
}
PartialConfiguration SharePointConfig
{
Description = "SharePointConfig"
ConfigurationSource = @("[ConfigurationRepositoryWeb]CONTOSO-PullSrv")
DependsOn = '[PartialConfiguration]ServiceAccountConfig'
}
}
Настройка LCM для конфигураций режима запросов с использованием ConfigurationID
[DSCLocalConfigurationManager()]
configuration PartialConfigDemoConfigID
{
Node localhost
{
Settings
{
RefreshMode = 'Pull'
ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
RefreshFrequencyMins = 30
RebootNodeIfNeeded = $true
}
ConfigurationRepositoryWeb CONTOSO-PullSrv
{
ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
}
PartialConfiguration ServiceAccountConfig
{
Description = 'Configuration for the Base OS'
ConfigurationSource = '[ConfigurationRepositoryWeb]CONTOSO-PullSrv'
RefreshMode = 'Pull'
}
PartialConfiguration SharePointConfig
{
Description = 'Configuration for the Sharepoint Server'
ConfigurationSource = '[ConfigurationRepositoryWeb]CONTOSO-PullSrv'
DependsOn = '[PartialConfiguration]ServiceAccountConfig'
RefreshMode = 'Pull'
}
}
}
PartialConfigDemo
Вы можете извлечь частичные конфигурации более чем из одного опрашивающего сервера — потребуется только определить каждый опрашивающий сервер, а затем сослаться на соответствующий опрашивающий сервер в каждом блоке PartialConfiguration.
После создания метаконфигурации необходимо запустить ее для создания документа конфигурации (MOF-файла), а затем вызвать командлет Set-DscLocalConfigurationManager для настройки LCM.
Именование и размещение документов конфигурации на опрашивающем сервере (ConfigurationNames)
Документы частичной конфигурации необходимо разместить в папке, указанной как ConfigurationPath, в файле web.config для опрашивающего сервера (обычно C:\Program Files\WindowsPowerShell\DscService\Configuration).
Именование документов конфигурации на опрашивающем сервере в PowerShell 5.1
Если вы запрашиваете только одну частичную конфигурацию на отдельном опрашивающем сервере, документ конфигурации может иметь любое имя. Если вы запрашиваете с опрашивающего сервера несколько частичных конфигураций, документ конфигурации можно назвать <ConfigurationName>.mof, где ConfigurationName — имя частичной конфигурации, или <ConfigurationName>.<NodeName>.mof, где ConfigurationName — имя частичной конфигурации, а NodeName — имя целевого узла. Это позволяет запрашивать конфигурации с опрашивающего сервера DSC службы автоматизации Azure.
Именование документов конфигурации на опрашивающем сервере в PowerShell 5.0
Документы конфигурации должны быть именованы следующим образом: ConfigurationName.mof, где ConfigurationName — имя частичной конфигурации. Например, документы конфигурации следует назвать следующим образом.
ServiceAccountConfig.mof
ServiceAccountConfig.mof.checksum
SharePointConfig.mof
SharePointConfig.mof.checksum
Именование и размещение документов конфигурации на опрашивающем сервере (ConfigurationID)
Документы частичной конфигурации необходимо разместить в папке, указанной как ConfigurationPath, в файле web.config для опрашивающего сервера (обычно C:\Program Files\WindowsPowerShell\DscService\Configuration). Документы конфигурации должны называться так: <ConfigurationName>.<ConfigurationID>.mof, где ConfigurationName — имя частичной конфигурации, а ConfigurationID — идентификатор конфигурации, заданным в LCM на целевом узле. Например, документы конфигурации следует назвать следующим образом.
ServiceAccountConfig.1d545e3b-60c3-47a0-bf65-5afc05182fd0.mof
ServiceAccountConfig.1d545e3b-60c3-47a0-bf65-5afc05182fd0.mof.checksum
SharePointConfig.1d545e3b-60c3-47a0-bf65-5afc05182fd0.mof
SharePointConfig.1d545e3b-60c3-47a0-bf65-5afc05182fd0.mof.checksum
Запуск частичных конфигураций с опрашивающего сервера
После настройки LCM на целевом узле, а также создания и именования документов на опрашивающем сервере целевой узел запросит частичные конфигурации, объединит их и будет применять результирующую конфигурацию с регулярными интервалами, заданными свойством RefreshFrequencyMins в LCM. Если требуется принудительное обновление, можно вызвать командлет Update-DscConfiguration , чтобы извлечь конфигурации и применить их.
Частичные конфигурации в смешанных режимах принудительной отправки и запросов
Кроме того, вы можете совместить режимы принудительной отправки и запросов для частичных конфигураций Это значит, что у вас может быть одна частичная конфигурация, запрашиваемая с опрашивающего сервера, тогда как для другой частичной конфигурации выполняется принудительная отправка. Укажите режим обновления для каждой частичной конфигурации, как описано в предыдущих разделах. Например, в следующей метаконфигурации описывается один и тот же пример с частичной конфигурацией ServiceAccountConfig в режиме запросов и частичной конфигурацией SharePointConfig в режиме принудительной отправки.
Смешанные режимы принудительной отправки и запросов с использованием ConfigurationNames
[DscLocalConfigurationManager()]
Configuration PartialConfigDemoConfigNames
{
Settings
{
RefreshFrequencyMins = 30;
RefreshMode = "PULL";
ConfigurationMode = "ApplyAndAutocorrect";
AllowModuleOverwrite = $true;
RebootNodeIfNeeded = $true;
ConfigurationModeFrequencyMins = 60;
}
ConfigurationRepositoryWeb CONTOSO-PullSrv
{
ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
RegistrationKey = 5b41f4e6-5e6d-45f5-8102-f2227468ef38
ConfigurationNames = @("ServiceAccountConfig", "SharePointConfig")
}
PartialConfiguration ServiceAccountConfig
{
Description = "ServiceAccountConfig"
ConfigurationSource = @("[ConfigurationRepositoryWeb]CONTOSO-PullSrv")
RefreshMode = 'Pull'
}
PartialConfiguration SharePointConfig
{
Description = "SharePointConfig"
DependsOn = '[PartialConfiguration]ServiceAccountConfig'
RefreshMode = 'Push'
}
}
Смешанные режимы принудительной отправки и запросов с использованием ConfigurationID
[DSCLocalConfigurationManager()]
configuration PartialConfigDemo
{
Node localhost
{
Settings
{
RefreshMode = 'Pull'
ConfigurationID = '1d545e3b-60c3-47a0-bf65-5afc05182fd0'
RefreshFrequencyMins = 30
RebootNodeIfNeeded = $true
}
ConfigurationRepositoryWeb CONTOSO-PullSrv
{
ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
}
PartialConfiguration ServiceAccountConfig
{
Description = 'Configuration for the Base OS'
ConfigurationSource = '[ConfigurationRepositoryWeb]CONTOSO-PullSrv'
RefreshMode = 'Pull'
}
PartialConfiguration SharePointConfig
{
Description = 'Configuration for the Sharepoint Server'
DependsOn = '[PartialConfiguration]ServiceAccountConfig'
RefreshMode = 'Push'
}
}
}
PartialConfigDemo
Обратите внимание, что режим RefreshMode, указанный в блоке "Параметры", — это "Режим запросов", а режим RefreshMode для частичной конфигурации SharePointConfig — "Режим принудительной отправки".
MOF-файлы конфигурации следует именовать и располагать в соответствии с их режимами обновления.
Вызовите Publish-DSCConfiguration, чтобы опубликовать частичную конфигурацию SharePointConfig, и дождитесь извлечения конфигурации ServiceAccountConfig из опрашивающего сервера или выполните принудительное обновление, вызвав Update-DscConfiguration.
Пример частичной конфигурации ServiceAccountConfig
Configuration ServiceAccountConfig
{
Param (
[Parameter(Mandatory,
HelpMessage="Domain credentials required to add domain\sharepoint_svc to the local Administrators group.")]
[ValidateNotNullOrEmpty()]
[pscredential]$Credential
)
Import-DscResource -ModuleName PSDesiredStateConfiguration
Node localhost
{
Group LocalAdmins
{
GroupName = 'Administrators'
MembersToInclude = 'domain\sharepoint_svc',
'admins@example.domain'
Ensure = 'Present'
Credential = $Credential
}
WindowsFeature Telnet
{
Name = 'Telnet-Server'
Ensure = 'Absent'
}
}
}
ServiceAccountConfig
Пример частичной конфигурации SharePointConfig
Configuration SharePointConfig
{
Param (
[Parameter(Mandatory)]
[ValidateNotNullOrEmpty()]
[pscredential]$ProductKey
)
Import-DscResource -ModuleName xSharePoint
Node localhost
{
xSPInstall SharePointDefault
{
Ensure = 'Present'
BinaryDir = '\\FileServer\Installers\Sharepoint\'
ProductKey = $ProductKey
}
}
}
SharePointConfig
