DSC 资源作

DSC 定义了资源可以实现的一组作。 DSC 调用这些作以将资源用于不同的任务。 并非每个资源都实现每个作。

管理系统状态的常规作包括 GetTestSet

本文档的其余部分介绍了可用的资源作。

获取作

Get作返回系统上特定资源实例的实际状态。

此作仅适用于具有 get 功能的资源。

当您使用以下命令时,DSC 会调用 Get 作:

  • dsc resource get 返回资源实例的实际状态。
  • dsc config get 返回配置文档中每个实例的实际状态。

试运行

Test作将系统上特定资源实例的实际状态与指定的所需状态进行比较。 结果不仅指示实例是否处于所需 状态,还 指示实际状态与所需状态有何不同。

如果资源不具备 测试功能,DSC 会综合测试该资源。

DSC 在使用以下命令时调用 Test 作:

  • dsc resource test 以测试特定资源实例的所需状态。
  • dsc config test 以测试配置文档中每个实例的所需状态。

Set作

Set作在系统上强制执行资源实例的所需状态。 该结果指示资源如何修改系统。

此作仅适用于具有 set 功能的资源。

DSC 在使用以下命令时调用 Set 作:

  • dsc resource set 以强制实施特定资源实例的所需状态。
  • dsc config get 来强制执行由配置文档定义的 desired state。

删除操作

Delete作从系统中删除资源实例。 该作不返回任何输出。

此作仅适用于具有 delete 功能的资源。

DSC 在使用以下命令时调用 Delete 作:

  • dsc resource delete 以删除特定资源实例。

导出作

Export作检索系统上每个资源实例的实际状态。 结果是包含导出实例的配置文档。

此作仅适用于具有 导出功能的资源。

当您使用以下命令时,DSC 会调用 Export 作:

  • dsc resource export 返回一个配置文档,该文档枚举特定资源的每个实例的实际状态。
  • dsc config export 返回一个配置文档,该文档枚举配置文档中每个实例的实际状态。
  • dsc resource get --all可以选择将特定资源的每个实例的实际状态作为 Get作结果数组返回。

列表作

List作检索特定 DSC 适配器资源的可用适配资源。

此作仅适用于 适配器资源

验证作

Validate作指示是否有效定义了资源的实例。 命令资源使用其资源实例架构进行验证。 适配器资源实现 Validate 作,使 DSC 能够验证改编的资源,这些资源可能没有定义的 JSON 架构。

在配置文档中验证适配的资源实例或使用命令直接调用适配的资源时dsc resource,DSC 会对适配器资源调用 Validate作。

Resolve作

Resolve作处理导入程序资源实例以返回配置文档。

此作仅适用于具有 resolve (解析) 功能的资源。 此作主要对 导入程序资源有用。

另请参阅