Share via

Referenční informace ke schématu plně kvalifikovaného názvu typu prostředku DSC

  • Článek

Synopse

Identifikuje prostředek DSC.

Metadata

SchemaDialect: https://json-schema.org/draft/2020-12/schema
SchemaID:      https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/definitions/resourceType.json
Type:          string
Pattern:       ^\w+(\.\w+){0,2}\/\w+$

Popis

Prostředky DSC se identifikují podle plně kvalifikovaného názvu typu. Hodnoty tohoto typu slouží k určení prostředku v dokumentech konfigurace a jako hodnota příznaku --resource při použití dsc resource * příkazů.

Plně kvalifikovaný název typu prostředku používá následující syntaxi:

`<owner>[.<group>][.<area>]/<name>`

Každý segment musí být řetězec alfanumerických znaků a podtržítka. Nejsou povoleny žádné další znaky. Každý prostředek musí definovat a ownername. group Komponenty a area slouží k uspořádání prostředků do souvisejících oborů názvů. Příklad:

  • Microsoft.SqlServer/Database
  • Microsoft.SqlServer.Database/Role
  • Microsoft.SqlServer.Database/User
  • Microsoft.SqlServer/Endpoint
  • Microsoft.SqlServer.Endpoint/Permission
  • Microsoft.SqlServer/Login
  • Microsoft.SqlServer/MaxDop

Segmenty názvů typů

Vlastník

Segment vlastníka názvu typu je povinný. Identifikuje osobu nebo organizaci, která prostředek vlastní, vyvíjí a udržuje.

Group (Skupina)

Segment skupiny názvu typu je volitelný. Definuje logické seskupení pro kolekci prostředků. Například prostředky, které spravují SQL Server, můžou používat SqlServer skupinu v názvu svého typu.

Plošný

Segment oblasti názvu typu je volitelný. Definuje seskupení pro kolekci prostředků podle účelu nebo komponenty vyšší úrovně. Například prostředky, které spravují součásti databáze SQL Server, můžou tuto oblast v názvu svého typu používatDatabase.

Name

Segment názvu typu je povinný. Identifikuje komponentu, kterou prostředek spravuje. Tento segment by měl být jednoúčelové podstatné jméno, pokud prostředek vždy nespravuje seznam součástí v jedné instanci prostředku. V takovém případě by název zdroje měl být množný tvar podstatného jména, které spravuje, nebo jednotný tvar podstatného jména následovaného slovem List, jako JeaRoleCapabilities nebo JeaRoleCapabilityList.