Compartilhar via


PSDscResources

PSDscResources é a nova casa dos recursos in-box de PSDesiredStateConfiguration. Os recursos neste módulo são mantidos e compatíveis com a Microsoft.

Esses recursos são uma combinação daqueles no módulo PSDesiredStateConfiguration interno, bem como contribuições da comunidade do nosso módulo experimental xPSDesiredStateConfiguration no GitHub. Esses recursos também foram atualizados recentemente para atender às diretrizes do HQRM (Módulo de Recursos de Alta Qualidade) do Kit de Recursos de DSC.

Os recursos in-box não incluídos neste módulo não devem ser afetados e ainda podem ser carregados do módulo PSDesiredStateConfiguration in-box.

Como PSDscResources substitui recursos in-box, ele só está disponível para DSC 1.1 e PowerShell 5.1 ou posterior. Várias das atualizações de recursos fornecidas aqui também estão incluídas no módulo xPSDesiredStateConfiguration , que ainda é compatível com versões anteriores (embora este módulo não tenha suporte e possa ser removido no futuro).

Para atualizar seus recursos in-box para as versões mais recentes fornecidas pelo PSDscResources, primeiro instale o PSDscResources do Galeria do PowerShell:

Install-Module PSDscResources

Em seguida, adicione essa linha à sua configuração de DSC:

Import-DscResource -ModuleName PSDscResources

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para obter mais informações, confira as Perguntas frequentes sobre o Código de Conduta ou contate opencode@microsoft.com para enviar outras perguntas ou comentários.

Recursos

  • Arquivo morto: expanda ou remova o conteúdo de um arquivo morto (.zip).
  • Ambiente: gerencie uma variável de ambiente para um computador ou processo.
  • Grupo: gerencie um grupo local.
  • GroupSet: gerencie vários recursos de grupo com configurações comuns.
  • MsiPackage: instale ou desinstale um pacote MSI.
  • Registro: gerencie uma chave ou valor do Registro.
  • Script: execute blocos de script do PowerShell.
  • Serviço: gerenciar um serviço Windows.
  • ServiceSet: gerencie vários serviços com configurações comuns.
  • Usuário: gerencie um usuário local.
  • WindowsFeature: instale ou desinstale uma função ou recurso do Windows.
  • WindowsFeatureSet: gerencie várias funções ou recursos do Windows com configurações comuns.
  • WindowsOptionalFeature: habilite ou desabilite um recurso opcional.
  • WindowsOptionalFeatureSet: gerencie vários recursos opcionais com configurações comuns.
  • WindowsPackageCab: instale ou desinstale um pacote de um arquivo de gabinete do Windows (.cab).
  • WindowsProcess: inicie ou interrompa um processo do Windows.
  • ProcessSet: gerencie vários processos do Windows com configurações comuns.

Recursos que funcionam no Nano Server

Recursos que não funcionam na configuração do computador

Ao usar o recurso de configuração de computador do Gerenciamento Automatizado do Azure, não use os seguintes recursos:

  • WindowsFeature
  • WindowsFeatureSet
  • WindowsOptionalFeature
  • WindowsOptionalFeatureSet
  • WindowsPackageCab

Há uma limitação na configuração do computador que impede que um recurso de DSC use quaisquer cmdlets do PowerShell não incluídos no próprio PowerShell ou em um módulo no Galeria do PowerShell. Esses recursos de DSC usam cmdlets de um ou mais módulos do Windows e não funcionarão na configuração do computador.