Afficher en anglais

Partage via

Contribution aux articles de référence csp

  • Article

Les articles de référence csp sont générés automatiquement à l’aide des fichiers DDF (Device Description Framework) v2 qui définissent le csp. Le cas échéant, la définition csp inclut un mappage à une stratégie de groupe. L’automatisation utilise ce mappage, si possible, pour fournir une description conviviale des stratégies CSP.

Important

Chaque article csp automatisé fournit des sections modifiables pour fournir des informations supplémentaires sur le csp, les stratégies au sein du csp et des exemples d’utilisation. Toutes les modifications en dehors des sections modifiables désignées sont remplacées par l’automatisation.

Structure d’article CSP

Chaque article csp automatisé est divisé en trois sections.

Remarque

Pour afficher ces sections, consultez l’article que vous souhaitez mettre à jour, puis sélectionnez l’icône Crayon . Capture d’écran montrant l’icône Crayon pour modifier un article publié

  1. En-tête : l’en-tête inclut le nom du fournisseur de solutions Cloud et fournit une section modifiable dans laquelle des informations supplémentaires sur le csp peuvent être fournies.

    Capture d’écran de la section d’en-tête CSP

  2. Stratégies : la section stratégies contient une liste de stratégies, où chaque stratégie a une section modifiable pour fournir des informations et des exemples supplémentaires.

    Capture d’écran de la section stratégie CSP

  3. Pied de page : le pied de page indique la fin de l’article CSP et fournit une section modifiable dans laquelle vous pouvez fournir plus d’informations sur le csp.

    Capture d’écran de la section du pied de page CSP

Fournir des commentaires sur la documentation

Les articles CSP sont automatisés à l’aide des fichiers DDF v2 et ADMX, qui font partie du codebase Windows. Intune catalogue de paramètres utilise également les fichiers DDF v2 pour présenter les paramètres et le texte d’aide. Par conséquent, les commentaires de ces articles sont mieux traités lorsqu’ils sont envoyés directement à l’équipe d’ingénierie à l’aide de l’application Hub de commentaires. Les articles de référence csp et le catalogue de paramètres Intune sont régulièrement mis à jour à l’aide de la dernière copie des fichiers DDF v2 et tirent parti des commentaires adressés par l’équipe d’ingénierie.

Les articles CSP automatisés contiennent également du contenu modifiable, qui est conservé par l’automatisation. Pour tout commentaire sur le contenu modifiable, utilisez le guide de contributeur de la documentation Microsoft Learn.

Diagramme montrant le flux de commentaires pour les articles CSP

Utilisez ces sections pour déterminer où vous devez envoyer vos commentaires.

Commentaires sur la description de la stratégie

Les descriptions de stratégie proviennent de fichiers DDF ou ADMX et se trouvent dans la <[CSP-Name]-Description-Begin> section de la stratégie dans le fichier Markdown. <[CSP-Name]-Description-Begin> inclut également une référence à la source utilisée pour fournir la description de la stratégie.

Toutes les informations supplémentaires sur le paramètre de stratégie peuvent être fournies dans la [Policy-Name]-Editable-Begin section qui suit immédiatement la <[CSP-Name]-Description-End> section . Cette section permet d’étendre la description de la stratégie et est générée manuellement. Pour tout commentaire sur le contenu modifiable, utilisez le guide de contributeur de la documentation Microsoft Learn pour mettre à jour la section ou soumettre un problème.

Commentaires sur les exemples de stratégie

Les exemples de stratégie ne sont pas fournis par l’automatisation. Chaque nœud de stratégie dans le fichier Markdown comprend une [Policy-Name]-Examples-Begin section qui contient les exemples. Si l’exemple est incorrect ou doit être mis à jour, utilisez le guide de contributeur de la documentation Microsoft Learn pour mettre à jour l’exemple ou soumettre un problème.

Commentaires sur l’applicabilité de la stratégie

L’applicabilité de la stratégie est définie dans le fichier DDF v2 pour le fournisseur de services de configuration. Chaque nœud de stratégie dans le fichier Markdown inclut une [Policy-Name]-Applicability-Begin section qui contient l’applicabilité du système d’exploitation.

Si elle est incorrecte ou doit être mise à jour, envoyez des commentaires avec l’application Hub de commentaires.

Commentaires sur les valeurs autorisées par la stratégie

Les valeurs autorisées par la stratégie sont définies dans le fichier DDF v2 pour le fournisseur csp. Le cas échéant, chaque nœud de stratégie dans le fichier Markdown inclut une [Policy-Name]-AllowedValues-Begin section qui contient une table qui décrit les valeurs autorisées pour la stratégie.

Si ces valeurs sont incorrectes ou doivent être mises à jour, envoyez des commentaires avec l’application Hub de commentaires.

Commentaires sur le mappage de stratégie de groupe

Les mappages de stratégie de groupe sont définis dans le fichier DDF v2 pour le fournisseur csp. Le cas échéant, chaque nœud de stratégie dans le fichier Markdown inclut une [Policy-Name]-AdmxBacked-Begin section ou [Policy-Name]-GpMapping-Begin qui contient le mappage de stratégie de groupe.

Si ce mappage est incorrect, envoyez des commentaires avec l’application Hub de commentaires.

Autres commentaires

Pour tout autre commentaire, consultez le guide de contributeur de la documentation Microsoft Learn.

Envoyer des commentaires avec l’application Hub de commentaires

L’application Hub de commentaires vous permet d’informer Microsoft des problèmes que vous rencontrez lors de l’utilisation de Windows. Pour plus d’informations sur l’utilisation du Hub de commentaires, consultez Envoyer des commentaires à Microsoft avec l’application Hub de commentaires. Lorsque vous envoyez des commentaires pour la documentation CSP avec l’application Hub de commentaires, procédez comme suit :

  1. Entrez vos commentaires : préfixez votre résumé des commentaires avec [CSP Documentation] dans la section Résumer vos commentaires . Ajoutez des détails sur les commentaires, y compris le lien vers l’article CSP.
  2. Choisissez une catégorie : sélectionnez Sécurité et confidentialité > Compte professionnel ou scolaire comme catégorie.
  3. Rechercher des commentaires similaires : sélectionnez un commentaire existant qui correspond à vos commentaires, le cas échéant.
  4. Ajoutez plus de détails : sélectionnez Autre comme sous-catégorie.
  5. Sélectionnez Envoyer.