about_PSResourceGet

Artykuł
10/31/2024

Krótki opis

Opisuje sposób używania wersji 1.1.0-rc1 modułu Microsoft.PowerShell.PSResourceGet.

Długi opis

Microsoft.PowerShell.PSResourceGet to zaktualizowana wersja modułu PowerShellGet całkowicie napisana w języku C#.

Ta wersja modułu PowerShellGet koncentruje się na kilku kluczowych obszarach:

Upraszczanie bazy kodu, co ułatwia ulepszanie i naprawianie usterek
Usuń zależność od modułu PackageManagement i użyj bezpośrednio biblioteki NuGet
Rozwiązywanie długotrwałych problemów z użytecznością, które mogłyby spowodować niezgodność zmian z wersji 2
Zachowaj zgodność istniejących skryptów napisanych w wersji 2 za pomocą oddzielnego modułu zgodności
Zwiększanie wydajności wyszukiwania i instalacji

Zmiany projektu

Poprzednie wersje powerShellGet miały oddzielne polecenia do pracy z modułami i skryptami. W Microsoft.PowerShell.PSResourceGetwszystkie pakiety w galerii programu PowerShell są definiowane jako obiekty PSResource.

W poniższej tabeli przedstawiono polecenia cmdlet, które są dostępne w PowerShellGet v3 i ich odpowiedniki w wersji 2.

Microsoft.PowerShell.PSResourceGet	PowerShellGet, wersja 2
`Compress-PSResource`	N/a
`Find-PSResource`	`Find-Command`
`Find-PSResource`	`Find-DscResource`
`Find-PSResource`	`Find-Module`
`Find-PSResource`	`Find-Script`
N/a	`Find-RoleCapability`
`Get-InstalledPSResource`	`Get-InstalledModule`
`Get-InstalledPSResource`	`Get-InstalledScript`
`Get-PSResourceRepository`	`Get-PSRepository`
`Get-PSScriptFileInfo`	N/a
`Import-PSGetRepository`	N/a
`Install-PSResource`	`Install-Module`
`Install-PSResource`	`Install-Script`
`New-PSScriptFileInfo`	`New-ScriptFileInfo`
`Publish-PSResource`	`Publish-Module`
`Publish-PSResource`	`Publish-Script`
`Register-PSResourceRepository`	`Register-PSRepository`
`Save-PSResource`	`Save-Module`
`Save-PSResource`	`Save-Script`
`Set-PSResourceRepository`	`Set-PSRepository`
`Test-PSScriptFileInfo`	`Test-ScriptFileInfo`
`Uninstall-PSResource`	`Uninstall-Module`
`Uninstall-PSResource`	`Uninstall-Script`
`Unregister-PSResourceRepository`	`Unregister-PSRepository`
`Update-PSModuleManifest`	`Update-ModuleManifest`
`Update-PSResource`	`Update-Module`
`Update-PSResource`	`Update-Script`
`Update-PSScriptFileInfo`	`Update-ScriptFileInfo`

Wyszukiwanie według zakresów wersji narzędzia NuGet

Kilka poleceń cmdlet Microsoft.PowerShell.PSResourceGet udostępnia Version parametr, który umożliwia określenie zakresu wersji do wyszukania. Parametr Version używa składni przechowywania wersji NuGet. Aby uzyskać więcej informacji na temat zakresów wersji pakietu NuGet, zobacz Package versioning.

Moduł PowerShellGet obsługuje wszystkie elementy, ale minimalną wersję inkluzywną wymienioną w dokumentacji zakresu wersji NuGet. Użycie 1.0.0.0 jako wersji nie daje wersji 1.0.0.0 i wyższych (minimalny zakres włącznie). Zamiast tego wartość jest uważana za wymaganą wersję. Aby wyszukać minimalny zakres inkluzywny, użyj [1.0.0.0, ] jako zakresu wersji.

Wyszukiwanie według wymaganych zasobów

Polecenie cmdlet Install-PSResource ma parametry RequiredResource i RequiredResourceFile używane do znajdowania obiektów PSResource pasujących do określonych kryteriów. Kryteria wyszukiwania można określić przy użyciu tabeli skrótu lub obiektu JSON. Dla parametru RequiredResourceFile wartość skrótu jest przechowywana w pliku .psd1, a obiekt JSON jest przechowywany w pliku .json.

Tabela skrótów może zawierać atrybuty dla wielu modułów. W poniższym przykładzie pokazano strukturę specyfikacji modułu:

@{
    <modulename> = @{
        version = '<version-spcification>'
        repository = '<reponame>'
        prerelease = '<boolean>'
    }
}

Ten przykład zawiera specyfikacje trzech modułów. Jak to możliwe, atrybuty modułu są opcjonalne.

 @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
    }

    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = $true
    }

    TestModule99 = @{}
}

W następnym przykładzie pokazano tę samą specyfikację w formacie JSON.

{
  "TestModule": {
    "version": "[0.0.1,1.3.0)",
    "repository": "PSGallery"
  },
  "TestModulePrerelease": {
    "version": "[0.0.0,0.0.5]",
    "repository": "PSGallery",
    "prerelease": "true"
  },
  "TestModule99": {}
}

Udostępnij za pośrednictwem