resourceId

Artigo
05/09/2024

Sinopse

Retorna o identificador exclusivo de um recurso.

Sintaxe

resourceId('<resourceTypeName>', '<instanceName>')

Descrição

A resourceId() função retorna um identificador para uma instância de recurso específica na configuração. Essa função permite que as instâncias referenciem outra instância para a opção dependsOn .

Observação

Ao usar a resourceId função para instâncias de recurso aninhadas, as instâncias só podem referenciar outras instâncias no mesmo provedor de recursos ou instância de grupo. Eles não podem usar a resourceId() função para pesquisar instâncias no nível superior do documento de configuração ou dentro de outro provedor ou instância de grupo.

Exemplos

Exemplo 1 – Referenciar um recurso como uma dependência

A configuração a seguir usa a resourceId() função para referenciar a instância nomeada Tailspin Key como uma dependência da instância de Update Tailspin Automatically recurso.

# resourceId.example.1.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
  - name: Tailspin Key
    type: Microsoft.Windows/Registry
    properties:
      keyPath: HKCU\tailspin
      _ensure: Present
  - name: Update Tailspin Automatically
    type: Microsoft.Windows/Registry
    properties:
      keyPath:   HKCU\tailspin\updates
      valueName: automatic
      valueData:
        String: enable
    dependsOn:
      - "[resourceId('Microsoft.Windows/Registry', 'Tailspin Key')]"

Exemplo 2 – Referenciar um recurso de grupo como uma dependência

A configuração a seguir usa a resourceId() função para especificar a DSC/AssertionGroup instância de recurso chamada 'IsWindows' como uma dependência da instância de Example Key recurso.

# resourceId.example.2.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
  - name: IsWindows
    type: DSC/AssertionGroup
    properties:
      $schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
      resources:
        - name: os
          type: Microsoft/OSInfo
          properties:
            family: Windows
  - name: Example Key
    type: Microsoft.Windows/Registry
    properties:
      keyPath: HKCU\example
      _exist: true

Parâmetros

resourceTypeName

O valor da propriedade type da instância de recurso a ser referenciada. O valor deve ser o nome de tipo totalmente qualificado para o recurso.

Type:     string
Required: true
Position: 0

NOMEDAINSTÂNCIA

O valor da propriedade name da instância de recurso a ser referenciada.

Type:     string
Required: true
Position: 0

Compartilhar via