Compartir a través de

Set-PSResourceRepository

  • Referencia
Módulo:
Microsoft.PowerShell.PSResourceGet

Establece información para un repositorio registrado.

Sintaxis

Set-PSResourceRepository
   [-Name] <String>
   [-Uri <String>]
   [-Trusted]
   [-Priority <Int32>]
   [-ApiVersion <APIVersion>]
   [-CredentialInfo <PSCredentialInfo>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-PSResourceRepository
   -Repository <Hashtable[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El Set-PSResourceRepository cmdlet establece información para un repositorio registrado.

Ejemplos

Ejemplo 1

En este ejemplo, se ha registrado el URI del repositorio PoshTestGallery . El Set-PSResourceRepository cmdlet se usa para cambiar el URI a una ruta de acceso local. El parámetro PassThru permite ver el repositorio modificado.

Get-PSResourceRepository -Name "PoshTestGallery"

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  https://www.poshtestgallery.com/api/v2         False         50

Set-PSResourceRepository -Name "PoshTestGallery" -Uri "c:/code/testdir" -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PoshTestGallery  file:///c:/code/testdir                        False         50

Ejemplo 2

En este ejemplo se cambian los valores Priority y Trusted del repositorio.

Nota

No se puede cambiar el valor URI del repositorio PSGallery predeterminado.

Get-PSResourceRepository -Name "PSGallery"

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2       False         50

Set-PSResourceRepository -Name "PSGallery" -Priority 25 -Trusted -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         25

Ejemplo 3

En este ejemplo se usa el parámetro Repository para cambiar los valores de varios repositorios. El parámetro toma una matriz de tablas hash. Cada tabla hash contiene información que se está actualizando en el repositorio.

Get-PSResourceRepository

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2       False         50
PoshTestGallery  https://www.poshtestgallery.com/api/v2         False         50

$arrayOfHashtables = @{Name = "PSGallery"; Trusted = $True},
                     @{Name = "PoshTestGallery"; Uri = "c:/code/testdir"}
Set-PSResourceRepository -Repository $arrayOfHashtables -PassThru

Name             Uri                                          Trusted   Priority
----             ---                                          -------   --------
PSGallery        https://www.powershellgallery.com/api/v2        True         50
PoshTestGallery  file:///c:/code/testdir                        False         50

Ejemplo 4

En este ejemplo se actualiza un repositorio con información de credenciales que se va a recuperar de un almacén Microsoft.PowerShell.SecretManagement registrado. Debe tener instalado el módulo Microsoft.PowerShell.SecretManagement y tener un almacén registrado que contenga el secreto almacenado. El formato del secreto debe coincidir con los requisitos del repositorio.

$parameters = @{
  Name = "PoshTestGallery"
  Uri = "c:/code/testdir"
  CredentialInfo = [Microsoft.PowerShell.PowerShellGet.UtilClasses.PSCredentialInfo]::new(
    'SecretStore', 'TestSecret')
}
Set-PSResourceRepository @parameters -PassThru |
    Select-Object * -ExpandProperty CredentialInfo

Name           : PoshTestGallery
Uri            : file:///c:/code/testdir
Trusted        : False
Priority       : 50
CredentialInfo : Microsoft.PowerShell.PowerShellGet.UtilClasses.PSCredentialInfo
VaultName      : SecretStore
SecretName     : TestSecret
Credential     :

Parámetros

-ApiVersion

Especifica la versión de API usada por el repositorio. Los valores válidos son:

  • v2 : usa la API de NuGet V2.
  • v3 : usa la API de NuGet V3.
  • local : se usa para repositorios basados en el sistema de archivos.
  • nugetServer : se usa para repositorios basados en NuGet.Server.

El Register-PSResourceRepository cmdlet debe detectar automáticamente la versión de la API. Este parámetro permite cambiar la versión de la API después de haber registrado un repositorio.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Valores aceptados:unknown, v2, v3, local, nugetServer
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CredentialInfo

Objeto PSCredentialInfo que incluye el nombre de un almacén y un secreto almacenado en un almacén Microsoft.PowerShell.SecretManagement .

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre del repositorio que se va a modificar.

Nota

No se puede cambiar el valor URI del repositorio PSGallery predeterminado.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PassThru

Cuando se especifica, muestra el repositorio registrado correctamente y su información.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Priority

Especifica la clasificación de prioridad del repositorio. Los valores de prioridad válidos oscilan entre 0 y 100. Los valores inferiores tienen una clasificación de prioridad más alta. El valor predeterminado es 50.

Los repositorios se ordenan por prioridad y, a continuación, por nombre. Al buscar recursos en varios repositorios, los cmdlets PSResourceGet buscan en los repositorios con este criterio de ordenación y devuelven la primera coincidencia encontrada.

Tipo:Int32
Posición:Named
Valor predeterminado:50
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Repository

Especifica una matriz de tablas hash que contienen información del repositorio. Use este parámetro para registrar varios repositorios a la vez. Cada tabla hash solo puede tener claves asociadas a parámetros para NameParameterSet.

Tipo:Hashtable[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Trusted

Especifica si el repositorio debe ser de confianza.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Uri

Especifica la ubicación del repositorio que se va a registrar. El valor debe usar uno de los siguientes esquemas de URI:

  • https://
  • http://
  • ftp://
  • file://
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Salidas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

De forma predeterminada, el cmdlet no genera ninguna salida. Cuando se usa el parámetro PassThru , el cmdlet devuelve un objeto PSRepositoryInfo .