Publicar em um servidor de Pull usando IDs de configuração (v4/v5)
As seções a seguir pressupõem que você já tenha configurado um servidor de pull. Se ainda não configurou o servidor de pull, use os guias a seguir:
Cada nó de destino pode ser configurado para baixar configurações, recursos e até mesmo relatar seu status. Este artigo mostra como carregar recursos para que fiquem disponíveis para download e como configurar clientes para baixar automaticamente os recursos. Quando o nó recebe uma configuração atribuída, por meio de Pull ou Push (v5), ele baixa automaticamente todos os recursos necessários para a configuração do local especificado no LCM (Local Configuration Manager).
Compilar configurações
A primeira etapa para armazenar Configurações em um servidor de pull é compilá-las em arquivos .mof
. Para tornar uma configuração genérica e aplicável a mais clientes, use localhost
em seu bloco de nós. O exemplo a seguir mostra um shell de configuração que usa localhost
em vez de um nome de cliente específico.
Configuration GenericConfig
{
Node localhost
{
}
}
GenericConfig
Depois de compilar sua configuração genérica, você deve ter um arquivo localhost.mof
.
Renomeando o arquivo MOF
Você pode armazenar arquivos de configuração .mof
em um servidor de pull por ConfigurationName ou ConfigurationID. Dependendo de como você planeja configurar os clientes de pull, é possível escolher uma seção abaixo para renomear corretamente seus arquivos .mof
compilados.
IDs de configuração (GUID)
Você precisará renomear o arquivo localhost.mof
como o arquivo <GUID>.mof
. Você pode criar um Guid aleatório usando o exemplo abaixo ou usando o cmdlet New-Guid.
[System.Guid]::NewGuid()
Saída de exemplo
Guid
----
64856475-939e-41fb-aba5-4469f4006059
Em seguida, você pode renomear o arquivo .mof
usando qualquer método aceitável. O exemplo a seguir usa o cmdlet Rename-Item.
Rename-Item -Path .\localhost.mof -NewName '64856475-939e-41fb-aba5-4469f4006059.mof'
Para obter mais informações sobre o uso de Guids em seu ambiente, confira Plan for Guids (Planejar-se para usar Guids).
Nomes de configuração
Você precisará renomear o arquivo localhost.mof
como o arquivo <Configuration Name>.mof
. No exemplo a seguir, é usado o nome da configuração da seção anterior. Em seguida, você pode renomear o arquivo .mof
usando qualquer método aceitável. O exemplo a seguir usa o cmdlet Rename-Item.
Rename-Item -Path .\localhost.mof -NewName 'GenericConfig.mof'
Criar a soma de verificação
Cada arquivo .mof
armazenado em um servidor de pull ou compartilhamento SMB precisa ter um arquivo .checksum
associado.
Esse arquivo permite que os clientes saibam quando o arquivo .mof
associado foi alterado e deve ser baixado novamente.
Você pode criar um CheckSum com o cmdlet New-DSCCheckSum. Também pode executar New-DSCCheckSum
em um diretório de arquivos usando o parâmetro -Path
.
Se já existir uma soma de verificação, é possível forçá-la a ser criada novamente com o parâmetro -Force
. O exemplo a seguir especificou um diretório que contém o arquivo .mof
da seção anterior e usa o parâmetro -Force
.
New-DscChecksum -Path '.\' -Force
Nenhuma saída será exibida, mas agora você deve ver um arquivo <GUID or Configuration Name>.mof.checksum
.
Onde armazenar os arquivos MOF e as somas de verificação
Em um servidor de pull HTTP de DSC
Ao configurar seu servidor de Pull HTTP, conforme explicado em Configurar um servidor de pull HTTP de DSC, você especifica diretórios para as chaves ModulePath e ConfigurationPath. A chave ModulePath indica onde os arquivos .zip
empacotados de um módulo devem ser armazenados. O ConfigurationPath indica onde os arquivos .mof
e .checksum
devem ser armazenados.
xDscWebService PSDSCPullServer
{
...
ModulePath = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Modules"
ConfigurationPath = "$env:PROGRAMFILES\WindowsPowerShell\DscService\Configuration"
...
}
Em um compartilhamento SMB
Quando você configurar um cliente de pull para usar um compartilhamento SMB, especifique um ConfigurationRepositoryShare.
Todos os arquivos .mof
e .checksum
devem ser armazenados no diretório SourcePath do bloco ConfigurationRepositoryShare.
ConfigurationRepositoryShare SMBPullServer
{
SourcePath = '\\SMBPullServer\Pull'
}
Próximas etapas
Em seguida, configure clientes de pull para extrair a configuração especificada. Para saber mais, confira um dos guias a seguir:
- Configurar um cliente de pull usando IDs de configuração (v4)
- Configurar um cliente de pull usando IDs de configuração (v5)
- Configurar um cliente de pull usando Nomes de configuração (v5)