Register-PSResourceRepository

  • Odwołanie
Moduł:
Microsoft.PowerShell.PSResourceGet

Rejestruje repozytorium dla zasobów programu PowerShell.

Składnia

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>]

Opis

Polecenie cmdlet rejestruje repozytorium NuGet zawierające zasoby programu PowerShell.

Przykłady

Przykład 1

W tym przykładzie zarejestrowano repozytorium przy użyciu nazwyPoshTestGallery.

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

Przykład 2

W tym przykładzie zarejestrowano domyślne PSGallery repozytorium. W przeciwieństwie do poprzedniego przykładu nie możemy użyć parametrów Name i Uri do zarejestrowania PSGallery repozytorium. Repozytorium PSGallery jest domyślnie zarejestrowane, ale można je usunąć. Użyj tego polecenia, aby przywrócić rejestrację domyślną.

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

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

Przykład 3

W tym przykładzie zarejestrowano wiele repozytoriów jednocześnie. W tym celu użyjemy parametru Repository i udostępnimy tablicę tabel skrótów. Każda tabela skrótów może mieć tylko klucze skojarzone z parametrami parametrów nameParameterSet lub 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

Przykład 4

W tym przykładzie zarejestrowano repozytorium z informacjami o poświadczeniach, które mają zostać pobrane z zarejestrowanego magazynu SecretManagement . Musisz mieć zainstalowany moduł Microsoft.PowerShell.SecretManagement i mieć zarejestrowany magazyn zawierający przechowywany wpis tajny. Format wpisu tajnego musi odpowiadać wymaganiom repozytorium.

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

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-CredentialInfo

Obiekt PSCredentialInfo zawierający nazwę magazynu i wpis tajny przechowywany w magazynie Microsoft.PowerShell.SecretManagement .

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

-Force

Zastępuje repozytorium, jeśli już istnieje.

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

-Name

Nazwa repozytorium do zarejestrowania. Nie można mieć .PSGallery

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

-PassThru

Po określeniu zostanie wyświetlone pomyślnie zarejestrowane repozytorium i jego informacje.

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

-Priority

Określa klasyfikację priorytetów repozytorium. Prawidłowe wartości priorytetów wahają się od 0 do 100. Niższe wartości mają wyższy priorytet klasyfikacji. Wartość domyślna to 50.

Repozytoria są sortowane według priorytetu, a następnie według nazwy. Podczas wyszukiwania zasobów w wielu repozytoriach polecenia cmdlet PSResourceGet wyszukują repozytoria przy użyciu tej kolejności sortowania i zwracają pierwsze znalezione dopasowanie.

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

-PSGallery

Po określeniu program rejestruje repozytorium PSGallery .

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

-Repository

Określa tablicę tabel skrótów, które zawierają informacje o repozytorium. Ten parametr służy do rejestrowania wielu repozytoriów jednocześnie. Każda tabela skrótów może mieć tylko klucze skojarzone z parametrami parametrów nameParameterSet lub PSGalleryParameterSet.

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

-Trusted

Określa, czy repozytorium powinno być zaufane.

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

-Uri

Określa lokalizację repozytorium do zarejestrowania. Wartość musi używać jednego z następujących schematów identyfikatora URI:

  • https://
  • http://
  • ftp://
  • file://
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

Dane wejściowe

None

Dane wyjściowe

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSRepositoryInfo

Domyślnie polecenie cmdlet nie generuje żadnych danych wyjściowych. Gdy używasz parametru PassThru , polecenie cmdlet zwraca obiekt PSRepositoryInfo .

Uwagi

Repozytoria są unikatowe według nazwy. Próba zarejestrowania repozytorium o tej samej nazwie powoduje wystąpienie błędu.