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 cmdlet Install-Module e Install-Script da 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.

Nota

Install-PSResource non installa le risorse dipendenti dai repository che usano il protocollo NuGet v3. È necessario installare singolarmente le risorse dipendenti. Questa funzionalità verrà aggiunta in una versione futura.

Esempio

Esempio 1

Installa la versione stabile (non definitiva) più recente del modulo az di da PowerShell Gallery.

Install-PSResource Az -Repository PSGallery

Il modulo Az è un metamodulo che include tutti i moduli az di PowerShell come dipendenze. Questo comando installa il modulo Az e tutte le relative dipendenze.

Esempio 2

Installa il modulo stabile Az 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
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AuthenticodeCheck

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Credenziali facoltative usate per l'accesso a un repository.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Usato per l'input della pipeline.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Alias:ParentResource
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Nome di una o più risorse da installare.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NoClobber

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Prerelease

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

Tipo:SwitchParameter
Alias:IsPrerelease
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Quiet

Elimina l'indicatore di stato dell'installazione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 Priority lower hanno una precedenza più alta.

Quando si cercano risorse in più repository, i cmdlet di 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[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequiredResourceFile

Percorso di un .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
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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. Per esempio:

  • $env:ProgramFiles\PowerShell\Modules

Il CurrentUser installa i moduli in un percorso accessibile solo all'utente corrente del computer. Per esempio:

  • $home\Documents\PowerShell\Modules
Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valori accettati:CurrentUser, AllUsers
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SkipDependencyCheck

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 elencate nella documentazione dell'intervallo di versioni di NuGet. L'uso di 1.0.0.0 perché la versione non restituisce 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
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String[]

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 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 file .psd1 e l'oggetto JSON viene archiviato in un file .json. Per altre informazioni, vedere about_PSResourceGet.