Delen via

Set-PSResourceRepository

  • Referentie
Module:
Microsoft.PowerShell.PSResourceGet

Hiermee stelt u informatie in voor een geregistreerde opslagplaats.

Syntaxis

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

De Set-PSResourceRepository cmdlet stelt informatie in voor een geregistreerde opslagplaats.

Voorbeelden

Voorbeeld 1

In dit voorbeeld is de URI- voor de PoshTestGallery-opslagplaats geregistreerd. De Set-PSResourceRepository-cmdlet wordt gebruikt om de URI- te wijzigen in een lokaal pad. Met de parameter PassThru kunt u de gewijzigde opslagplaats zien.

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

Voorbeeld 2

In dit voorbeeld worden de waarden Priority en Trusted waarden van de opslagplaats gewijzigd.

Notitie

De URI- waarde van de standaardopslagplaats PSGallery kan niet worden gewijzigd.

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

Voorbeeld 3

In dit voorbeeld wordt de parameter Repository gebruikt om waarden voor meerdere opslagplaatsen te wijzigen. De parameter gebruikt een matrix met hashtabellen. Elke hashtabel bevat informatie over de opslagplaats die wordt bijgewerkt.

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

Voorbeeld 4

In dit voorbeeld wordt een opslagplaats bijgewerkt met referentiegegevens die moeten worden opgehaald uit een geregistreerde Microsoft.PowerShell.SecretManagement kluis. U moet de module Microsoft.PowerShell.SecretManagement installeren en een geregistreerde kluis met het opgeslagen geheim hebben. De indeling van het geheim moet overeenkomen met de vereisten van de opslagplaats.

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

Parameters

-ApiVersion

Hiermee geeft u de API-versie op die wordt gebruikt door de opslagplaats. Geldige waarden zijn:

  • v2 : maakt gebruik van de NuGet V2-API
  • v3 : maakt gebruik van de NuGet V3-API
  • ContainerRegistry - gebruikt voor Azure Container Registry
  • local: gebruik dit voor opslagplaatsen op basis van een bestandssysteem
  • nugetServer: gebruik dit voor opslagplaatsen op basis van NuGet.Server

De Register-PSResourceRepository cmdlet moet automatisch de API-versie detecteren. Met deze parameter kunt u de API-versie wijzigen nadat u een opslagplaats hebt geregistreerd.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Geaccepteerde waarden:V2, V3, Local, NugetServer, ContainerRegistry
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CredentialInfo

Een PSCredentialInfo object met de naam van een kluis en een geheim dat is opgeslagen in een Microsoft.PowerShell.SecretManagement store.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam op van de opslagplaats die moet worden gewijzigd.

Notitie

De URI- waarde van de standaardopslagplaats PSGallery kan niet worden gewijzigd.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Wanneer dit is opgegeven, worden de geregistreerde opslagplaats en de bijbehorende gegevens weergegeven.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Priority

Hiermee geeft u de prioriteitsclassificatie van de opslagplaats. Geldige prioriteitswaarden variëren van 0 tot 100. Lagere waarden hebben een hogere prioriteitsclassificatie. De standaardwaarde is 50.

Opslagplaatsen worden gesorteerd op prioriteit en vervolgens op naam. Wanneer u zoekt naar resources in meerdere opslagplaatsen, doorzoekt de PSResourceGet cmdlets de opslagplaatsen met behulp van deze sorteervolgorde en retourneert u de eerste gevonden overeenkomst.

Type:Int32
Position:Named
Default value:50
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Repository

Hiermee geeft u een matrix van hashtabellen die opslagplaatsgegevens bevatten. Gebruik deze parameter om meerdere opslagplaatsen tegelijk te registreren. Elke hashtabel kan alleen sleutels bevatten die zijn gekoppeld aan parameters voor de NameParameterSet.

Type:Hashtable[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Trusted

Hiermee geeft u op of de opslagplaats moet worden vertrouwd.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Uri

Hiermee geeft u de locatie op van de opslagplaats die moet worden geregistreerd. De waarde moet een van de volgende URI-schema's gebruiken:

  • https://
  • http://
  • ftp://
  • file://
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

De cmdlet produceert standaard geen uitvoer. Wanneer u de parameter PassThru gebruikt, retourneert de cmdlet een PSRepositoryInfo-object.