Announcement
Este repositório foi descontinuado. O módulo PackageManagementProviderResource foi mesclado com PackageManagement. Use https://github.com/OneGet/oneget daqui para frente. Obrigado!
O PackageManagementProviderResource são os recursos DSC para provedores PackageManagement (também conhecidos como OneGet). Atualmente, ele contém os recursos DSC do provedor Nuget e PowerShellGet para permitir o gerenciamento de pacotes e módulos do Windows PowerShell.
Verifique as diretrizes comuns de contribuição dos Recursos DSC.
PackageManagement – um provedor genérico de PackageManagement que permite baixar e instalar pacotes de qualquer fonte. Este provedor usa cmdlets Install-Package e Get-Package. Talvez seja necessário usar o recurso DSC PackageManagementSource para registrar fontes não padrão.
NugetPackage – permite baixar pacotes do local de origem do NuGet (por exemplo, http://nuget.org/api/v2/) e instalar ou desinstalar o pacote.
PSModule – permite baixar módulos do Windows PowerShell da Galeria do PowerShell, "PSGallery" (por exemplo, https://www.powershellgallery.com/api/v2/ ) e instalá-los em seu computador.
PackageManagementSource – permite registrar ou cancelar o registro de uma fonte de pacote em seu computador
O recurso PackageManagement DSC tem as seguintes propriedades:
| Propriedade | Descrição |
| Nome | Especifica o nome do pacote a ser instalado ou desinstalado. |
| Fonte | Especifica o nome da origem do pacote onde o pacote pode ser encontrado. Pode ser um URI ou uma fonte registrada no cmdlet Register-PackageSource ou no recurso DSC PackageManagementSource. O recurso DSC MSFT_PackageManagementSource também pode registrar uma origem de pacote. |
| Garantir | Determina se o pacote deve ser instalado ou desinstalado. |
| Versão obrigatória | Especifica a versão exata do pacote que você deseja instalar. Se você não especificar esse parâmetro, esse recurso DSC instalará a versão mais recente disponível do pacote que também satisfaz qualquer versão máxima especificada pelo parâmetro MaximumVersion. |
| Versão Mínima | Especifica a versão mínima permitida do pacote que você deseja instalar. Se você não adicionar esse parâmetro, esse recurso DSC instalará a versão mais alta disponível do pacote que também satisfaça qualquer versão máxima especificada pelo parâmetro MaximumVersion. |
| Versão Máxima | Especifica a versão máxima permitida do pacote que você deseja instalar. Se você não especificar esse parâmetro, esse recurso DSC instalará a versão disponível do pacote com o número mais alto. |
| FonteCredencial | Especifica uma conta de usuário que tem direitos para instalar um pacote para um provedor ou fonte de pacote especificado. |
| Nome do Provedor | Especifica um nome de provedor de pacote para o qual será definido o escopo de sua pesquisa de pacote. Você pode obter nomes de provedores de pacotes executando o cmdlet Get-PackageProvider. |
| Parâmetros Adicionais | Parâmetros específicos do provedor que são passados como Hashtable. Por exemplo, para o provedor NuGet, você pode passar parâmetros adicionais como DestinationPath. |
O recurso NugetPackage DSC tem as seguintes propriedades:
| Propriedade | Descrição |
| Nome | Especifica o nome do pacote a ser instalado ou desinstalado. |
| Caminho de destino | Especifica um local de arquivo onde você deseja que o pacote seja instalado. |
| Garantir | Determina se o pacote deve ser instalado ou desinstalado. |
| Política de instalação | Determina se você confia na origem do pacote. |
| Versão obrigatória | Especifica a versão exata do pacote que você deseja instalar ou desinstalar. |
| Versão Mínima | Especifica a versão mínima do pacote que você deseja instalar ou desinstalar. |
| Versão Máxima | Especifica a versão máxima do pacote que você deseja instalar ou desinstalar. |
| Fonte | Especifica o URI ou nome da origem do pacote registrado. |
| FonteCredencial | Fornece acesso ao pacote em uma fonte remota. Esta propriedade não é usada para instalar o pacote. O pacote é sempre instalado na conta do sistema local. |
O recurso PSModule DSC possui as seguintes propriedades:
| Propriedade | Descrição |
| Nome | Especifica o nome do módulo PowerShell a ser instalado ou desinstalado. |
| Garantir | Determina se o módulo será instalado ou desinstalado. |
| Política de instalação | Determina se você confia no repositório de origem onde o módulo reside. |
| Versão obrigatória | Especifica a versão exata do módulo que você deseja instalar ou desinstalar. |
| Versão Mínima | Especifica a versão mínima do módulo que você deseja instalar ou desinstalar. |
| Repositório | Especifica o nome do repositório de origem do módulo onde o módulo pode ser encontrado. |
PackageManagementSource tem as seguintes propriedades:
| Propriedade | Descrição |
| Nome | Especifica o nome da origem do pacote a ser registrada ou cancelada em seu sistema. |
| Nome do Provedor | Especifica o nome do provedor OneGet por meio do qual você pode interoperar com a origem do pacote. |
| Garantir | Determina se a origem do pacote deve ser registrada ou cancelada. |
| Política de instalação | Determina se você confia na origem do pacote. |
| FonteUri | Especifica o URI da origem do pacote. |
| FonteCredencial | Fornece acesso ao pacote em uma fonte remota. |
Antes de instalar este pacote, você deve estar executando o [Windows Management Framework 5.0 RTM (https://www.microsoft.com/en-us/download/details.aspx?id=50395).
Para usar o módulo PackageManagementProviderResource ,
Para confirmar a instalação,
O código é um script do Windows PowerShell e é interpretado pelo mecanismo do Windows PowerShell em tempo de execução.
Para testar os módulos, execute os seguintes comandos. O recurso NuGetPackage é usado aqui como exemplo.
Você pode repetir esses comandos de forma semelhante para testar os recursos PackageManagement, PSModule e PackageManagementSource DSC.
Você está convidado a contribuir com este projeto. Existem muitas maneiras de contribuir:
Envie um relatório de bug via Issues. Para obter um guia sobre como enviar bons relatórios de bugs, leia Painless Bug Tracking.
Verifique as correções de bugs.
Envie suas correções para um bug. Antes de enviar, certifique-se de ter:
Você também pode ler estas duas postagens de blog sobre contribuição de código: Etiqueta de contribuição de código aberto, de Miguel de Icaza, e Não “empurre” suas solicitações pull, de Ilya Grigorik.
Antes de enviar um recurso ou uma contribuição substancial de código, discuta-o com a equipe do Windows PowerShell por meio de Problemas e certifique-se de que ele siga o roteiro do produto. Observe que todos os envios de código serão rigorosamente revisados pela equipe do Windows PowerShell. Somente aqueles que atenderem a um alto padrão de qualidade e adequação ao roteiro serão mesclados na fonte.
#### Exemplos ####
As amostras estão incluídas na pasta Exemplos.
