Skip to content

Commit 9bc9e82

Browse files
authored
Merge pull request #6462 from aczechowski/cz-12927803-macos
macOS deprecation in ConfigMgr
2 parents fc8f413 + 2109f05 commit 9bc9e82

18 files changed

Lines changed: 118 additions & 124 deletions

memdocs/configmgr/apps/get-started/creating-mac-computer-applications.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Create Mac computer applications
33
titleSuffix: Configuration Manager
44
description: See which considerations you must take into account when you create and deploy applications for Mac computers.
5-
ms.date: 10/06/2016
5+
ms.date: 01/05/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-app
88
ms.topic: conceptual
@@ -15,6 +15,9 @@ ms.localizationpriority: medium
1515

1616
*Applies to: Configuration Manager (current branch)*
1717

18+
> [!IMPORTANT]
19+
> Starting in January 2022, this feature of Configuration Manager is deprecated.<!-- 12927803 --> For more information, see [Mac computers](../../core/plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
20+
1821
Keep the following considerations in mind when you create and deploy applications for Mac computers.
1922

2023
> [!IMPORTANT]

memdocs/configmgr/compliance/deploy-use/create-configuration-items-for-mac-os-x-devices-managed-with-the-client.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Create configuration items for macOS
33
titleSuffix: Configuration Manager
44
description: Use the Configuration Manager macOS X configuration item to manage settings for macOS devices.
5-
ms.date: 05/08/2019
5+
ms.date: 01/04/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-compliance
88
ms.topic: how-to
@@ -14,6 +14,9 @@ ms.localizationpriority: medium
1414

1515
# Create configuration items for macOS X devices
1616

17+
> [!IMPORTANT]
18+
> Starting in January 2022, this feature of Configuration Manager is deprecated.<!-- 12927803 --> For more information, see [Mac computers](../../core/plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
19+
1720
Use the Configuration Manager **Mac OS X (custom)** configuration item to manage settings for macOS X devices that are managed by the Configuration Manager client.
1821

1922
The macOS X operating system uses property list (.plist) files to store application settings. Use compliance settings to evaluate and remediate settings in a property list file. You can also manage macOS X settings by writing a shell script that returns a value that you can evaluate and remediate for compliance.

memdocs/configmgr/compliance/get-started/get-started-with-compliance-settings.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Get started with compliance settings
33
titleSuffix: Configuration Manager
44
description: Learn about core concepts and how compliance settings work
5-
ms.date: 04/05/2021
5+
ms.date: 01/04/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-compliance
88
ms.topic: conceptual
@@ -11,6 +11,7 @@ ms.author: mstewart
1111
manager: dougeby
1212
ms.localizationpriority: medium
1313
---
14+
1415
# Get started with compliance settings in Configuration Manager
1516

1617
*Applies to: Configuration Manager (current branch)*
@@ -36,6 +37,9 @@ Configuration items fall into two main categories:
3637
| Windows Phone devices (enrolled with on-premises MDM) | Select settings from a predefined list. |
3738
| Mac computers (with the Configuration Manager client) | Create custom configuration items to assess objects such as macOS preferences, and results returned by a script. |
3839

40+
> [!NOTE]
41+
> On-premises MDM and the Configuration Manager client for macOS are both deprecated. For more information, see [Removed and deprecated features for Configuration Manager](../../core/plan-design/changes/deprecated/removed-and-deprecated-cmfeatures.md).<!-- 12454901,12927803 -->
42+
3943
## What is a configuration item?
4044

4145
A configuration item is a container that stores specific information. The information you configure depends on the configuration item type. Configuration items can include the following information:

memdocs/configmgr/core/clients/deploy/deploy-clients-to-macs.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Deploy Mac clients
33
titleSuffix: Configuration Manager
44
description: Learn how to deploy clients to Mac computers in Configuration Manager.
5-
ms.date: 12/10/2018
5+
ms.date: 01/05/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-client
88
ms.topic: conceptual
@@ -16,6 +16,9 @@ ms.localizationpriority: medium
1616

1717
*Applies to: Configuration Manager (current branch)*
1818

19+
> [!IMPORTANT]
20+
> Starting in January 2022, this feature of Configuration Manager is deprecated.<!-- 12927803 --> For more information, see [Mac computers](../../plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
21+
1922
This article describes how to deploy and maintain the Configuration Manager client on Mac computers. To learn about what you have to configure before deploying clients to Mac computers, see [Prepare to deploy client software to Macs](prepare-to-deploy-mac-clients.md).
2023

2124
When you install a new client for Mac computers, you might have to also install Configuration Manager updates to reflect the new client information in the Configuration Manager console.
@@ -77,7 +80,10 @@ For more information, see [How to configure client settings](configure-client-se
7780

7881
## <a name="bkmk_download"></a> Download the client for macOS
7982

80-
1. Download the macOS client file package, [Microsoft Endpoint Configuration Manager - macOS Client (64-bit)](https://www.microsoft.com/download/details.aspx?id=100850). Save **ConfigmgrMacClient.msi** to a computer that runs Windows. This file isn't on the Configuration Manager installation media.
83+
> [!NOTE]
84+
> The macOS client installation package isn't available for new deployments, but existing deployments are supported until December 31, 2022.<!-- 12927803 -->
85+
86+
1. Save **ConfigmgrMacClient.msi** to a computer that runs Windows. This file isn't on the Configuration Manager installation media.
8187

8288
2. Run the installer on the Windows computer. Extract the Mac client package, **Macclient.dmg**, to a folder on the local disk. The default path is `C:\Program Files\Microsoft\System Center Configuration Manager for Mac client`.
8389

memdocs/configmgr/core/clients/deploy/plan/determine-the-site-system-roles-for-clients.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Site system roles for clients
33
titleSuffix: Configuration Manager
44
description: Determine site system roles for clients in Configuration Manager.
5-
ms.date: 04/05/2021
5+
ms.date: 01/04/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-client
88
ms.topic: conceptual
@@ -72,6 +72,9 @@ The reports aren't needed to deploy clients. You can see some deployment informa
7272

7373
## Enrollment point and enrollment proxy point
7474

75+
> [!IMPORTANT]
76+
> With the deprecation of on-premises MDM and the Configuration Manager client for macOS, these site system roles are also deprecated. For more information, see [Removed and deprecated features for Configuration Manager](../../../plan-design/changes/deprecated/removed-and-deprecated-cmfeatures.md).<!-- 12454901,12927803 -->
77+
7578
Configuration Manager requires the enrollment point and the enrollment proxy point to enroll mobile devices and to enroll certificates for Mac computers. You don't need these site system roles in the following situations:
7679

7780
- You plan to manage mobile devices by using the Exchange Server connector

memdocs/configmgr/core/clients/deploy/plan/planning-for-client-deployment-to-mac-computers.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Planning client deployment to Mac computers
33
titleSuffix: Configuration Manager
44
description: Plan for client deployment to Mac computers in Configuration Manager.
5-
ms.date: 04/23/2017
5+
ms.date: 01/05/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-client
88
ms.topic: conceptual
@@ -15,6 +15,9 @@ ms.localizationpriority: medium
1515

1616
*Applies to: Configuration Manager (current branch)*
1717

18+
> [!IMPORTANT]
19+
> Starting in January 2022, this feature of Configuration Manager is deprecated.<!-- 12927803 --> For more information, see [Mac computers](../../../plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
20+
1821
You can install the Configuration Manager client on Mac computers that run macOS X and use the following management capabilities:
1922

2023
- **Hardware inventory**

memdocs/configmgr/core/clients/deploy/prepare-to-deploy-mac-clients.md

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Prepare to deploy the client to Macs
33
titleSuffix: Configuration Manager
44
description: Configuration tasks prior to deploying the Configuration Manager client to Macs.
5-
ms.date: 10/07/2021
5+
ms.date: 01/05/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-client
88
ms.topic: conceptual
@@ -16,18 +16,13 @@ ms.localizationpriority: medium
1616

1717
*Applies to: Configuration Manager (current branch)*
1818

19-
Follow these steps to make sure that you're ready to [deploy the Configuration Manager client to Mac computers](deploy-clients-to-macs.md).
20-
21-
22-
23-
## Mac prerequisites
19+
> [!IMPORTANT]
20+
> Starting in January 2022, this feature of Configuration Manager is deprecated.<!-- 12927803 --> For more information, see [Mac computers](../../plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
2421
25-
The Mac client installation package isn't supplied with the Configuration Manager media. Download it from the [Microsoft Download Center](https://www.microsoft.com/download/details.aspx?id=100850).
22+
Follow these steps to make sure that you're ready to [deploy the Configuration Manager client to Mac computers](deploy-clients-to-macs.md).
2623

2724
For the list of supported versions, see [Supported operating systems for clients and devices](../../plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
2825

29-
30-
3126
## Certificate requirements
3227

3328
Client installation and management for Mac computers requires public key infrastructure (PKI) certificates. PKI certificates secure the communication between the Mac computers and the Configuration Manager site by using mutual authentication and encrypted data transfers. Configuration Manager can request and install a user client certificate. It uses Certificate Services with an enterprise certification authority, and the Configuration Manager enrollment point and enrollment proxy point. You can also request and install a computer certificate independently from Configuration Manager. This certificate must meet the Configuration Manager certificate requirements.

memdocs/configmgr/core/clients/deploy/prerequisites-for-deploying-clients-to-mobile-devices.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Mobile device client prerequisites
33
titleSuffix: Configuration Manager
44
description: Learn about the prerequisites for deploying the Configuration Manager client to mobile devices.
5-
ms.date: 08/02/2021
5+
ms.date: 01/05/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-client
88
ms.topic: conceptual
@@ -16,6 +16,11 @@ ms.localizationpriority: medium
1616

1717
*Applies to: Configuration Manager (current branch)*
1818

19+
> [!IMPORTANT]
20+
> On-premises MDM and the Configuration Manager client for macOS are both [deprecated](../../plan-design/changes/deprecated/removed-and-deprecated-cmfeatures.md).<!-- 12454901,12927803 -->
21+
>
22+
> Migrate management of macOS and mobile devices to Microsoft Intune. For more information, see [Supported clients and devices](../../plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
23+
1924
Deploying Configuration Manager clients in your environment has the following external dependencies and dependencies within the product.
2025

2126
For more information on the minimum hardware and OS requirements for the Configuration Manager client, see [Supported configurations](../../plan-design/configs/supported-configurations.md).

memdocs/configmgr/core/clients/manage/maintain-mac-clients.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Maintain Mac clients
33
titleSuffix: Configuration Manager
44
description: Maintenance tasks for Configuration Manager Mac clients.
5-
ms.date: 04/23/2017
5+
ms.date: 01/05/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-client
88
ms.topic: conceptual
@@ -15,6 +15,9 @@ ms.localizationpriority: medium
1515
# Maintain Mac clients
1616
*Applies to: Configuration Manager (current branch)*
1717

18+
> [!IMPORTANT]
19+
> Starting in January 2022, this feature of Configuration Manager is deprecated.<!-- 12927803 --> For more information, see [Mac computers](../../plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
20+
1821
Here are procedures for uninstalling Mac clients and for renewing their certificates.
1922

2023
## Uninstalling the Mac client

memdocs/configmgr/core/clients/manage/upgrade/upgrade-clients-on-mac-computers.md

Lines changed: 33 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Upgrade macOS clients
33
titleSuffix: Configuration Manager
44
description: Upgrade the Configuration Manager client on Mac computers.
5-
ms.date: 09/10/2019
5+
ms.date: 01/05/2022
66
ms.prod: configuration-manager
77
ms.technology: configmgr-client
88
ms.topic: conceptual
@@ -16,14 +16,20 @@ ms.localizationpriority: medium
1616

1717
*Applies to: Configuration Manager (current branch)*
1818

19+
> [!IMPORTANT]
20+
> Starting in January 2022, this feature of Configuration Manager is deprecated.<!-- 12927803 --> For more information, see [Mac computers](../../../plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
21+
1922
Follow the high-level steps in this article to upgrade the client for Mac computers by using a Configuration Manager application. You can also download the Mac client installation file, copy it to a shared network location or a local folder on the Mac computer, and then instruct users to manually run the installation.
2023

2124
> [!NOTE]
22-
> Before you do these steps, make sure that your Mac computer meets the prerequisites. See [Supported operating systems for Mac computers](../../../plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
25+
> Before you do these steps, make sure that your Mac computer meets the prerequisites. For more information, see [Supported operating systems for Mac computers](../../../plan-design/configs/supported-operating-systems-for-clients-and-devices.md#mac-computers).
2326
2427
## Download the latest Mac client
2528

26-
The Mac client for Configuration Manager isn't supplied on the Configuration Manager installation media. Download it from the Microsoft Download Center, [Microsoft Endpoint Configuration Manager - macOS Client (64-bit)](https://www.microsoft.com/download/details.aspx?id=100850). The Mac client installation files are contained in a Windows Installer file named **ConfigmgrMacClient.msi**.
29+
The Mac client for Configuration Manager isn't supplied on the Configuration Manager installation media. The Mac client installation files are contained in a Windows Installer file named **ConfigmgrMacClient.msi**.
30+
31+
> [!NOTE]
32+
> The macOS client installation package isn't available for new deployments, but existing deployments are supported until December 31, 2022.<!-- 12927803 -->
2733
2834
## Create the Mac client installation file
2935

@@ -65,29 +71,29 @@ Use this procedure to prevent the Computer Enrollment Wizard from running, and t
6571

6672
1. Add the following script to the setting:
6773

68-
``` Shell
69-
#!/bin/sh
70-
echo "Starting script\n"
71-
echo "Changing directory to MAC Client\n"
72-
cd /Users/Administrator/Desktop/'MAC Client'/
73-
echo "Import root cert\n"
74-
/usr/bin/sudo /usr/bin/security import /Users/Administrator/Desktop/'MAC Client'/Root.pfx -A -k /Library/Keychains/System.Keychain -P ROOT
75-
echo "Using openssl to convert pfx to a crt\n"
76-
/usr/bin/sudo openssl pkcs12 -in /Users/Administrator/Desktop/'MAC Client'/Root.pfx -out Root1.crt -nokeys -clcerts -passin pass:ROOT
77-
echo "Adding trust to root cert\n"
78-
/usr/bin/sudo /usr/bin/security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.Keychain Root1.crt
79-
echo "Import client cert\n"
80-
/usr/bin/sudo /usr/bin/security import /Users/Administrator/Desktop/'MAC Client'/MacClient.pfx -A -k /Library/Keychains/System.Keychain -P MAC
81-
echo "Executing ccmclient with MP\n"
82-
sudo ./ccmsetup -MP https://SCCM34387.SCCM34387DOM.NET/omadm/cimhandler.ashx
83-
echo "Editing Plist file\n"
84-
sudo /usr/libexec/Plistbuddy -c 'Add:SubjectName string CMMAC003L' /Library/'Application Support'/Microsoft/CCM/ccmclient.plist
85-
echo "Changing directory to CCM\n"
86-
cd /Library/'Application Support'/Microsoft/CCM/
87-
echo "Making connection to the server\n"
88-
sudo open ./CCMClient
89-
echo "Ending Script\n"
90-
exit
91-
```
74+
``` Shell
75+
#!/bin/sh
76+
echo "Starting script\n"
77+
echo "Changing directory to MAC Client\n"
78+
cd /Users/Administrator/Desktop/'MAC Client'/
79+
echo "Import root cert\n"
80+
/usr/bin/sudo /usr/bin/security import /Users/Administrator/Desktop/'MAC Client'/Root.pfx -A -k /Library/Keychains/System.Keychain -P ROOT
81+
echo "Using openssl to convert pfx to a crt\n"
82+
/usr/bin/sudo openssl pkcs12 -in /Users/Administrator/Desktop/'MAC Client'/Root.pfx -out Root1.crt -nokeys -clcerts -passin pass:ROOT
83+
echo "Adding trust to root cert\n"
84+
/usr/bin/sudo /usr/bin/security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.Keychain Root1.crt
85+
echo "Import client cert\n"
86+
/usr/bin/sudo /usr/bin/security import /Users/Administrator/Desktop/'MAC Client'/MacClient.pfx -A -k /Library/Keychains/System.Keychain -P MAC
87+
echo "Executing ccmclient with MP\n"
88+
sudo ./ccmsetup -MP https://SCCM34387.SCCM34387DOM.NET/omadm/cimhandler.ashx
89+
echo "Editing Plist file\n"
90+
sudo /usr/libexec/Plistbuddy -c 'Add:SubjectName string CMMAC003L' /Library/'Application Support'/Microsoft/CCM/ccmclient.plist
91+
echo "Changing directory to CCM\n"
92+
cd /Library/'Application Support'/Microsoft/CCM/
93+
echo "Making connection to the server\n"
94+
sudo open ./CCMClient
95+
echo "Ending Script\n"
96+
exit
97+
```
9298

9399
1. Add the configuration item to a [configuration baseline](../../../../compliance/deploy-use/create-configuration-baselines.md). Then [deploy the configuration baseline](../../../../compliance/deploy-use/deploy-configuration-baselines.md) to all Mac computers that install a certificate independently from Configuration Manager.

0 commit comments

Comments
 (0)