Condividi tramite

Configurare un client di pull usando i nomi di configurazione in PowerShell 5.0 e versioni successive

Si applica a: Windows PowerShell 5.0

Importante

Il server di pull ( funzionalità Windows DSC-Service) è un componente supportato di Windows Server, tuttavia non è prevista l'offerta di nuove funzionalità o funzionalità. Si desidera che si sappia che è ora disponibile a livello generale una versione più recente di DSC, gestita da una funzionalità di Criteri di Azure denominata configurazione guest. Il servizio di configurazione guest combina le funzionalità dell'estensione DSC, la configurazione dello stato di Automazione di Azure e le funzionalità più comunemente richieste dal feedback dei clienti. La configurazione guest include anche il supporto di macchine ibride tramite server abilitati per Arc.

Prima di configurare un client di pull, è necessario configurare un server di pull. Anche se questo ordine non è obbligatorio, aiuta con la risoluzione dei problemi e ti aiuta a garantire che la registrazione sia andata a buon fine. Per configurare un server di pull, è possibile utilizzare le guide seguenti:

Ogni nodo di destinazione può essere configurato per scaricare configurazioni, risorse e persino segnalare il proprio stato. Le sezioni seguenti illustrano come configurare un client di pull con una condivisione SMB o un server di pull DSC HTTP. Quando la Gestione configurazione locale del nodo viene aggiornata, raggiungerà la posizione configurata per scaricare le configurazioni assegnate. Se sul nodo non sono presenti risorse necessarie, verranno scaricate automaticamente dalla posizione configurata. Se il nodo è configurato con un server di report, verrà segnalato lo stato dell'operazione.

Annotazioni

Questo argomento si applica a PowerShell 5.0. Per informazioni sulla configurazione di un client di pull in PowerShell 4.0, vedere Configurare un client di pull usando l'ID di configurazione in PowerShell 4.0.

Configurare la gestione LCM del client di pull

L'esecuzione di uno degli esempi seguenti crea una nuova cartella di output denominata PullClientConfigName e vi inserisce un file MOF di metaconfigurazione. In questo caso, il file MOF di metaconfigurazione sarà denominato localhost.meta.mof.

Per applicare la configurazione, chiamare il cmdlet Set-DscLocalConfigurationManager , con il percorso impostato sul percorso del file MOF di metaconfigurazione. Per esempio:

Set-DSCLocalConfigurationManager –ComputerName localhost –Path .\PullClientConfigName –Verbose.

Nome della configurazione

Negli esempi seguenti la proprietà ConfigurationName di Gestione configurazione locale viene impostata sul nome di una configurazione compilata in precedenza, creata a tale scopo. ConfigurationName è ciò che LCM utilizza per trovare la configurazione appropriata sul server di pull. Il file MOF di configurazione nel server di pull deve essere denominato <ConfigurationName>.mof, in questo caso, "ClientConfig.mof". Per ulteriori informazioni, vedere Pubblicazione di configurazioni in un server di pull (v4/v5).

Configurare un client di pull per scaricare le configurazioni

Ogni client deve essere configurato in modalità Pull e deve essere fornito l'URL del server di pull in cui è memorizzata la configurazione. A tale scopo, è necessario configurare Gestione configurazione locale (LCM) con le informazioni necessarie. Per configurare Gestione configurazione locale, è necessario creare un tipo speciale di configurazione, decorato con l'attributo DSCLocalConfigurationManager . Per ulteriori informazioni sulla configurazione di Gestione configurazione locale, vedere Configurazione di Gestione configurazione locale.

Lo script seguente configura Gestione configurazione locale per il pull delle configurazioni da un server denominato "CONTOSO-PullSrv".

  • Nello script, il blocco ConfigurationRepositoryWeb definisce il server di pull. La proprietà ServerURL consente di specificare l'endpoint per il server di pull.

  • La proprietà RegistrationKey è una chiave condivisa tra tutti i nodi client per un server di pull e tale server di pull. Lo stesso valore viene archiviato in un file nel server di pull.

    Annotazioni

    Le chiavi di registrazione funzionano solo con i server di pull Web . È comunque necessario utilizzare ConfigurationID con un server di pull SMB . > Per informazioni sulla configurazione di un server di pull tramite ConfigurationID, vedere Configurazione di un client di pull tramite l'ID di configurazione

  • La proprietà ConfigurationNames è una matrice che specifica i nomi delle configurazioni destinate al nodo client. > Nota: Se si specificano più valori in ConfigurationNames, è necessario specificare anche i blocchi PartialConfiguration nella configurazione. >Per informazioni sulle configurazioni parziali, vedere Configurazioni parziali di PowerShell Desired State Configuration.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }
        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = '140a952b-b9d6-406b-b416-e0f759c9c0e4'
            ConfigurationNames = @('ClientConfig')
        }
    }
}
PullClientConfigNames

Configurare un client di pull per scaricare le risorse

Se si specifica solo un blocco ConfigurationRepositoryWeb o ConfigurationRepositoryShare nella configurazione LCM (come nell'esempio precedente), il client di pull estrarrà le risorse dalla stessa posizione in cui sono archiviati i file ".mof". È inoltre possibile specificare posizioni diverse in cui i client possono scaricare le risorse. Per specificare un server di risorse, è possibile utilizzare un blocco ResourceRepositoryWeb (per un server di pull Web) o un blocco ResourceRepositoryShare (per un server di pull SMB).

Nell'esempio seguente viene illustrata una metaconfigurazione che configura un client per scaricare le configurazioni da un server di pull e le risorse da una condivisione SMB.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ResourceRepositoryShare SMBResources
        {
            SourcePath = '\\SMBPullServer\Resources'
        }
    }
}
PullClientConfigNames

Configurare un client di pull per segnalare lo stato

È possibile utilizzare un singolo server di pull per le configurazioni, le risorse e la creazione di report. Per impostazione predefinita, la creazione di report non è configurata per i client. Per configurare un client per segnalare lo stato, è necessario creare un blocco ReportRepositoryWeb . Nell'esempio seguente viene illustrata una metaconfigurazione che consente a un client di eseguire il pull di configurazioni e risorse e di inviare i dati di report a un singolo server di pull.

Annotazioni

Un server di report non può essere una condivisione SMB.

[DSCLocalConfigurationManager()]
configuration PullClientConfigNames
{
    Node localhost
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
        }

        ConfigurationRepositoryWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }

        ReportServerWeb CONTOSO-PullSrv
        {
            ServerURL = 'https://CONTOSO-PullSrv:8080/PSDSCPullServer.svc'
            RegistrationKey = 'fbc6ef09-ad98-4aad-a062-92b0e0327562'
        }
    }
}
PullClientConfigNames

Vedere anche

  • Last updated on