Konfigurera en DSC SMB-hämtningsserver

Gäller för: Windows PowerShell 4.0, Windows PowerShell 5.0

En DSC SMB-hämtningsserver är en dator som är värd för SMB-filresurser som gör DSC-konfigurationsfiler och DSC-resurser tillgängliga för målnoder när dessa noder ber om dem.

Om du vill använda en SMB-hämtningsserver för DSC måste du:

• Konfigurera en SMB-filresurs på en server som kör PowerShell 4.0 eller senare
• Konfigurera en klient som kör PowerShell 4.0 eller senare för att hämta från den SMB-resursen

Använda xSmbShare-resursen för att skapa en SMB-filresurs

Det finns ett antal sätt att konfigurera en SMB-filresurs, men vi ska titta på hur du kan göra detta med hjälp av DSC.

Installera xSmbShare-resursen

Anropa cmdleten Install-Module för att installera xSmbShare-modulen .

Skapa katalogen och filresursen

Följande konfiguration använder filresursen för att skapa katalogen för resursen och xSmbShare-resursen för att konfigurera SMB-resursen:

Configuration SmbShare
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Import-DscResource -ModuleName xSmbShare

    Node localhost
    {

        File CreateFolder
        {
            DestinationPath = 'C:\DscSmbShare'
            Type = 'Directory'
            Ensure = 'Present'
        }

        xSMBShare CreateShare
        {
            Name = 'DscSmbShare'
            Path = 'C:\DscSmbShare'
            FullAccess = 'administrator'
            ReadAccess = 'myDomain\Contoso-Server$'
            FolderEnumerationMode = 'AccessBased'
            Ensure = 'Present'
            DependsOn = '[File]CreateFolder'
        }
    }
}

Konfigurationen skapar katalogen C:\DscSmbShare, om den inte redan finns och använder sedan den katalogen som en SMB-filresurs. FullAccess ska ges till alla konton som behöver skriva till eller ta bort från filresursen. ReadAccess måste ges till alla klientnoder som hämtar konfigurationer och/eller DSC-resurser från resursen.

Ge filsystemet åtkomst till pull-klienten

Genom att ge ReadAccess till en klientnod kan noden komma åt SMB-resursen, men inte till filer eller mappar i resursen. Du måste uttryckligen bevilja klientnoder åtkomst till SMB-resursmappen och undermapparna. Vi kan göra detta med DSC genom att lägga till med hjälp av resursen cNtfsPermissionEntry , som finns i CNtfsAccessControl-modulen . Följande konfiguration lägger till ett cNtfsPermissionEntry-block som ger ReadAndExecute åtkomst till pull-klienten:

Configuration DSCSMB
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Import-DscResource -ModuleName xSmbShare
    Import-DscResource -ModuleName cNtfsAccessControl

    Node localhost
    {

        File CreateFolder
        {
            DestinationPath = 'C:\DscSmbShare'
            Type = 'Directory'
            Ensure = 'Present'
        }

        xSMBShare CreateShare
        {
            Name = 'DscSmbShare'
            Path = 'C:\DscSmbShare'
            FullAccess = 'administrator'
            ReadAccess = 'myDomain\Contoso-Server$'
            FolderEnumerationMode = 'AccessBased'
            Ensure = 'Present'
            DependsOn = '[File]CreateFolder'
        }

        cNtfsPermissionEntry PermissionSet1
        {
            Ensure = 'Present'
            Path = 'C:\DscSmbShare'
            Principal = 'myDomain\Contoso-Server$'
            AccessControlInformation = @(
                cNtfsAccessControlInformation
                {
                    AccessControlType = 'Allow'
                    FileSystemRights = 'ReadAndExecute'
                    Inheritance = 'ThisFolderSubfoldersAndFiles'
                    NoPropagateInherit = $false
                }
            )
            DependsOn = '[File]CreateFolder'
        }
    }
}

Placera konfigurationer och resurser

Spara eventuella MOF-konfigurationsfiler och/eller DSC-resurser som du vill att klientnoder ska hämta i SMB-resursmappen.

Alla MOF-konfigurationsfiler måste ha namnet <ConfigurationID>.mof, där <ConfigurationID> är värdet för egenskapen ConfigurationID för målnodens LCM. Mer information om hur du konfigurerar pull-klienter finns i Konfigurera en pull-klient med hjälp av konfigurations-ID.

Varje resursmodul måste zippas och namnges enligt följande mönster {Module Name}_{Module Version}.zip. En modul med namnet xWebAdminstration med modulversionen 3.1.2.0 skulle till exempel ha namnet xWebAdministration_3.2.1.0.zip. Varje version av en modul måste finnas i en enda zip-fil. Separata versioner av en modul i en zip-fil stöds inte. Innan du paketerar DSC-resursmoduler för användning med hämtningsservern måste du göra en liten ändring i katalogstrukturen.

Standardformatet för moduler som innehåller DSC-resursen i WMF 5.0 är {Module Folder}\{Module Version}\DscResources\{DSC Resource Folder}\.

Innan du paketerar för hämtningsservern tar du helt enkelt bort {Module version} mappen så att sökvägen blir {Module Folder}\DscResources\{DSC Resource Folder}\. Med den här ändringen zippar du mappen enligt beskrivningen ovan och placerar zip-filerna i SMB-resursmappen.

Skapa MOF-kontrollsumman

En MOF-konfigurationsfil måste parkopplas med en kontrollsummafil så att en LCM på en målnod kan verifiera konfigurationen. Om du vill skapa en kontrollsumma anropar du cmdleten New-DSCCheckSum . Cmdleten tar en Path parameter som anger mappen där MOF-konfigurationen finns. Cmdleten skapar en checksum-fil med namnet ConfigurationMOFName.mof.checksum, där ConfigurationMOFName är namnet på konfigurationsfilen mof. Om det finns fler än en MOF-konfigurationsfil i den angivna mappen skapas en kontrollsumma för varje konfiguration i mappen.

Kontrollsummafilen måste finnas i samma katalog som MOF-konfigurationsfilen ($env:PROGRAMFILES\WindowsPowerShell\DscService\Configuration som standard) och ha samma namn som .checksum tillägget.

Konfigurera en pull-klient för SMB

Om du vill konfigurera en klient som hämtar konfigurationer och/eller resurser från en SMB-resurs konfigurerar du klientens lokala Configuration Manager (LCM) med ConfigurationRepositoryShare- och ResourceRepositoryShare-block som anger från vilken resurs du vill hämta konfigurationer och DSC-resurser.

Mer information om hur du konfigurerar LCM finns i Konfigurera en pull-klient med hjälp av konfigurations-ID.

$secpasswd = ConvertTo-SecureString "Pass1Word" -AsPlainText -Force
$mycreds = New-Object System.Management.Automation.PSCredential ("TestUser", $secpasswd)

[DSCLocalConfigurationManager()]
configuration SmbCredTest
{
    Node $AllNodes.NodeName
    {
        Settings
        {
            RefreshMode = 'Pull'
            RefreshFrequencyMins = 30
            RebootNodeIfNeeded = $true
            ConfigurationID    = '16db7357-9083-4806-a80c-ebbaf4acd6c1'
        }

         ConfigurationRepositoryShare SmbConfigShare
        {
            SourcePath = '\\WIN-E0TRU6U11B1\DscSmbShare'
            Credential = $mycreds
        }

        ResourceRepositoryShare SmbResourceShare
        {
            SourcePath = '\\WIN-E0TRU6U11B1\DscSmbShare'
            Credential = $mycreds

        }
    }
}

$ConfigurationData = @{
    AllNodes = @(
        @{
            #the "*" means "all nodes named in ConfigData" so we don't have to repeat ourselves
            NodeName="localhost"
            PSDscAllowPlainTextPassword = $true
        })
}

Erkännanden

Särskilt tack till följande individer:

• Mike F. Robbins, vars inlägg om att använda SMB för DSC hjälpte till att informera innehållet i det här ämnet. Hans blogg är på Mike F Robbins.
• Serge Nikalaichyk, som skapade modulen cNtfsAccessControl . Källan för den här modulen finns på cNtfsAccessControl.

Se även

översikt över Windows PowerShell Desired State Configuration

Tillämpa konfigurationer

Konfigurera en pullklient med konfigurations-ID