Edita

Comparteix a través de


Walkthrough: Use the cloud to configure group policy on Windows client devices with ADMX templates and Microsoft Intune

Note

This walkthrough was created as a technical workshop for Microsoft Ignite. It has more prerequisites than typical walkthroughs, as it compares using and configuring ADMX policies in Intune and on-premises.

Group policy administrative templates, also known as ADMX templates, include settings you can configure on Windows client devices, including PCs. The ADMX template settings are available by different services. These settings are used by Mobile Device Management (MDM) providers, including Microsoft Intune. For example, you can turn on Design Ideas in PowerPoint, set a home page in Microsoft Edge, and more.

Tip

For an overview of ADMX templates in Intune, including the ADMX templates built-in to Intune, go to Use Windows ADMX templates in Microsoft Intune.

For more information on ADMX policies, go to Understanding ADMX-backed policies.

These templates are built in to Microsoft Intune, and are available as Administrative templates profiles. In this profile, you configure the settings you want to include, and then "assign" this profile to your devices.

In this walkthrough, you will:

  • Get introduced to the Microsoft Intune admin center.
  • Create user groups and create device groups.
  • Compare the settings in Intune with on-premises ADMX settings.
  • Create different administrative templates, and configure the settings that target the different groups.

By the end of this lab, you can use Intune and Microsoft 365 to manage your users, and deploy administrative templates.

This feature applies to:

  • Windows 11
  • Windows 10 version 1709 and newer

Tip

There are two ways to create an administrative template: Using a template, or using the Settings Catalog. This article focuses on using the Administrative Templates template. The Settings Catalog has more Administrative Template settings available. For the specific steps to use the Settings Catalog, go to Use the settings catalog to configure settings.

Prerequisites

  • A Microsoft 365 E3 or E5 subscription, which includes Intune and Microsoft Entra ID P1 or P2. If you don't have an E3 or E5 subscription, try it for free.

    For more information on what you get with the different Microsoft 365 licenses, go to Transform your Enterprise with Microsoft 365.

  • Microsoft Intune is configured as the Intune MDM Authority. For more information, go to Set the mobile device management authority.

    Screenshot that shows how to set the MDM authority to Microsoft Intune in your tenant status.

  • On an on-premises Active Directory domain controller (DC):

    1. Copy the following Office and Microsoft Edge templates to the Central Store (sysvol folder):

    2. Create a group policy to push these templates to a Windows 10/11 Enterprise administrator computer in the same domain as the DC. In this walkthrough:

      • The group policy we created with these templates is called OfficeandEdge. You'll see this name in the images.
      • The Windows 10/11 Enterprise administrator computer we use is called the Admin computer.

      In some organizations, a domain administrator has two accounts:

      • A typical domain work account
      • A different domain administrator account used only for domain administrator tasks, such as group policy

      The purpose of this Admin computer is for administrators to sign in with their domain administrator account, and access tools designed for managing group policy.

  • On this Admin computer:

    • Sign in with a Domain Administrator account.

    • Add the RSAT: Group Policy Management Tools:

      1. Open the Settings app > System > Optional features > Add feature.

        If you use a version older than Windows 10 22H2, go to Settings > Apps > Apps & features > Optional features > Add feature.

      2. Select RSAT: Group Policy Management Tools > Add.

        Wait while Windows adds the feature. When complete, it eventually shows in the Windows Administrative Tools app.

        Screenshot that shows the Windows Administrative Tools apps, including the Group Policy Management app.

    • Be sure you have internet access and administrator rights to the Microsoft 365 subscription, which includes the Intune admin center.

Open the Intune admin center

  1. Open a chromium web browser, such as Microsoft Edge version 77 and later.

  2. Go to the Microsoft Intune admin center. Sign in with the following account:

    User: Enter the administrator account of your Microsoft 365 tenant subscription.
    Password: Enter its password.

This admin center is focused on device management, and includes Azure services, such as Microsoft Entra ID and Intune. You might not see the Microsoft Entra ID and Intune branding, but you're using them.

You can also open the Intune admin center from the Microsoft 365 admin center:

  1. Go to https://admin.microsoft.com.

  2. Sign in with the administrator account of your Microsoft 365 tenant subscription.

  3. Select Show all > All admin centers > Endpoint management. The Intune admin center opens.

    Screenshot that shows all the admin centers in the Microsoft 365 admin center.

Create groups, and add users

On-premises policies are applied in the LSDOU order - local, site, domain, and organizational unit (OU). In this hierarchy, OU policies overwrite local policies, domain policies overwrite site policies, and so on.

In Intune, policies are applied to users and groups you create. There isn't a hierarchy. For example:

  • If two policies update the same setting, then the setting shows as a conflict.
  • If two compliance policies are in conflict, then the most restrictive policy applies.
  • If two configuration profiles are in conflict, then the setting isn't applied.

For more information, go to Common questions, issues, and resolutions with device policies and profiles.

In these next steps, you create security groups, and add users to these groups. You can add a user to multiple groups. For example, it's normal for a user to have multiple devices, such as a Surface Pro for work, and an Android mobile device for personal. And, it's normal for a person to access organizational resources from these multiple devices.

  1. In the Intune admin center, select Groups > New group.

  2. Enter the following settings:

    • Group type: Select Security.
    • Group name: Enter All Windows 10 student devices.
    • Membership type: Select Assigned.
  3. Select Members, and add some devices.

    Adding devices is optional. The goal is to practice creating groups, and knowing how to add devices. If you're using this walkthrough in a production environment, then be aware of what you're doing.

  4. Select > Create to save your changes.

    Don't see your group? Select Refresh.

  5. Select New group, and enter the following settings:

    • Group type: Select Security.

    • Group name: Enter All Windows devices.

    • Membership type: Select Dynamic Device.

    • Dynamic device members: Select Add dynamic query, and configure your query:

      • Property: Select deviceOSType.
      • Operator: Select Equals.
      • Value: Enter Windows.
      1. Select Add expression. Your expression is shown in the Rule syntax:

        Screenshot that shows how to create a dynamic query, and add expressions in a Microsoft Intune administrative template.

        When users or devices meet the criteria you enter, they're automatically added to the dynamic groups. In this example, devices are automatically added to this group when the operating system is Windows. If you're using this walkthrough in a production environment, then be careful. The goal is to practice creating dynamic groups.

      2. Save > Create to save your changes.

  6. Create the All Teachers group with the following settings:

    • Group type: Select Security.

    • Group name: Enter All Teachers.

    • Membership type: Select Dynamic User.

    • Dynamic user members: Select Add dynamic query, and configure your query:

      • Property: Select department.

      • Operator: Select Equals.

      • Value: Enter Teachers.

        1. Select Add expression. Your expression is shown in the Rule syntax.

          When users or devices meet the criteria you enter, they're automatically added to the dynamic groups. In this example, users are automatically added to this group when their department is Teachers. You can enter the department and other properties when users are added to your organization. If you're using this walkthrough in a production environment, then be careful. The goal is to practice creating dynamic groups.

        2. Save > Create to save your changes.

Talking points

  • Dynamic groups are a feature in Microsoft Entra ID P1 or P2. If you don't have Microsoft Entra ID P1 or P2, then you're licensed to only create assigned groups. For more information on dynamic groups, go to:

  • Microsoft Entra ID P1 or P2 includes other services that are commonly used when managing apps and devices, including multifactor authentication (MFA) and conditional access.

  • Many administrators ask when to use user groups and when to use device groups. For some guidance, go to User groups vs. device groups.

  • Remember, a user can belong to multiple groups. Consider some of the other dynamic user and device groups you can create, such as:

    • All Students
    • All Android devices
    • All iOS/iPadOS devices
    • Marketing
    • Human Resources
    • All Charlotte employees
    • All Redmond employees
    • West coast IT administrators
    • East coast IT administrators

The users and groups created are also seen in the Microsoft 365 admin center, Microsoft Entra ID in the Azure portal, and Microsoft Intune in the Azure portal. You can create and manage groups in all these areas for your tenant subscription. If your goal is device management, then use the Microsoft Intune admin center.

Review group membership

  1. In the Intune admin center, select Users > All users > select the name of any existing user.
  2. Review some of the information you can add or change. For example, look at the properties you can configure, such as Job Title, Department, City, Office location, and more. You can use these properties in your dynamic queries when creating dynamic groups.
  3. Select Groups to see the membership of this user. You can also remove the user from a group.
  4. Select some of the other options to see more information, and what you can do. For example, look at the assigned license, the user's devices, and more.

What did I just do?

In the Intune admin center, you created new security groups, and added existing users and devices to these groups. We use these groups in later steps in this tutorial.

Create a template in Intune

In this section, we create an administrative template in Intune, look at some settings in Group Policy Management, and compare the same setting in Intune. The goal is to show a setting in group policy, and show the same setting in Intune.

  1. In the Intune admin center, select Devices > Manage devices > Configuration > Create > New policy.

  2. Enter the following properties:

    • Platform: Select Windows 10 and later.
    • Profile type: Select Templates > Administrative Templates.
  3. Select Create.

  4. In Basics, enter the following properties:

    • Name: Enter a descriptive name for the profile. Name your profiles so you can easily identify them later. For example, enter Admin template - Windows 10 student devices.
    • Description: Enter a description for the profile. This setting is optional, but recommended.
  5. Select Next.

  6. In Configuration settings, All settings show an alphabetical list of all the settings. You can also filter settings that apply to devices (Computer configuration), and settings that apply to users (User configuration):

    Screenshot that shows how to apply ADMX template settings to users and devices in Microsoft Intune.

  7. Expand Computer configuration > Microsoft Edge > select SmartScreen settings. Notice the path to the policy, and all the available settings:

    Screenshot that shows how to see the Microsoft Edge SmartScreen policy settings in ADMX templates in Microsoft Intune.

  8. In search, enter download. Notice the policy settings are filtered:

    Screenshot that shows how to filter the Microsoft Edge SmartScreen policy settings in a Microsoft Intune ADMX template.

Open Group Policy Management

In this section, we show a policy in Intune and its matching policy in Group Policy Management Editor.

Compare a device policy

  1. On the Admin computer, open the Group Policy Management app.

    This app gets installed with RSAT: Group Policy Management Tools, which is an optional feature you add on Windows. Prerequisites (in this article) lists the steps to install it.

  2. Expand Domains > select your domain. For example, select contoso.net.

  3. Right-click the OfficeandEdge policy > Edit. The Group Policy Management Editor app opens.

    Screenshot that shows how to right-click the on-premises Office and Microsoft Edge ADMX group policy, and select Edit.

    OfficeandEdge is a group policy that includes the Office and Microsoft Edge ADMX templates. This policy is described in prerequisites (in this article).

  4. Expand Computer configuration > Policies > Administrative Templates > Control Panel > Personalization. Notice the available settings.

    Screenshot that shows how to expand Computer Configuration in on-premises Group Policy Management Editor, and go to Personalization.

    Double-click Prevent enabling lock screen camera, and see the available options:

    Screenshot that shows how to see the on-premises Computer configuration setting options in group policy.

  5. In the Intune admin center, go to your Admin template - Windows 10 student devices template.

  6. Select Computer configuration > Control Panel > Personalization. Notice the available settings:

    Screenshot that shows the personalization policy setting path in Microsoft Intune.

    The setting type is Device, and the path is /Control Panel/Personalization. This path is similar to what you just saw in Group Policy Management Editor. If you open the Prevent enabling lock screen camera setting, you see the same Not configured, Enabled, and Disabled options you see in Group Policy Management Editor.

Compare a user policy

  1. In your admin template, select Computer configuration > All settings, and search for inprivate browsing. Notice the path.

    Do the same for User configuration. Select All settings, and search for inprivate browsing.

  2. In Group Policy Management Editor, find the matching user and device settings:

    • Device: Expand Computer configuration > Policies > Administrative Templates > Windows components > Internet Explorer > Privacy > Turn off InPrivate Browsing.
    • User: Expand User configuration > Policies > Administrative Templates > Windows components > Internet Explorer > Privacy > Turn off InPrivate Browsing.

    Screenshot that shows how to turn off InPrivate Browsing in Internet Explorer using ADMX template.

Tip

To see the built-in Windows policies, you can also use GPEdit (Edit group policy app).

Compare a Microsoft Edge policy

  1. In the Intune admin center, go to your Admin template - Windows 10 student devices template.

  2. Expand Computer configuration > Microsoft Edge > Startup, homepage and new tab page. Notice the available settings.

    Do the same for User configuration.

  3. In Group Policy Management Editor, find these settings:

    • Device: Expand Computer configuration > Policies > Administrative Templates > Microsoft Edge > Startup, homepage and new tab page.
    • User: Expand User configuration > Policies > Administrative Templates > Microsoft Edge > Startup, homepage and new tab page

What did I just do?

You created an administrative template in Intune. In this template, we looked at some ADMX settings, and looked at the same ADMX settings in Group Policy Management.

Add settings to the Students admin template

In this template, we configure some Internet Explorer settings to lock down devices shared by multiple students.

  1. In your Admin template - Windows 10 student devices, expand Computer configuration, select All settings, and search for Turn off InPrivate Browsing:

    Screenshot that shows how to turn off InPrivate Browsing device policy in an administrative template in Microsoft Intune.

  2. Select the Turn off InPrivate Browsing setting. In this window, notice the description and values you can set. These options are similar to what you see in group policy.

  3. Select Enabled > OK to save your changes.

  4. Also configure the following Internet Explorer settings. Be sure to select OK to save your changes.

    • Allow drag and drop or copy and paste files

      • Type: Device
      • Path: \Windows Components\Internet Explorer\Internet Control Panel\Security Page\Internet Zone
      • Value: Disabled
    • Prevent ignoring certificate errors

      • Type: Device
      • Path: \Windows Components\Internet Explorer\Internet Control Panel
      • Value: Enabled
    • Disable changing home page settings

      • Type: User
      • Path: \Windows Components\Internet Explorer
      • Value: Enabled
      • Home page: Enter a URL, such as contoso.com.
  5. Clear your search filter. Notice the settings you configured are listed at the top:

    Screenshot that shows the configured ADMX settings are listed at the top in Microsoft Intune.

Assign your template

  1. In your template, select Next until you get to Assignments. Choose Select groups to include:

    Screenshot that shows how to select your administrative template profile from the Device Configuration profiles list in Microsoft Intune.

  2. A list of existing users and groups is shown. Select the All Windows 10 student devices group you created earlier > Select.

    If you're using this walkthrough in a production environment, then consider adding groups that are empty. The goal is to practice assigning your template.

  3. Select Next. In Review + create, select Create to save your changes.

As soon as the profile is saved, it applies to the devices when they check in with Intune. If the devices are connected to the internet, it can happen immediately. For more information on policy refresh times, go to How long does it take for devices to get a policy, profile, or app.

When assigning strict or restrictive policies and profiles, don't lock yourself out. Consider creating a group that's excluded from your policies and profiles. The idea is to have access to troubleshoot. Monitor this group to confirm it's being used as intended.

What did I just do?

In the Intune admin center, you created an administrative template device configuration profile, and assigned this profile to a group you created.

Create a OneDrive template

In this section, you create a OneDrive admin template in Intune to control some settings. These specific settings are chosen because they're commonly used by organizations.

  1. Create another profile (Devices > Manage devices > Configuration > Create > New policy).

  2. Enter the following properties:

    • Platform: Select Windows 10 and later.
    • Profile type: Select Templates > Administrative templates.
  3. Select Create.

  4. In Basics, enter the following properties:

    • Name: Enter Admin template - OneDrive policies that apply to all Windows 10 users.
    • Description: Enter a description for the profile. This setting is optional, but recommended.
  5. Select Next.

  6. In Configuration settings, configure the following settings. Be sure to select OK to save your changes:

    • Computer configuration:

      • Silently sign in users to the OneDrive sync client with their Windows credentials
        • Type: Device
        • Value: Enabled
      • Use OneDrive Files On-Demand
        • Type: Device
        • Value: Enabled
    • User configuration:

      • Prevent users from syncing personal OneDrive accounts
        • Type: User
        • Value: Enabled

Your settings look similar to the following settings:

Screenshot that shows how to create a OneDrive administrative template in Microsoft Intune.

For more information on OneDrive client settings, go to Use Group Policy to control OneDrive sync client settings.

Assign your template

  1. In your template, select Next until you get to Assignments. Choose Select groups to include:

  2. A list of existing users and groups is shown. Select the All Windows devices group you created earlier > Select.

    If you're using this walkthrough in a production environment, then consider adding groups that are empty. The goal is to practice assigning your template.

  3. Select Next. In Review + create, select Create to save your changes.

At this point, you created some administrative templates, and assigned them to groups you created. The next step is to create an administrative template using Windows PowerShell and the Microsoft Graph API for Intune.

Optional: Create a policy using PowerShell and Graph API

This section uses the following resources. We install these resources in this section.

  1. On the Admin computer, open Windows PowerShell as administrator:

    1. In your search bar, enter powershell.
    2. Right-click Windows PowerShell > Run as administrator.

    Screenshot that shows how to run Windows PowerShell as an administrator.

  2. Get and set the execution policy.

    1. Enter: get-ExecutionPolicy

      Write down what the policy is set to, which might be Restricted. When finished with the walkthrough, set it back to its original value.

    2. Enter: Set-ExecutionPolicy -ExecutionPolicy Unrestricted

    3. Enter Y to change it.

    PowerShell's execution policy helps prevent executing malicious scripts. For more information, go to About Execution Policies.

  3. Enter: Install-Module -Name Microsoft.Graph.Intune

    Enter Y if:

    • Asked to install the NuGet provider
    • Asked to install the modules from an untrusted repo

    It can take several minutes to complete. When finished, a prompt similar to the following prompt is shown:

    Screenshot that shows the Windows PowerShell prompt after installing a module.

  4. In your web browser, go to https://github.com/Microsoft/Intune-PowerShell-SDK/releases, and select the Intune-PowerShell-SDK_v6.1907.00921.0001.zip file.

    1. Select Save as, and select a folder you'll remember. c:\psscripts is a good choice.

    2. Open your folder, right-click the .zip file > Extract all > Extract. Your folder structure looks similar to the following folder:

      Screenshot that shows the Intune PowerShell SDK folder structure after being extracted.

  5. On the View tab, check File name extensions:

    Screenshot that shows how to select file name extensions on the view tab in Windows file explorer.

  6. In your folder, and go to c:\psscripts\Intune-PowerShell-SDK_v6.1907.00921.0001\drop\outputs\build\Release\net471. Right-click every .dll > Properties > Unblock.

    Screenshot that shows how to unblock the DLLs.

  7. In your Windows PowerShell app, enter:

    Import-Module c:\psscripts\Intune-PowerShell-SDK_v6.1907.00921.0001\drop\outputs\build\Release\net471\Microsoft.Graph.Intune.psd1
    

    Enter R if prompted to run from the untrusted publisher.

  8. Intune administrative templates use the beta version of Graph:

    1. Enter: Update-MSGraphEnvironment -SchemaVersion 'beta'

    2. Enter: Connect-MSGraph -AdminConsent

    3. When prompted, sign in with the same Microsoft 365 administrator account. These cmdlets create the policy in your tenant organization.

      User: Enter the administrator account of your Microsoft 365 tenant subscription.
      Password: Enter its password.

    4. Select Accept.

  9. Create the Test Configuration configuration profile. Enter:

    $configuration = Invoke-MSGraphRequest -Url https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfigurations -Content '{"displayName":"Test Configuration","description":"A test configuration created through PS"}' -HttpMethod POST
    

    When these cmdlets succeed, the profile is created. To confirm, go to the Intune admin center > Devices > Manage devices > Configuration. Your Test Configuration profile should be listed.

  10. Get all the SettingDefinitions. Enter:

    $settingDefinitions = Invoke-MSGraphRequest -Url https://graph.microsoft.com/beta/deviceManagement/groupPolicyDefinitions -HttpMethod GET
    
  11. Find the definition ID using the setting display name. Enter:

    $desiredSettingDefinition = $settingDefinitions.value | ? {$_.DisplayName -Match "Silently sign in users to the OneDrive sync app with their Windows credentials"}
    
  12. Configure a setting. Enter:

    $configuredSetting = Invoke-MSGraphRequest -Url "https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfigurations('$($configuration.id)')/definitionValues" -Content ("{""enabled"":""true"",""configurationType"":""policy"",""definition@odata.bind"":""https://graph.microsoft.com/beta/deviceManagement/groupPolicyDefinitions('$($desiredSettingDefinition.id)')""}") -HttpMethod POST
    
    Invoke-MSGraphRequest -Url "https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfigurations('$($configuration.id)')/definitionValues('$($configuredSetting.id)')" -Content ("{""enabled"":""false""}") -HttpMethod PATCH
    
    $configuredSetting = Invoke-MSGraphRequest -Url "https://graph.microsoft.com/beta/deviceManagement/groupPolicyConfigurations('$($configuration.id)')/definitionValues('$($configuredSetting.id)')" -HttpMethod GET
    

See your policy

  1. In the Intune admin center > Devices > Manage devices > Configuration > Refresh.
  2. Select your Test Configuration profile > Settings.
  3. In the drop-down list, select All products.

You see the Silently sign in users to the OneDrive sync client with their Windows credentials setting is configured.

Policy best practices

When you create policies and profiles in Intune, there are some recommendations and best practices to consider. For more information, go to policy and profile best practices.

Clean up resources

When no longer needed, you can:

  • Delete the groups you created:

    • All Windows 10 student devices
    • All Windows devices
    • All Teachers
  • Delete the admin templates you created:

    • Admin template - Windows 10 student devices
    • Admin template - OneDrive policies that apply to all Windows 10 users
    • Test Configuration
  • Set the Windows PowerShell execution policy back to its original value. The following example sets the execution policy to Restricted:

    Set-ExecutionPolicy -ExecutionPolicy Restricted
    

Next steps

In this tutorial, you got more familiar with the Microsoft Intune admin center, used the query builder to create dynamic groups, and created administrative templates in Intune to configure ADMX settings. You also compared using ADMX templates on-premises and in the cloud with Intune. As a bonus, you used PowerShell cmdlets to create an administrative template.

For more information on administrative templates in Intune, go to: