Criando propriedades de recursoCreating resource properties

A primeira coisa que precisamos fazer é decidir sobre as propriedades que serão expostas pelo recuso.The first thing we need to do is decide on properties that the resource will expose.Para esse exemplo, definiremos um usuário do Active Directory com as seguintes propriedades.For this example, we will define an Active Directory user with the following properties.

Criar o recursoCreate the resource

Agora que as propriedades do recurso foram criadas, podemos chamar o cmdlet New-xDscResource para criar o recurso.Now that the resource properties have been created, we can call the New-xDscResource cmdlet to create the resource.O cmdlet New-xDscResource utiliza a lista de propriedades como parâmetros.The New-xDscResource cmdlet takes the list of properties as parameters.Também usa o caminho no qual o módulo deve ser criado, o nome do novo recurso e o nome do módulo no qual ele está contido.It also takes the path where the module should be created, the name of the new resource, and the name of the module in which it is contained.O comando do PowerShell a seguir cria o recurso.The following PowerShell command creates the resource.

Atualizando o recursoUpdating the resource

Se você precisar adicionar ou modificar a lista de parâmetros do recurso, poderá chamar o cmdlet Update-xDscResource.If you need to add or modify the parameter list of the resource, you can call the Update-xDscResource cmdlet.O cmdlet atualiza o recurso com uma nova lista de parâmetros.The cmdlet updates the resource with a new parameter list.Se você já tiver adicionado lógica no script do recurso, ele permanecerá intacto.If you have already added logic in your resource script, it is left intact.

Suponha, por exemplo, que você deseja incluir o horário do último logon para o usuário no nosso recurso.For example, suppose you want to include the last log in time for the user in our resource.Em vez de reescrever o recurso por completo, é possível chamar New-xDscResourceProperty para criar a nova propriedade e, depois, chamar Update-xDscResource e adicionar a nova propriedade à sua lista de propriedades.Rather than writing the resource again completely, you can call the New-xDscResourceProperty to create the new property, and then call Update-xDscResource and add your new property to the properties list.

Testando um esquema de recursosTesting a resource schema

A ferramenta Designer de Recursos expõe mais um cmdlet que pode ser usado para testar a validade de um esquema MOF escrito manualmente.The Resource Designer tool exposes one more cmdlet that can be used to test the validity of a MOF schema that you have written manually.Chame o cmdlet Test-xDscSchema, passando o caminho de um esquema de recursos MOF como parâmetro.Call the Test-xDscSchema cmdlet, passing the path of a MOF resource schema as a parameter.O cmdlet mostrará os erros no esquema.The cmdlet will output any errors in the schema.