Install-PSResource

Odwołanie

Moduł:: Microsoft.PowerShell.PSResourceGet

Instaluje zasoby z zarejestrowanego repozytorium.

Składnia

Install-PSResource
       [-Name] <String[]>
       [-Version <String>]
       [-Prerelease]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Opis

To polecenie cmdlet instaluje zasoby z zarejestrowanego repozytorium do ścieżki instalacji na maszynie. Domyślnie polecenie cmdlet nie zwraca żadnego obiektu. Inne parametry umożliwiają określenie repozytorium, zakresu i wersji zasobu oraz pominięcie monitów o licencję.

To polecenie cmdlet łączy funkcje poleceń cmdlet i Install-Script z modułu Install-ModulePowerShellGet w wersji 2.

Przykłady

Przykład 1

Instaluje najnowszą stabilną (nie w wersji wstępnej) wersję modułu Az .

Install-PSResource Az

Przykład 2

Instaluje najnowszy stabilny moduł Az w ramach między wersjami 7.3.0 i 8.3.0.

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

Przykład 3

Instaluje najnowszą stabilną wersję modułu Az . Gdy jest używany parametr Zainstaluj ponownie , polecenie cmdlet zapisuje wszystkie wcześniej zainstalowane wersje.

Install-PSResource Az -Reinstall

Przykład 4

Instaluje pliki PSResources określone w pliku psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Przykład 5

Instaluje usługę PSResources określoną w tabeli skrótu.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Parametry

-AcceptLicense

Określa, że zasób powinien zaakceptować wszelkie żądania zaakceptowania umowy licencyjnej. Spowoduje to pominięcie monitowania, czy moduł nakazuje użytkownikowi zaakceptowanie umowy licencyjnej.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuthenticodeCheck

Weryfikuje podpisy Authenticode i pliki wykazu w systemie Windows.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Opcjonalne poświadczenia używane podczas uzyskiwania dostępu do repozytorium.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Służy do wprowadzania potoku.

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:	ParentResource
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nazwa co najmniej jednego zasobu do zainstalowania.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoClobber

Zapobiega instalowaniu pakietu zawierającego polecenia cmdlet, które już istnieją na maszynie.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Po określeniu zwraca obiekt PSResourceInfo dla zapisanego zasobu.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Prerelease

Po określeniu uwzględnij wersje wstępne w zwracanych wynikach wyszukiwania.

Type:	SwitchParameter
Aliases:	IsPrerelease
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Quiet

Pomija pasek postępu instalacji.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Reinstall

Instaluje najnowszą wersję modułu, nawet jeśli jest już zainstalowana najnowsza wersja. Zainstalowana wersja jest zastępowana. Pozwala to naprawić uszkodzoną instalację modułu.

Jeśli zainstalowano starszą wersję modułu, nowa wersja zostanie zainstalowana obok siebie w nowym folderze specyficznym dla wersji.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Repository

Określa co najmniej jedną nazwę repozytorium do wyszukania. Jeśli nie zostanie określony, wyszukiwanie zawiera wszystkie zarejestrowane repozytoria, w kolejności priorytetowej (najwyższa pierwsza), dopóki repozytorium nie zostanie znalezione, które zawiera pakiet. Repozytoria są sortowane według priorytetu, a następnie według nazwy. Niższe wartości priorytetu mają wyższy priorytet.

Podczas wyszukiwania zasobów w wielu repozytoriach polecenia cmdlet PSResourceGet przeszukają repozytoria przy użyciu tej kolejności sortowania. Install-PSResource instaluje pierwszy pasujący pakiet z posortowanej listy repozytoriów.

Parametr obsługuje * symbol wieloznaczny. Jeśli określisz wiele repozytoriów, wszystkie nazwy muszą zawierać lub pomijać symbol wieloznaczny. Nie można określić kombinacji nazw z symbolami wieloznacznymi i bez symboli wieloznacznych.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-RequiredResource

Wartość skrótowa lub ciąg JSON określający zasoby do zainstalowania. Symbole wieloznaczne nie są dozwolone. Zobacz sekcję UWAGI , aby uzyskać opis formatów plików.

Type:	Object
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredResourceFile

Ścieżka do elementu .psd1 lub .json określa zasoby do zainstalowania. Symbole wieloznaczne nie są dozwolone. Zobacz sekcję UWAGI , aby uzyskać opis formatów plików.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Określa zakres instalacji. Akceptowane wartości to:

CurrentUser
AllUsers

Domyślny zakres to CurrentUser, który nie wymaga podniesienia uprawnień do instalacji.

Zakres AllUsers instaluje moduły w lokalizacji dostępnej dla wszystkich użytkowników komputera. Na przykład:

$env:ProgramFiles\PowerShell\Modules

Moduły CurrentUser są instalowane w lokalizacji dostępnej tylko dla bieżącego użytkownika komputera. Na przykład:

$home\Documents\PowerShell\Modules

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipDependencyCheck

Pomija sprawdzanie zależności zasobów. Zainstalowane są tylko znalezione zasoby. Nie zainstalowano żadnych zasobów znalezionych.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TemporaryPath

Określa ścieżkę do tymczasowego zainstalowania zasobu przed rzeczywistą instalacją. Jeśli nie podano ścieżki tymczasowej, zasób jest tymczasowo zainstalowany w folderze tymczasowym bieżącego użytkownika.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustRepository

Pomiń monity o zaufanie do repozytorium. Monit o zaufanie repozytorium występuje tylko wtedy, gdy repozytorium nie jest skonfigurowane jako zaufane.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Version

Określa wersję zasobu do zwrócenia. Wartość może być dokładną wersją lub zakresem wersji przy użyciu składni przechowywania wersji NuGet.

Aby uzyskać więcej informacji na temat zakresów wersji NuGet, zobacz Przechowywanie wersji pakietów.

Moduł PowerShellGet obsługuje wszystkie, 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.0 i nowszych (minimalny zakres inkluzywny). Zamiast tego wartość jest uważana za wymaganą wersję. Aby wyszukać minimalny zakres inkluzywny, użyj go [1.0.0.0, ] jako zakresu wersji.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Dane wyjściowe

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Domyślnie polecenie cmdlet nie zwraca żadnych obiektów. Gdy jest używany parametr PassThru , polecenie cmdlet zwraca obiekt PSResourceInfo dla zapisanego zasobu.

Uwagi

Moduł definiuje isres alias dla Install-PSResourceelementu .

Parametry RequiredResource i RequiredResourceFile służą do znajdowania obiektów PSResource spełniających określone kryteria. Kryteria wyszukiwania można określić przy użyciu tabeli skrótu lub obiektu JSON. Dla parametru RequiredResourceFile skrót jest przechowywany w .psd1 pliku, a obiekt JSON jest przechowywany w .json pliku. Aby uzyskać więcej informacji, zobacz about_PSResourceGet.

Install-PSResource

Składnia

Opis

Przykłady

Przykład 1

Przykład 2

Przykład 3

Przykład 4

Przykład 5

Parametry

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Opinia

Dodatkowe zasoby

Install-PSResource

Składnia

Opis

Przykłady

Przykład 1

Przykład 2

Przykład 3

Przykład 4

Przykład 5

Parametry

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Opinia

Dodatkowe zasoby