Register-PSResourceRepository

Modul:

Microsoft.PowerShell.PSResourceGet

Registrerar en lagringsplats för PowerShell-resurser.

Syntax

Register-PSResourceRepository
        [-Name] <String>
        [-Uri] <String>
        [-Trusted]
        [-Priority <Int32>]
        [-CredentialInfo <PSCredentialInfo>]
        [-PassThru]
        [-Force]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Register-PSResourceRepository
        [-PSGallery]
        [-Trusted]
        [-Priority <Int32>]
        [-PassThru]
        [-Force]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

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

Description

Cmdleten registrerar en NuGet-lagringsplats som innehåller PowerShell-resurser.

Exempel

Exempel 1

I det här exemplet registreras lagringsplatsen med namnetPoshTestGallery.

Register-PSResourceRepository -Name PoshTestGallery -Uri 'https://www.poshtestgallery.com/api/v2'
Get-PSResourceRepository -Name PoshTestGallery

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

Exempel 2

I det här exemplet registreras standardlagringsplatsen PSGallery . Till skillnad från i föregående exempel kan vi inte använda parametrarna Name och URI för att registrera lagringsplatsen PSGallery . Lagringsplatsen PSGallery är registrerad som standard men kan tas bort. Använd det här kommandot för att återställa standardregistreringen.

Register-PSResourceRepository -PSGallery
Get-PSResourceRepository -Name 'PSGallery'

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

Exempel 3

Det här exemplet registrerar flera lagringsplatser samtidigt. För att göra det använder vi parametern Repository och tillhandahåller en matris med hashtables. Varje hashtable kan bara ha nycklar som är associerade med parametrar för NameParameterSet eller PSGalleryParameterSet.

$arrayOfHashtables = @{
        Name = 'Local'
        Uri = 'D:/PSRepoLocal/'
        Trusted = $true
        Priority = 20
    },
    @{
        Name = 'PSGv3'
        Uri = 'https://www.powershellgallery.com/api/v3'
        Trusted = $true
        Priority = 50
    },
    @{
        PSGallery = $true
        Trusted = $true
        Priority = 10
    }
Register-PSResourceRepository -Repository $arrayOfHashtables
Get-PSResourceRepository

Name      Uri                                      Trusted Priority
----      ---                                      ------- --------
PSGallery https://www.powershellgallery.com/api/v2 True    10
Local     file:///D:/PSRepoLocal/                  True    20
PSGv3     https://www.powershellgallery.com/api/v3 True    50

Exempel 4

I det här exemplet registreras en lagringsplats med information om autentiseringsuppgifter som ska hämtas från ett registrerat SecretManagement-valv . Du måste ha modulen Microsoft.PowerShell.SecretManagement installerad och ha ett registrerat valv som innehåller den lagrade hemligheten. Hemlighetens format måste matcha lagringsplatsens krav.

$parameters = @{
  Name = 'PSGv3'
  Uri = 'https://www.powershellgallery.com/api/v3'
  Trusted = $true
  Priority = 50
  CredentialInfo = [Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo]::new(
    'SecretStore', 'TestSecret')
}
Register-PSResourceRepository @parameters
Get-PSResourceRepository | Select-Object * -ExpandProperty CredentialInfo

Name           : PSGv3
Uri            : https://www.powershellgallery.com/api/v3
Trusted        : True
Priority       : 50
CredentialInfo : Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
VaultName      : SecretStore
SecretName     : TestSecret
Credential     :

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CredentialInfo

Ett PSCredentialInfo-objekt som innehåller namnet på ett valv och en hemlighet som lagras i ett Microsoft.PowerShell.SecretManagement-arkiv .

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCredentialInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Skriver över en lagringsplats om den redan finns.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Namnet på lagringsplatsen som ska registreras. Kan inte vara PSGallery.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

När den har angetts visas den registrerade lagringsplatsen och dess information.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

Anger prioritetsordningen för lagringsplatsen. Giltiga prioritetsvärden sträcker sig från 0 till 100. Lägre värden har en rangordning med högre prioritet. Standardvärdet är 50.

Lagringsplatser sorteras efter prioritet och sedan efter namn. När du söker efter resurser på flera lagringsplatser söker PSResourceGet-cmdletarna igenom lagringsplatserna med hjälp av den här sorteringsordningen och returnerar den första matchningen som hittades.

Type:	Int32
Position:	Named
Default value:	50
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PSGallery

När detta anges registreras PSGallery-lagringsplatsen .

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Repository

Anger en matris med hashtabeller som innehåller lagringsplatsinformation. Använd den här parametern för att registrera flera lagringsplatser samtidigt. Varje hashtable kan bara ha nycklar som är associerade med parametrar för NameParameterSet eller PSGalleryParameterSet.

Type:	Hashtable[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Trusted

Anger om lagringsplatsen ska vara betrodd.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Uri

Anger platsen för lagringsplatsen som ska registreras. Värdet måste använda något av följande URI-scheman:

• https://
• http://
• ftp://
• file://

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

None

Utdata

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Som standard genererar cmdleten inga utdata. När du använder parametern PassThru returnerar cmdleten ett PSRepositoryInfo-objekt .

Kommentarer

Lagringsplatser är unika efter namn. Försök att registrera en lagringsplats med samma namn resulterar i ett fel.

Relaterade länkar

• Microsoft.PowerShell.SecretManagement