Compartir a través de


Set-PSResourceRepository

Establece la información de un repositorio registrado.

Sintaxis

NameParameterSet (valor predeterminado)

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

RepositoriesParameterSet

Set-PSResourceRepository
    -Repository <Hashtable[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

Ejemplos

Ejemplo 1

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

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 de Priority y Trusted del repositorio.

Nota:

No se puede cambiar el valor de Uri del repositorio de de 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 de para cambiar los valores de varios repositorios. El parámetro toma una matriz de tablas hash. Cada tabla hash contiene información que el repositorio se está actualizando.

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 registrado Microsoft.PowerShell.SecretManagement. Debe tener la instalación del 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 la API que usa el repositorio. Los valores válidos son:

  • v2: usa la API de NuGet V2
  • v3: usa la API de NuGet V3
  • ContainerRegistry: se usa para Azure Container Registry
  • local: úselo para repositorios basados en el sistema de archivos
  • nugetServer: úselo para repositorios basados en NuGet.Server

El cmdlet Register-PSResourceRepository 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.

Propiedades de parámetro

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Valor predeterminado:None
Valores aceptados:V2, V3, Local, NugetServer, ContainerRegistry
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CredentialInfo

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

Propiedades de parámetro

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CredentialProvider

Este es un parámetro dinámico que especifica el proveedor de credenciales a utilizar para el repositorio. Este parámetro solo está disponible cuando el repositorio nombrado es una fuente Azure Artifacts. Los valores válidos son:

  • None - No se define ningún proveedor de credenciales
  • AzArtifacts - Utilizar el proveedor de credenciales de artefactos de Azure

Propiedades de parámetro

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.CredentialProviderType
Valor predeterminado:None
Valores aceptados:None, AzArtifacts
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre del repositorio que se va a modificar.

Nota:

No se puede cambiar el valor de Uri del repositorio de de PSGallery predeterminado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NameParameterSet
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PassThru

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Priority

Especifica la clasificación de prioridad del repositorio. Los valores de prioridad válidos oscilan entre 0 y 100. Los valores más bajos 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 de PSResourceGet buscan en los repositorios con este criterio de ordenación y devuelven la primera coincidencia encontrada.

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:50
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 el NameParameterSet.

Propiedades de parámetro

Tipo:

Hashtable[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

RepositoriesParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Trusted

Especifica si el repositorio debe ser de confianza.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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://

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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.