Delen via


Set-PSResourceRepository

Hiermee stelt u informatie in voor een geregistreerde opslagplaats.

Syntaxis

NameParameterSet (Standaard)

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

RepositoriesParameterSet

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.

Opmerking

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.

Parametereigenschappen

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo+APIVersion
Default value:None
Geaccepteerde waarden:V2, V3, Local, NugetServer, ContainerRegistry
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CredentialInfo

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

Parametereigenschappen

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

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

Opmerking

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-PassThru

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:Int32
Default value:50
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Hashtable[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RepositoriesParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Trusted

Hiermee geeft u op of de opslagplaats moet worden vertrouwd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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://

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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.