Condividi tramite

Install-PSResource

  • Riferimento
Modulo:
Microsoft.PowerShell.PSResourceGet

Installa le risorse da un repository registrato.

Sintassi

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>]

Descrizione

Questo cmdlet installa le risorse da un repository registrato in un percorso di installazione in un computer. Per impostazione predefinita, il cmdlet non restituisce alcun oggetto. Altri parametri consentono di specificare il repository, l'ambito e la versione per una risorsa e eliminare le richieste di licenza.

Questo cmdlet combina le funzioni dei Install-Module cmdlet e Install-Script di PowerShellGet v2.

Install-PSResource non carica il modulo appena installato nella sessione corrente. È necessario importare la nuova versione o avviare una nuova sessione per usare il modulo aggiornato. Per altre informazioni, vedere Import-Module.

Esempio

Esempio 1

Installa la versione stabile (non definitiva) più recente del modulo Az .

Install-PSResource Az

Esempio 2

Installa il modulo Az stabile più recente all'interno di tra le versioni 7.3.0 e 8.3.0.

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

Esempio 3

Installa la versione stabile più recente del modulo Az . Quando si usa il parametro Reinstall , il cmdlet scrive su qualsiasi versione installata in precedenza.

Install-PSResource Az -Reinstall

Esempio 4

Installa psResources specificato nel file psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Esempio 5

Installa le risorse PSResources specificate nella tabella hash.

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 = @{}
}

Parametri

-AcceptLicense

Specifica che la risorsa deve accettare qualsiasi richiesta di accettare il contratto di licenza. In questo modo viene eliminata la richiesta se il modulo impone a un utente di accettare il contratto di licenza.

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

Convalida le firme Authenticode e i file di catalogo in Windows.

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Credenziali facoltative usate per l'accesso a un repository.

Tipo:PSCredential
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Usato per l'input della pipeline.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nome di una o più risorse da installare.

Tipo:String[]
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-NoClobber

Impedisce l'installazione di un pacchetto che contiene cmdlet già esistenti nel computer.

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Se specificato, restituisce un oggetto PSResourceInfo per la risorsa salvata.

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

Se specificato, include versioni non definitive nei risultati della ricerca restituiti.

Tipo:SwitchParameter
Aliases:IsPrerelease
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-Quiet

Elimina l'indicatore di stato dell'installazione.

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Reinstall

Installa la versione più recente di un modulo anche se la versione più recente è già installata. La versione installata viene sovrascritta. In questo modo è possibile ripristinare un'installazione danneggiata del modulo.

Se è installata una versione precedente del modulo, la nuova versione viene installata side-by-side in una nuova cartella specifica della versione.

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

Specifica uno o più nomi di repository da cercare. Se non specificato, la ricerca include tutti i repository registrati, in ordine di priorità (il primo), fino a quando non viene trovato un repository che contiene il pacchetto. I repository vengono ordinati in base alla priorità e quindi in base al nome. I valori Priorità inferiore hanno una precedenza più alta.

Quando si cercano risorse in più repository, i cmdlet PSResourceGet eseguono ricerche nei repository usando questo ordinamento. Install-PSResource installa il primo pacchetto corrispondente dall'elenco ordinato di repository.

Il parametro supporta il * carattere jolly. Se si specificano più repository, tutti i nomi devono includere o omettere il carattere jolly. Non è possibile specificare una combinazione di nomi con e senza caratteri jolly.

Tipo:String[]
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:True

-RequiredResource

Stringa hashtable o JSON che specifica le risorse da installare. I caratteri jolly non sono consentiti. Per una descrizione dei formati di file, vedere la sezione NOTES .

Tipo:Object
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:False
Accept wildcard characters:False

-RequiredResourceFile

Percorso di un oggetto .psd1 o .json che specifica le risorse da installare. I caratteri jolly non sono consentiti. Per una descrizione dei formati di file, vedere la sezione NOTES .

Tipo:String
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Specifica l'ambito di installazione. I valori accettati sono:

  • CurrentUser
  • AllUsers

L'ambito predefinito è CurrentUser, che non richiede l'elevazione dei privilegi per l'installazione.

L'ambito AllUsers installa i moduli in un percorso accessibile a tutti gli utenti del computer. Ad esempio:

  • $env:ProgramFiles\PowerShell\Modules

Installa CurrentUser i moduli in un percorso accessibile solo all'utente corrente del computer. Ad esempio:

  • $home\Documents\PowerShell\Modules
Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
valori accettati:CurrentUser, AllUsers
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

Ignora il controllo delle dipendenze delle risorse. Vengono installate solo le risorse trovate. Non vengono installate risorse della risorsa trovata.

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-TemporaryPath

Specifica il percorso per installare temporaneamente la risorsa prima dell'installazione effettiva. Se non viene specificato alcun percorso temporaneo, la risorsa viene installata temporaneamente nella cartella temporanea dell'utente corrente.

Tipo:String
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustRepository

Elimina le richieste di attendibilità del repository. Il prompt per considerare attendibile il repository si verifica solo se il repository non è configurato come attendibile.

Tipo:SwitchParameter
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

Specifica la versione della risorsa da restituire. Il valore può essere una versione esatta o un intervallo di versioni usando la sintassi di controllo delle versioni di NuGet.

Per altre informazioni sugli intervalli di versioni di NuGet, vedere Controllo delle versioni dei pacchetti.

PowerShellGet supporta tutte le versioni incluse, ma la versione minima inclusa elencata nella documentazione relativa all'intervallo di versioni di NuGet. L'uso 1.0.0.0 come versione non produce versioni 1.0.0.0 e successive (intervallo inclusivo minimo). Il valore viene invece considerato la versione richiesta. Per cercare un intervallo inclusivo minimo, usare [1.0.0.0, ] come intervallo di versioni.

Tipo:String
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Output

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Per impostazione predefinita, il cmdlet non restituisce oggetti. Quando si usa il parametro PassThru , il cmdlet restituisce un oggetto PSResourceInfo per la risorsa salvata.

Note

Il modulo definisce isres come alias per Install-PSResource.

I parametri RequiredResource e RequiredResourceFile vengono usati per trovare gli oggetti PSResource corrispondenti a criteri specifici. È possibile specificare i criteri di ricerca usando una tabella hash o un oggetto JSON. Per il parametro RequiredResourceFile , la tabella hash viene archiviata in un .psd1 file e l'oggetto JSON viene archiviato in un .json file. Per altre informazioni, vedere about_PSResourceGet.