Installera ytterligare DSC-resurserInstall Additional DSC Resources

PowerShell innehåller flera färdiga resurser för önskad tillstånds konfiguration (DSC).PowerShell includes several Out-of-the-box resources for Desired State Configuration (DSC). PSDesiredStateConfiguration -modulen innehåller alla OOB DSC-resurser som är tillgängliga på din speciella instans av PowerShell.The PSDesiredStateConfiguration module contains all of the OOB DSC resources available on your specific instance of PowerShell.

Det här är en lista över OOB-resurser som ingår i PowerShell 4,0 och en beskrivning av resursens funktioner.This is a list of the OOB resources included in PowerShell 4.0 and a description of the resource's capabilities.

Anteckning

Det här är en ofullständig lista eftersom antalet OOB-resurser har växt med varje version av PowerShell.This is an incomplete list, as the number of OOB resources has grown with each version of PowerShell.

ResursResource BeskrivningDescription
FilFile Styr tillstånd för filer och kataloger.Controls the state of files and directories. Kopierar filer från en källa till ett mål och uppdaterar dem när källan ändras genom att jämföra datum, kontroll summor och hash-värden.Copies files from a Source to a Destination and updates them when the Source changes by comparing dates, checksums, and hashes.
ArkivArchive Packar upp arkiv och en angiven plats.Unpacks archives and a specified location. Validerar arkiven med en angiven kontroll Summa .Validates the archives with a specified Checksum .
MiljöEnvironment Hanterar miljövariabler.Manages environment variables.
GrupperGroup Hanterar medlemskap i lokala grupper och kontroll grupper.Manages local groups and controls group membership.
KvorumloggenLog Skriver meddelanden till Microsoft-Windows-Desired State Configuration/Analytic händelse loggen.Writes messages to the Microsoft-Windows-Desired State Configuration/Analytic event log.
PaketPackage Installerar eller avinstallerar paket med argument , LogPath , ReturnCode , andra inställningar.Installs or uninstalls packages using Arguments , LogPath , ReturnCode , other settings.
RegisterRegistry Hanterar register nycklar och värden.Manages registry keys and values.
ÖverScript Gör att du kan skapa egna skript block för Get-test-uppsättning .Allows you to design your own get-test-set script blocks.
TjänstService Konfigurerar Windows-tjänster.Configures Windows services.
AnvändareUser Hanterar lokala användare och attribut.Manages local users and attributes.
WindowsFeatureWindowsFeature Hanterar roller och funktioner.Manages roles and features.
WindowsProcessWindowsProcess Konfigurerar Windows-processer.Configures Windows processes.

OOB-resurserna gör det möjligt att använda en lämplig start punkt för vanliga åtgärder.The OOB resources allow a good starting point for common operations. Om OOB-resurserna inte uppfyller dina behov kan du skriva en egen anpassad resurs.If the OOB resources do not meet your needs, you can write your own Custom Resource. Innan du skriver en anpassad resurs för att lösa problemet bör du titta igenom det stora antalet DSC-resurser som redan har skapats av både Microsoft och PowerShell-communityn.Before you write a custom resource to solve your problem, you should look through the vast number of DSC resources that have already been created by both Microsoft and the PowerShell community.

Du hittar DSC-resurser i både PowerShell-galleriet -och GitHub.You can find DSC resources in both the PowerShell Gallery and GitHub. Du kan också installera DSC-resurser direkt från PowerShell-konsolen med hjälp av PowerShellGet.You can also install DSC resources directly from the PowerShell console using PowerShellGet.

Installera PowerShellGetInstalling PowerShellGet

Om du vill kontrol lera om du redan har PowerShell , eller om du vill ha hjälp med att installera den, kan du läsa följande guide: installerar PowerShellGet.To determine if you already have PowerShell get, or to get help installing it, see the following guide: Installing PowerShellGet.

Hitta DSC-resurser med PowerShellGetFinding DSC resources using PowerShellGet

När PowerShellGet har installerats på systemet kan du söka efter och installera DSC-resurser som finns i PowerShell-galleriet.Once PowerShellGet is installed on your system, you can find and install DSC resources hosted in the PowerShell Gallery.

Använd först cmdleten find-dscresource Keyword Supports för att hitta DSC-resurser.First, use the Find-DSCResource cmdlet to find DSC resources. När du kör Find-DSCResource för första gången visas följande prompt för att installera "NuGet Provider".When you run Find-DSCResource for the first time, you see the following prompt to install the "NuGet provider".

PS> Find-DSCResource

NuGet provider is required to continue
PowerShellGet requires NuGet provider version '2.8.5.201' or newer to interact with NuGet-based
repositories. The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies'
or 'C:\Users\xAdministrator\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install
the NuGet provider by running 'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201
-Force'. Do you want PowerShellGet to install and import the NuGet provider now?
[Y] Yes  [N] No  [?] Help (default is "Y"):

När du har tryckt på "y" installeras "NuGet"-providern. du ser en lista över DSC-resurser som du kan installera från PowerShell-galleriet.After pressing 'y', the "NuGet" provider is installed, you see a list of DSC resources that you can install from the PowerShell Gallery.

Anteckning

Listan visas inte eftersom den är mycket stor.List is not shown because it is very large.

Du kan också ange -Name parametern med jokertecken eller -Filter parameter utan jokertecken för att begränsa sökningen.You can also specify the -Name parameter using wildcards, or -Filter parameter without wildcards to narrow down your search. Det här exemplet försöker hitta en "TimeZone" DSC-resurs med hjälp av jokertecken.This example attempts to find a "TimeZone" DSC resource using the wildcards.

Viktigt

För närvarande finns det ett fel i Find-DSCResource cmdleten som förhindrar att jokertecken används i -Name både -Filter parametrarna och.Currently there is a bug in the Find-DSCResource cmdlet that prevents using wildcards in both the -Name and -Filter parameters. I det andra exemplet nedan visas en lösning med Where-Object .The second example below shows a workaround using Where-Object.

PS> Find-DSCResource -Name *Time*

Name                                Version    ModuleName                          Repository
----                                -------    ----------                          ----------
Carbon_EnvironmentVariable          2.6.0      Carbon                              PSGallery
Carbon_FirewallRule                 2.6.0      Carbon                              PSGallery
Carbon_Group                        2.6.0      Carbon                              PSGallery
Carbon_IniFile                      2.6.0      Carbon                              PSGallery
Carbon_Permission                   2.6.0      Carbon                              PSGallery
Carbon_Privilege                    2.6.0      Carbon                              PSGallery
Carbon_ScheduledTask                2.6.0      Carbon                              PSGallery
Carbon_Service                      2.6.0      Carbon                              PSGallery
TimeZone                            6.0.0.0    ComputerManagementDsc               PSGallery
xTimeZone                           1.8.0.0    xTimeZone                           PSGallery
xSqlServerDefaultDir                1.0.0      mlSqlServerDSC                      PSGallery
xSqlServerMoveDatabaseFiles         1.0.0      mlSqlServerDSC                      PSGallery
xSqlServerSQLDataRoot               1.0.0      mlSqlServerDSC                      PSGallery
xSqlServerStartupParam              1.0.0      mlSqlServerDSC                      PSGallery

Du kan också använda Where-Object för att hitta DSC-resurser med mer detaljerad filtrering.You can also use Where-Object to find DSC resources with more granular filtering. Den här metoden går långsammare än att använda inbyggda filtrerings parametrar.This approach will be slower than using built in filtering parameters.

PS> Find-DSCResource | Where-Object {$_.Name -like "Time*"}

Name                                Version    ModuleName                          Repository
----                                -------    ----------                          ----------
TimeZone                            6.0.0.0    ComputerManagementDsc               PSGallery

Mer information om filtrering finns i Where-Object.For more information on filtering, see Where-Object.

Installera DSC-resurser med PowerShellGetInstalling DSC Resources using PowerShellGet

Om du vill installera en DSC-resurs använder du cmdleten install-module och anger namnet på modulen som visas under Modulnamn i Sök resultatet.To install a DSC resource, use the Install-Module cmdlet, specifying the name of the module shown under Module name in your search results.

"TimeZone"-resursen finns i modulen "ComputerManagementDSC", så att är den modul som det här exemplet installerar.The "TimeZone" resource exists in the "ComputerManagementDSC" module, so that is the module this example installs.

Anteckning

Om du inte har betrott PowerShell-galleriet ser du varningen nedan och ber om bekräftelse och instruerar dig att undvika efterföljande frågor om installationer.If you have not trusted the PowerShell gallery, you see the warning below asking for confirmation, and instructing you how to avoid subsequent prompts on installs.

PS> Install-Module -Name ComputerManagementDSC

Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to
install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Tryck på "y" för att fortsätta installera modulen.Press 'y' to continue installing the module. Efter installationen kan du kontrol lera att den nya resursen är installerad med hjälp av Get-dscresource Keyword Supports.After install, you can verify that your new resource is installed using Get-DSCResource.

PS> Get-DSCResource -Name TimeZone -Syntax

TimeZone [String] #ResourceName
{
    IsSingleInstance = [string]{ Yes }
    TimeZone = [string]
    [DependsOn = [string[]]]
    [PsDscRunAsCredential = [PSCredential]]
}

Du kan också visa andra resurser i den nyligen installerade modulen genom att ange -ModuleName parametern.You can also view other resources in your newly installed module, by specifying the -ModuleName parameter.

PS> Get-DSCResource -Module ComputerManagementDSC

ImplementedAs   Name                      ModuleName                     Version    Properties
-------------   ----                      ----------                     -------    ----------
PowerShell      Computer                  ComputerManagementDsc          6.0.0.0    {Name, Credential, DependsOn, ...
PowerShell      OfflineDomainJoin         ComputerManagementDsc          6.0.0.0    {IsSingleInstance, RequestFile...
PowerShell      PowerPlan                 ComputerManagementDsc          6.0.0.0    {IsSingleInstance, Name, Depen...
PowerShell      PowerShellExecutionPolicy ComputerManagementDsc          6.0.0.0    {ExecutionPolicy, ExecutionPol...
PowerShell      ScheduledTask             ComputerManagementDsc          6.0.0.0    {TaskName, ActionArguments, Ac...
PowerShell      TimeZone                  ComputerManagementDsc          6.0.0.0    {IsSingleInstance, TimeZone, D...
PowerShell      VirtualMemory             ComputerManagementDsc          6.0.0.0    {Drive, Type, DependsOn, Initi...

Se ävenSee also