Freigeben über

Vollständig qualifizierte DSC-Ressourcentypnamensschemareferenz

  • Artikel

Übersicht

Identifiziert eine DSC-Ressource.

Metadaten

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+$

Beschreibung

DSC-Ressourcen werden durch ihren vollqualifizierten Typnamen identifiziert. Werte dieses Typs werden verwendet, um eine Ressource in Konfigurationsdokumenten und als Wert des --resource Flags anzugeben, wenn die dsc resource * Befehle verwendet werden.

Der vollqualifizierte Typname einer Ressource verwendet die folgende Syntax:

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

Jedes Segment muss aus alphanumerischen Zeichen und Unterstrichen bestehen. Andere Zeichen sind nicht zulässig. Jede Ressource muss ein owner und ein namedefinieren. Verwenden Sie die group Komponenten und area , um Ressourcen in verwandten Namespaces zu organisieren. Beispiel:

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

Typnamensegmente

Besitzer

Das Besitzersegment des Typnamens ist obligatorisch. Es identifiziert die Person oder organization, die die Ressource besitzt, entwickelt und verwaltet.

Group

Das Gruppensegment des Typnamens ist optional. Sie definiert eine logische Gruppierung für eine Sammlung von Ressourcen. Beispielsweise können Ressourcen, die SQL Server verwalten, die SqlServer Gruppe in ihrem Typnamen verwenden.

Bereich

Das Bereichssegment des Typnamens ist optional. Es definiert eine Gruppierung für eine Sammlung von Ressourcen nach Zweck oder einer übergeordneten Komponente. Beispielsweise können Ressourcen, die Komponenten einer SQL Server Datenbank verwalten, den Database Bereich in ihrem Typnamen verwenden.

Name

Das Namenssegment des Typnamens ist obligatorisch. Sie identifiziert die Komponente, die von der Ressource verwaltet wird. Dieses Segment sollte ein einzelnes Nomen sein, es sei denn, die Ressource verwaltet immer eine Liste von Komponenten in einer einzelnen Ressource instance. In diesem Fall sollte der Ressourcenname die Pluralform des von ihr verwalteten Nomens oder die Singularform des Nomens sein, gefolgt vom Wort List, wie JeaRoleCapabilities oder JeaRoleCapabilityList.