Zasób DSC PackageManagementSource

Dotyczy: Windows PowerShell 4.0, Windows PowerShell 5.x

Zasób PackageManagementSource w Windows PowerShell Desired State Configuration (DSC) udostępnia mechanizm rejestrowania lub wyrejestrowania źródeł zarządzania pakietami w węźle docelowym. Źródła zarządzania pakietami zarejestrowane w ten sposób są rejestrowane w kontekście systemowym, używane przez konto systemowe lub aparat DSC. Ten zasób wymaga modułu PackageManagement dostępnego w Galeria programu PowerShell.

Ważne

Moduł PackageManagement powinien być co najmniej w wersji 1.1.7.0, aby następujące informacje o właściwościach było poprawne.

Uwaga

Ta dokumentacja tego zasobu DSC obejmuje wersję dołączoną do programu PowerShell w wersji 7.2. Moduł PSDscResources zawiera nowe i zaktualizowane zasoby DSC, które są oficjalnie obsługiwane przez firmę Microsoft. Moduł PSDscResources jest dostępny w Galeria programu PowerShell.

Aby uzyskać więcej informacji i zaktualizować dokumentację, zobacz dokumentację referencyjną usługi PSDscResources.

Składnia

PackageManagementSource [String] #ResourceName
{
    Name = [string]
    ProviderName = [string]
    SourceLocation = [string]
    [ InstallationPolicy = [string]{ Trusted | Untrusted } ]
    [ SourceCredential = [PSCredential] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string]{ Absent | Present } ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Właściwości

Właściwość	Opis
Nazwa	Określa nazwę źródła pakietu do zarejestrowania lub wyrejestrowania w systemie.
ProviderName	Określa nazwę dostawcy OneGet, za pomocą którego można współdziałać ze źródłem pakietu.
Sourcelocation	Określa identyfikator URI źródła pakietu.
InstalacjaZasady	Używane przez dostawców, takich jak wbudowany dostawca Nuget. Określa, czy ufasz źródle pakietu. Jeden z: niezaufany lub zaufany.
SourceCredential	Zapewnia dostęp do pakietu w źródle zdalnym.

Wspólne właściwości

Właściwość	Opis
Dependson	Wskazuje, że konfiguracja innego zasobu musi zostać uruchomiona przed skonfigurowaniem tego zasobu. Jeśli na przykład identyfikator bloku skryptu konfiguracji zasobu, który chcesz uruchomić jako pierwszy, to ResourceName, a jego typ to ResourceType, składnia użycia tej właściwości to DependsOn = "[ResourceType]ResourceName".
Zapewnić	Określa, czy źródło pakietu ma być zarejestrowane, czy niezarejestrowane. Wartość domyślna to Obecny.
PsDscRunAsCredential	Ustawia poświadczenie na potrzeby uruchamiania całego zasobu jako.

Uwaga

Właściwość pospolita PsDscRunAsCredential została dodana w programie WMF 5.0, aby umożliwić uruchamianie dowolnego zasobu DSC w kontekście innych poświadczeń. Aby uzyskać więcej informacji, zobacz Use Credentials with DSC Resources (Używanie poświadczeń z zasobami DSC).

Przykład

W tym przykładzie https://nuget.org źródło pakietu jest rejestrowane przy użyciu zasobu PackageManagementSource DSC.

Configuration PackageManagementSourceTest
{
    Import-DscResource -ModuleName 'PackageManagement'

    PackageManagementSource SourceRepository
    {
        Ensure      = "Present"
        Name        = "MyNuget"
        ProviderName= "Nuget"
        SourceLocation   = "https://api.nuget.org/api/v3/"
        InstallationPolicy ="Trusted"
    }
}