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
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
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
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
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: | |
| 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.