Contribute to the Community hub

Applies to: Configuration Manager (current branch)

Community hub fosters creativity by building on others work and having other people build on yours. GitHub already has industry-wide processes and tools built for sharing. Now, the Community hub can leverage those tools directly in the Configuration Manager console as foundational pieces for driving this new community. You can share the following objects for use by others in the Configuration Manager community:

  • CMPivot queries
  • Applications
  • Task sequences
  • Configuration items
  • Configuration baselines, including child configuration items
    • Baselines with software updates or version-specific references aren't supported
  • PowerShell Scripts
  • Reports
  • Power BI report templates

Prerequisites

  • All Community hub prerequisites and permissions
  • Configuration Manager version 2010 or later
  • Install the Microsoft Edge WebView2 extension for the Configuration Manager console.
  • A GitHub account
    • A GitHub account is only required to contribute and share content from the Your hub page.
    • If you don't already have a GitHub account, you can create one before you join.
    • If you don't wish to share, you can use contributions from others without having a GitHub account.

Important

Configuration Manager versions 2006 and earlier can’t sign into GitHub but can still download items. Using Community hub on Windows Server requires the WebView2 console extension and Configuration Manager version 2010 or later.

Most built-in security roles will have access to the Community hub node:

Role name View the hub Contribute hub content Download hub content
Remote Tools Operator No N/A N/A
Read Only Analyst Yes No No
All other roles Yes Yes Yes

Join the Community hub to contribute content

  1. Go to the Community hub node in the Community workspace.

  2. Select Your hub and you'll be prompted to sign into GitHub. If you don't have an account, you'll be redirected to GitHub where you can create one. A GitHub account is only required to contribute and share content from the Your hub page.

  3. Once you've signed into GitHub, select the Join button to join the Community hub.

    Join Configuration Manager's Community hub

  4. After joining, you'll see your membership request is pending. Your account needs approval by the Configuration Manager Content Curation team. Approvals are done once a day, so it may take up to one business day for your approval to be granted.

  5. Once you're granted access, you'll get an email from GitHub. Open the link in the email to accept the invitation.

    Important

    You must accept the invitation sent in the email otherwise you won't be able to contribute content.

Contribute content

Once you've accepted the invitation, you can contribute content.

  1. Go to Community > Community hub > Your hub.

  2. Select Add an Item to open the Contribute item wizard. Add an item to the Community hub

  3. Specify the Type of object you want to share from the drop-down menu. The following object types are available:

    • CMPivot queries
    • Applications
    • Task sequences
    • Configuration items
    • Configuration baselines, including child configuration items
      • Baselines with software updates or version-specific references aren't supported
    • PowerShell Scripts
    • Reports
    • Power BI report templates
  4. Select Browse to load your environment's object list for the selected type. The object's Name and Description (if available) will automatically load in the contribution wizard.

  5. Edit the following information to reflect what the community should see for your contribution:

    • Name: Name of your object
    • Description: The description of the object you're contributing.
  6. On the Organization page, select the GitHub Organization to use for organization branding if needed.

    • None is the default.
    • If your organization isn't listed, verify that the membership visibility is set to Public in your GitHub profile.
  7. Select Next to submit the contribution.

  8. Once the contribution is complete, you'll see the GitHub pull request (PR) link. The link is also emailed to you. You can paste the link into a browser to view the PR. Your PR will go though the standard GitHub merge process.

    • PRs should be submitted through the Configuration Manager console, not directly to the GitHub repository.
  9. Choose Close to exit the contribution wizard.

  10. Once the PR has been completed and merged, the new item will display in the Community hub home page for others to see.

Update contributed content

You can update content you've contributed to the Community hub.

  1. Select an item that you previously contributed. Currently, you can only edit items that you contributed.
  2. In the item details, select Push Update to open the contribute item wizard.
  3. Edit the Description of the item to note what changes were made.
  4. Select Next to upload the item.
  5. Once the item is uploaded, you'll be given the pull request URL of the change for monitoring.
  6. Select Close when you're done to exit the wizard.

Personalization and organization branding of contributed content

Starting in January 2021, your contributions are personalized. By default, your contributions include your personal GitHub profile picture. The default GitHub Identicon is used if you don't have a profile picture. All contributions you've submitted before January 2021 are automatically personalized using this default.

Public profile contribution screenshot

Community hub also allows new contributions to be branded instead of using the default personalization. You can brand a contribution to one of your organization memberships in GitHub that's publicly visible. When you choose to brand your contribution, the organization's profile picture is used rather than your personal profile picture. The organization's web page, Twitter handle, and company bio are included on the contribution. Branding to the organization identity allows for uniformity regardless of which user is submitting the contribution.

Branded contribution screenshot

To use branding:

Organization page in the Contribute item wizard

(Introduced in version 2006)

You can navigate to and reference items in the Configuration Manager console Community hub node with a direct link. Collaborate with your colleagues easily by sharing direct links to Community hub items. These deep links are currently only for items in the Community hub node of the console.

Prerequisites for direct links:

  • Configuration Manager console version 2006 or later
  • You can't use the local built-in administrator account when following a Community hub link.

Share an item:

  1. Go the item in the hub and select Share.
  2. Paste the copied link and share it with others.

Open a shared link:

  1. Open the link from a machine that has the Configuration Manager console installed.
  2. Select Launch the Community hub when prompted.
  3. The console opens directly to the script in the Community hub node.

Object type information

Configuration baselines

When you contribute a configuration baseline, each of the child configuration items is verified. The verification starts at the lowest nested level. This means that configuration items that are grandchildren are verified before direct child configuration items are. You can have up to 50 child configuration items and up to 4 nested levels. The following process occurs to ensure the configuration baseline is usable and complete:

  1. Check if the child configuration item is already in the Community hub. If the configuration item doesn't exist, it's created.
    • A configuration item with software updates or version-specific references will cause an error and the contribution will fail.
  2. If the configuration item already exists in the Community hub, verify the contributor is the author. If the contributor isn't the author, a new configuration item is created in Community hub.
  3. If the contributor is the author, check for local updates to the configuration item. If the configuration item changed, update the item in the Community hub.

Next steps

Learn more about creating and using the following objects: