mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-18 11:53:37 +00:00
Merge branch 'master' into surface-2s-update
This commit is contained in:
Robert Mazzoli
@ -15344,7 +15344,7 @@
|
|||||||
},
|
},
|
||||||
{
|
{
|
||||||
"source_path": "devices/surface/surface-dock-updater.md",
|
"source_path": "devices/surface/surface-dock-updater.md",
|
||||||
"redirect_url": "surface/surface-dock-firmware-update",
|
"redirect_url": "/surface/surface-dock-firmware-update",
|
||||||
"redirect_document_id": true
|
"redirect_document_id": true
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
|
|||||||
@ -20,8 +20,8 @@ The [Microsoft Surface Hub Recovery Tool](https://www.microsoft.com/download/det
|
|||||||
|
|
||||||
To re-image the Surface Hub SSD using the Recovery Tool, you'll need to remove the SSD from the Surface Hub, connect the drive to the USB-to-SATA cable, and then connect the cable to the desktop PC on which the Recovery Tool is installed. For more information on how to remove the existing drive from your Surface Hub, see [Surface Hub SSD replacement](surface-hub-ssd-replacement.md).
|
To re-image the Surface Hub SSD using the Recovery Tool, you'll need to remove the SSD from the Surface Hub, connect the drive to the USB-to-SATA cable, and then connect the cable to the desktop PC on which the Recovery Tool is installed. For more information on how to remove the existing drive from your Surface Hub, see [Surface Hub SSD replacement](surface-hub-ssd-replacement.md).
|
||||||
|
|
||||||
>[!IMPORTANT]
|
> [!IMPORTANT]
|
||||||
>Do not let the device go to sleep or interrupt the download of the image file.
|
> Do not let the device go to sleep or interrupt the download of the image file.
|
||||||
|
|
||||||
If the tool is unsuccessful in reimaging your drive, please contact [Surface Hub Support](https://support.microsoft.com/help/4037644/surface-contact-surface-warranty-and-software-support).
|
If the tool is unsuccessful in reimaging your drive, please contact [Surface Hub Support](https://support.microsoft.com/help/4037644/surface-contact-surface-warranty-and-software-support).
|
||||||
|
|
||||||
@ -77,10 +77,7 @@ Install Surface Hub Recovery Tool on the host PC.
|
|||||||
|
|
||||||
5. When the download is complete, the tool instructs you to connect an SSD drive. If the tool is unable to locate the attached drive, there is a good chance that the cable being used is not reporting the name of the SSD to Windows. The imaging tool must find the name of the drive as "LITEON L CH-128V2S USB Device" before it can continue. For more information on how to remove the existing drive from your Surface Hub, see [Surface Hub SSD replacement](surface-hub-ssd-replacement.md).
|
5. When the download is complete, the tool instructs you to connect an SSD drive. If the tool is unable to locate the attached drive, there is a good chance that the cable being used is not reporting the name of the SSD to Windows. The imaging tool must find the name of the drive as "LITEON L CH-128V2S USB Device" before it can continue. For more information on how to remove the existing drive from your Surface Hub, see [Surface Hub SSD replacement](surface-hub-ssd-replacement.md).
|
||||||
|
|
||||||
|
|
||||||
~~~
|
|
||||||
|
|
||||||
~~~
|
|
||||||
|
|
||||||
6. When the drive is recognized, click **Start** to begin the re-imaging process. On the warning that all data on the drive will be erased, click **OK**.
|
6. When the drive is recognized, click **Start** to begin the re-imaging process. On the warning that all data on the drive will be erased, click **OK**.
|
||||||
|
|
||||||
|
|||||||
@ -40,7 +40,6 @@
|
|||||||
### [Surface firmware and driver updates](update.md)
|
### [Surface firmware and driver updates](update.md)
|
||||||
### [Manage Surface driver and firmware updates](manage-surface-pro-3-firmware-updates.md)
|
### [Manage Surface driver and firmware updates](manage-surface-pro-3-firmware-updates.md)
|
||||||
|
|
||||||
|
|
||||||
## Secure
|
## Secure
|
||||||
### [Manage Surface UEFI settings](manage-surface-uefi-settings.md)
|
### [Manage Surface UEFI settings](manage-surface-uefi-settings.md)
|
||||||
### [Advanced UEFI security features for Surface Pro 3](advanced-uefi-security-features-for-surface-pro-3.md)
|
### [Advanced UEFI security features for Surface Pro 3](advanced-uefi-security-features-for-surface-pro-3.md)
|
||||||
|
|||||||
@ -66,7 +66,7 @@ Harness the power of Surface, Windows, and Office connected together through the
|
|||||||
</div>
|
</div>
|
||||||
<div class="cardText">
|
<div class="cardText">
|
||||||
<h3>Manage</h3>
|
<h3>Manage</h3>
|
||||||
<p><a href="surface-wireless-connect.md">Optimizing Wi-Fi connectivity for Surface devices</a></p>
|
<p><a href="surface-wireless-connect.md">Optimize Wi-Fi connectivity for Surface devices</a></p>
|
||||||
<p><a href="maintain-optimal-power-settings-on-Surface-devices.md">Best practice power settings for Surface devices</a></p>
|
<p><a href="maintain-optimal-power-settings-on-Surface-devices.md">Best practice power settings for Surface devices</a></p>
|
||||||
<p><a href="battery-limit.md">Manage battery limit with UEFI</a></p>
|
<p><a href="battery-limit.md">Manage battery limit with UEFI</a></p>
|
||||||
</div>
|
</div>
|
||||||
@ -75,7 +75,6 @@ Harness the power of Surface, Windows, and Office connected together through the
|
|||||||
</div>
|
</div>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<ul class="panelContent cardsF">
|
<ul class="panelContent cardsF">
|
||||||
<li>
|
<li>
|
||||||
<div class="cardSize">
|
<div class="cardSize">
|
||||||
@ -124,7 +123,7 @@ Harness the power of Surface, Windows, and Office connected together through the
|
|||||||
<div class="card">
|
<div class="card">
|
||||||
<div class="cardText">
|
<div class="cardText">
|
||||||
<h3>Technical specifications</h3>
|
<h3>Technical specifications</h3>
|
||||||
<P><a href="https://www.microsoft.com/surface/devices/surface-pro/tech-specs" target="_blank">Surface Pro</a><p>
|
<P><a href="https://www.microsoft.com/surface/devices/surface-pro/tech-specs" target="_blank">Surface Pro</a></p>
|
||||||
<P><a href="https://www.microsoft.com/p/surface-book-2/8mcpzjjcc98c?activetab=pivot:techspecstab" target="_blank">Surface Book</a></p>
|
<P><a href="https://www.microsoft.com/p/surface-book-2/8mcpzjjcc98c?activetab=pivot:techspecstab" target="_blank">Surface Book</a></p>
|
||||||
<P><a href="https://www.microsoft.com/surface/devices/surface-studio/tech-specs" target="_blank">Surface Studio</a><p>
|
<P><a href="https://www.microsoft.com/surface/devices/surface-studio/tech-specs" target="_blank">Surface Studio</a><p>
|
||||||
<P><a href="https://www.microsoft.com/surface/devices/surface-go/tech-specs" target="_blank">Surface Go</a></p>
|
<P><a href="https://www.microsoft.com/surface/devices/surface-go/tech-specs" target="_blank">Surface Go</a></p>
|
||||||
@ -144,8 +143,7 @@ Harness the power of Surface, Windows, and Office connected together through the
|
|||||||
<P><a href="surface-diagnostic-toolkit-for-business-intro.md">Surface Diagnostic Toolkit for Business</a></p>
|
<P><a href="surface-diagnostic-toolkit-for-business-intro.md">Surface Diagnostic Toolkit for Business</a></p>
|
||||||
<P><a href="surface-enterprise-management-mode.md">SEMM and UEFI</a></p>
|
<P><a href="surface-enterprise-management-mode.md">SEMM and UEFI</a></p>
|
||||||
<P><a href="microsoft-surface-brightness-control.md">Surface Brightness Control</a></p>
|
<P><a href="microsoft-surface-brightness-control.md">Surface Brightness Control</a></p>
|
||||||
<P><a href="microsoft-surface-data-eraser.md">Surface Data Eraser</a></p>
|
<P><a href="battery-limit.md">Battery Limit setting</a></p>
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
@ -15,7 +15,7 @@ ms.audience: itpro
|
|||||||
---
|
---
|
||||||
# Microsoft Surface Dock Firmware Update
|
# Microsoft Surface Dock Firmware Update
|
||||||
|
|
||||||
This article explains how to use Microsoft Surface Dock Firmware Update, newly redesigned to automatically update Surface Dock firmware while running in the background on your Surface device. Once installed, it will update any Surface Dock attached to your Surface device.
|
This article explains how to use Microsoft Surface Dock Firmware Update, newly redesigned to automatically update Surface Dock firmware while running in the background on your Surface device. Once installed, it will update any Surface Dock attached to your Surface device.
|
||||||
|
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
>Microsoft Surface Dock Firmware Update supersedes the earlier Microsoft Surface Dock Updater tool, previously available for download as part of Surface Tools for IT. It was named Surface_Dock_Updater_vx.xx.xxx.x.msi (where x indicates the version of the tool). The earlier tool has been retired, is no longer available for download, and should not be used.
|
>Microsoft Surface Dock Firmware Update supersedes the earlier Microsoft Surface Dock Updater tool, previously available for download as part of Surface Tools for IT. It was named Surface_Dock_Updater_vx.xx.xxx.x.msi (where x indicates the version of the tool). The earlier tool has been retired, is no longer available for download, and should not be used.
|
||||||
@ -24,6 +24,7 @@ This article explains how to use Microsoft Surface Dock Firmware Update, newly r
|
|||||||
|
|
||||||
1. Download and install [Microsoft Surface Dock Firmware Update](https://www.microsoft.com/download/details.aspx?id=46703).
|
1. Download and install [Microsoft Surface Dock Firmware Update](https://www.microsoft.com/download/details.aspx?id=46703).
|
||||||
- The file is released in the following naming format: **Surface_Dock_FwUpdate_X.XX.XXX_Win10_XXXXX_XX.XXX.XXXXX_X.MSI** and installs by default to C:\Program Files\SurfaceUpdate.
|
- The file is released in the following naming format: **Surface_Dock_FwUpdate_X.XX.XXX_Win10_XXXXX_XX.XXX.XXXXX_X.MSI** and installs by default to C:\Program Files\SurfaceUpdate.
|
||||||
|
- Requires Surface devices running at least Windows 10 version 1803 or later.
|
||||||
|
|
||||||
2. Click **Start > All Apps > Microsoft Surface Dock Updater.** After you connect Surface Dock to your Surface device, the tool checks the firmware status while running in the background.
|
2. Click **Start > All Apps > Microsoft Surface Dock Updater.** After you connect Surface Dock to your Surface device, the tool checks the firmware status while running in the background.
|
||||||
|
|
||||||
|
|||||||
@ -38,7 +38,7 @@ The name of the folder in which you store the mandatory profile must use the cor
|
|||||||
| Client operating system version | Server operating system version | Profile extension |
|
| Client operating system version | Server operating system version | Profile extension |
|
||||||
| --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| Windows XP | Windows Server 2003 </br>Windows Server 2003 R2 | none |
|
| Windows XP | Windows Server 2003 </br>Windows Server 2003 R2 | none |
|
||||||
| Windows Vista</br>Windows 7 | Windows Server 2008</br>Windows Server 2008 R2 | v2 |
|
| Windows Vista</br>Windows 7 | Windows Server 2008 </br>Windows Server 2008 R2 | v2 |
|
||||||
| Windows 8 | Windows Server 2012 | v3 |
|
| Windows 8 | Windows Server 2012 | v3 |
|
||||||
| Windows 8.1 | Windows Server 2012 R2 | v4 |
|
| Windows 8.1 | Windows Server 2012 R2 | v4 |
|
||||||
| Windows 10, versions 1507 and 1511 | N/A | v5 |
|
| Windows 10, versions 1507 and 1511 | N/A | v5 |
|
||||||
@ -67,10 +67,8 @@ First, you create a default user profile with the customizations that you want,
|
|||||||
3. Uninstall any application you do not need or want from the PC. For examples on how to uninstall Windows 10 Application see [Remove-AppxProvisionedPackage](https://docs.microsoft.com/powershell/module/dism/remove-appxprovisionedpackage?view=winserver2012-ps). For a list of uninstallable applications, see [Understand the different apps included in Windows 10](https://docs.microsoft.com/windows/application-management/apps-in-windows-10).
|
3. Uninstall any application you do not need or want from the PC. For examples on how to uninstall Windows 10 Application see [Remove-AppxProvisionedPackage](https://docs.microsoft.com/powershell/module/dism/remove-appxprovisionedpackage?view=winserver2012-ps). For a list of uninstallable applications, see [Understand the different apps included in Windows 10](https://docs.microsoft.com/windows/application-management/apps-in-windows-10).
|
||||||
|
|
||||||
|
|
||||||
~~~
|
|
||||||
>[!NOTE]
|
>[!NOTE]
|
||||||
>It is highly recommended to uninstall unwanted or unneeded apps as it will speed up user sign-in times.
|
>It is highly recommended to uninstall unwanted or unneeded apps as it will speed up user sign-in times.
|
||||||
~~~
|
|
||||||
|
|
||||||
3. At a command prompt, type the following command and press **ENTER**.
|
3. At a command prompt, type the following command and press **ENTER**.
|
||||||
|
|
||||||
|
|||||||
@ -40,10 +40,10 @@ Added in Windows 10, version 1803. When set to 0, it enables proxy configuration
|
|||||||
|
|
||||||
Supported operations are Add, Get, Replace, and Delete.
|
Supported operations are Add, Get, Replace, and Delete.
|
||||||
|
|
||||||
> [!NOTE]
|
> [!Note]
|
||||||
> Per user proxy configuration setting is not supported.
|
> Per user proxy configuration setting is not supported using a configuration file, only modifying registry settings on a local machine.
|
||||||
|
|
||||||
<a href="" id="autodetect"></a>**AutoDetect**
|
<a href="" id="autodetect"></a>**AutoDetect**
|
||||||
Automatically detect settings. If enabled, the system tries to find the path to a PAC script.
|
Automatically detect settings. If enabled, the system tries to find the path to a PAC script.
|
||||||
|
|
||||||
Valid values:
|
Valid values:
|
||||||
@ -52,9 +52,9 @@ Valid values:
|
|||||||
<li>1 (default) - Enabled</li>
|
<li>1 (default) - Enabled</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
The data type is int. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported.
|
The data type is integer. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported.
|
||||||
|
|
||||||
<a href="" id="setupscripturl"></a>**SetupScriptUrl**
|
<a href="" id="setupscripturl"></a>**SetupScriptUrl**
|
||||||
Address to the PAC script you want to use.
|
Address to the PAC script you want to use.
|
||||||
|
|
||||||
The data type is string. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported.
|
The data type is string. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported.
|
||||||
@ -82,4 +82,55 @@ Valid values:
|
|||||||
<li>1 - Do not use proxy server for local addresses</li>
|
<li>1 - Do not use proxy server for local addresses</li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
The data type is int. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported.
|
The data type is integer. Supported operations are Get and Replace. Starting in Windows 10, version 1803, the Delete operation is also supported.
|
||||||
|
|
||||||
|
# Configuration Example
|
||||||
|
|
||||||
|
These generic code portions for the options **ProxySettingsPerUser**, **Autodetect**, and **SetupScriptURL** can be used for a specific operation, for example Replace. Only enter the portion of code needed in the **Replace** section.
|
||||||
|
```xml
|
||||||
|
<Replace>
|
||||||
|
<CmdID>1</CmdID>
|
||||||
|
<Item>
|
||||||
|
<Target>
|
||||||
|
<LocURI>./Vendor/MSFT/NetworkProxy/ProxySettingsPerUser</LocURI>
|
||||||
|
</Target>
|
||||||
|
<Meta>
|
||||||
|
<Format xmlns="syncml:metinf">int</Format>
|
||||||
|
<Type>text/plain</Type>
|
||||||
|
</Meta>
|
||||||
|
<Data>0</Data>
|
||||||
|
</Item>
|
||||||
|
</Replace>
|
||||||
|
```
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<Replace>
|
||||||
|
<CmdID>2</CmdID>
|
||||||
|
<Item>
|
||||||
|
<Target>
|
||||||
|
<LocURI>./Vendor/MSFT/NetworkProxy/AutoDetect</LocURI>
|
||||||
|
</Target>
|
||||||
|
<Meta>
|
||||||
|
<Format xmlns="syncml:metinf">int</Format>
|
||||||
|
<Type>text/plain</Type>
|
||||||
|
</Meta>
|
||||||
|
<Data>1</Data>
|
||||||
|
</Item>
|
||||||
|
</Replace>
|
||||||
|
```
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<Replace>
|
||||||
|
<CmdID>3</CmdID>
|
||||||
|
<Item>
|
||||||
|
<Target>
|
||||||
|
<LocURI>./Vendor/MSFT/NetworkProxy/SetupScriptUrl</LocURI>
|
||||||
|
</Target>
|
||||||
|
<Meta>
|
||||||
|
<Format xmlns="syncml:metinf">chr</Format>
|
||||||
|
<Type>text/plain</Type>
|
||||||
|
</Meta>
|
||||||
|
<Data>Insert the proxy PAC URL location here:</Data>
|
||||||
|
</Item>
|
||||||
|
</Replace>
|
||||||
|
```
|
||||||
|
|||||||
@ -6,17 +6,13 @@ ms.topic: article
|
|||||||
ms.prod: w10
|
ms.prod: w10
|
||||||
ms.technology: windows
|
ms.technology: windows
|
||||||
author: manikadhiman
|
author: manikadhiman
|
||||||
ms.date: 01/14/2019
|
ms.date: 09/23/2019
|
||||||
ms.reviewer:
|
ms.reviewer:
|
||||||
manager: dansimp
|
manager: dansimp
|
||||||
---
|
---
|
||||||
|
|
||||||
# Policy CSP - Storage
|
# Policy CSP - Storage
|
||||||
|
|
||||||
> [!WARNING]
|
|
||||||
> Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<hr/>
|
||||||
|
|
||||||
<!--Policies-->
|
<!--Policies-->
|
||||||
@ -627,7 +623,10 @@ ADMX Info:
|
|||||||
|
|
||||||
<!--/Scope-->
|
<!--/Scope-->
|
||||||
<!--Description-->
|
<!--Description-->
|
||||||
If you enable this policy setting, write access is denied to this removable storage class. If you disable or do not configure this policy setting, write access is allowed to this removable storage class. Note: To require that users write data to BitLocker-protected storage, enable the policy setting "Deny write access to drives not protected by BitLocker," which is located in "Computer Configuration\Administrative Templates\Windows Components\BitLocker Drive Encryption\Removable Data Drives."
|
If you enable this policy setting, write access is denied to this removable storage class. If you disable or do not configure this policy setting, write access is allowed to this removable storage class.
|
||||||
|
|
||||||
|
> [!Note]
|
||||||
|
> To require that users write data to BitLocker-protected storage, enable the policy setting "Deny write access to drives not protected by BitLocker," which is located in "Computer Configuration\Administrative Templates\Windows Components\BitLocker Drive Encryption\Removable Data Drives."
|
||||||
|
|
||||||
Supported values:
|
Supported values:
|
||||||
- 0 - Disable
|
- 0 - Disable
|
||||||
@ -647,7 +646,10 @@ ADMX Info:
|
|||||||
|
|
||||||
<!--/SupportedValues-->
|
<!--/SupportedValues-->
|
||||||
<!--Example-->
|
<!--Example-->
|
||||||
|
Example for setting the device custom OMA-URI setting to enable this policy:
|
||||||
|
To deny write access to removable storage within Intune’s custom profile, set OMA-URI to ```.\[device|user]\vendor\msft\policy\[config|result]\Storage/RemovableDiskDenyWriteAccess```, Data type to Integer, and Value to 1.
|
||||||
|
|
||||||
|
See [Use custom settings for Windows 10 devices in Intune](https://docs.microsoft.com/en-us/intune/custom-settings-windows-10) for information on how to create custom profiles.
|
||||||
<!--/Example-->
|
<!--/Example-->
|
||||||
<!--Validation-->
|
<!--Validation-->
|
||||||
|
|
||||||
|
|||||||
@ -1,315 +1,317 @@
|
|||||||
---
|
---
|
||||||
title: Windows Autopilot for existing devices
|
title: Windows Autopilot for existing devices
|
||||||
description: Windows Autopilot deployment
|
description: Windows Autopilot deployment
|
||||||
keywords: mdm, setup, windows, windows 10, oobe, manage, deploy, autopilot, ztd, zero-touch, partner, msfb, intune
|
keywords: mdm, setup, windows, windows 10, oobe, manage, deploy, autopilot, ztd, zero-touch, partner, msfb, intune
|
||||||
ms.reviewer: mniehaus
|
ms.reviewer: mniehaus
|
||||||
manager: laurawi
|
manager: laurawi
|
||||||
ms.prod: w10
|
ms.prod: w10
|
||||||
ms.mktglfcycl: deploy
|
ms.mktglfcycl: deploy
|
||||||
ms.localizationpriority: medium
|
ms.localizationpriority: medium
|
||||||
ms.sitesec: library
|
ms.sitesec: library
|
||||||
ms.pagetype: deploy
|
ms.pagetype: deploy
|
||||||
audience: itpro
|
audience: itpro
|
||||||
author: greg-lindsay
|
author: greg-lindsay
|
||||||
ms.author: greglin
|
ms.author: greglin
|
||||||
ms.collection: M365-modern-desktop
|
ms.collection: M365-modern-desktop
|
||||||
ms.topic: article
|
ms.topic: article
|
||||||
---
|
---
|
||||||
|
|
||||||
# Windows Autopilot for existing devices
|
# Windows Autopilot for existing devices
|
||||||
|
|
||||||
**Applies to: Windows 10**
|
**Applies to: Windows 10**
|
||||||
|
|
||||||
Modern desktop deployment with Windows Autopilot enables you to easily deploy the latest version of Windows 10 to your existing devices. The apps you need for work can be automatically installed. Your work profile is synchronized, so you can resume working right away.
|
Modern desktop deployment with Windows Autopilot enables you to easily deploy the latest version of Windows 10 to your existing devices. The apps you need for work can be automatically installed. Your work profile is synchronized, so you can resume working right away.
|
||||||
|
|
||||||
This topic describes how to convert Windows 7 or Windows 8.1 domain-joined computers to Windows 10 devices joined to either Azure Active Directory or Active Directory (Hybrid Azure AD Join) by using Windows Autopilot.
|
This topic describes how to convert Windows 7 or Windows 8.1 domain-joined computers to Windows 10 devices joined to either Azure Active Directory or Active Directory (Hybrid Azure AD Join) by using Windows Autopilot.
|
||||||
|
|
||||||
>[!NOTE]
|
>[!NOTE]
|
||||||
>Windows Autopilot for existing devices only supports user-driven Azure Active Directory and Hybrid Azure AD profiles. Self-deploying profiles are not supported.
|
>Windows Autopilot for existing devices only supports user-driven Azure Active Directory and Hybrid Azure AD profiles. Self-deploying profiles are not supported.
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
- System Center Configuration Manager Current Branch (1806) OR System Center Configuration Manager Technical Preview (1808)
|
- System Center Configuration Manager Current Branch (1806) OR System Center Configuration Manager Technical Preview (1808)
|
||||||
- The [Windows ADK](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) 1803 or later
|
- The [Windows ADK](https://developer.microsoft.com/en-us/windows/hardware/windows-assessment-deployment-kit) 1803 or later
|
||||||
- Note: Config Mgr 1806 or later is required to [support](https://docs.microsoft.com/sccm/core/plan-design/configs/support-for-windows-10#windows-10-adk) the Windows ADK 1809.
|
- Note: Config Mgr 1806 or later is required to [support](https://docs.microsoft.com/sccm/core/plan-design/configs/support-for-windows-10#windows-10-adk) the Windows ADK 1809.
|
||||||
- Assigned Microsoft Intune Licenses
|
- Assigned Microsoft Intune Licenses
|
||||||
- Azure Active Directory Premium
|
- Azure Active Directory Premium
|
||||||
- Windows 10 version 1809 or later imported into Config Mgr as an Operating System Image
|
- Windows 10 version 1809 or later imported into Config Mgr as an Operating System Image
|
||||||
|
- **Important**: See [Known issues](known-issues.md) if you are using Windows 10 1903 with Configuration Manager’s built-in **Windows Autopilot existing device** task sequence template. Currently, one of the steps in this task sequence must be edited to work properly with Windows 10, version 1903.
|
||||||
## Procedures
|
|
||||||
|
## Procedures
|
||||||
### Configure the Enrollment Status Page (optional)
|
|
||||||
|
### Configure the Enrollment Status Page (optional)
|
||||||
If desired, you can set up an [enrollment status page](https://docs.microsoft.com/windows/deployment/windows-autopilot/enrollment-status) for Autopilot using Intune.
|
|
||||||
|
If desired, you can set up an [enrollment status page](https://docs.microsoft.com/windows/deployment/windows-autopilot/enrollment-status) for Autopilot using Intune.
|
||||||
To enable and configure the enrollment and status page:
|
|
||||||
|
To enable and configure the enrollment and status page:
|
||||||
1. Open [Intune in the Azure portal](https://aka.ms/intuneportal).
|
|
||||||
2. Access **Intune > Device enrollment > Windows enrollment** and [Set up an enrollment status page](https://docs.microsoft.com/intune/windows-enrollment-status).
|
1. Open [Intune in the Azure portal](https://aka.ms/intuneportal).
|
||||||
3. Access **Azure Active Directory > Mobility (MDM and MAM) > Microsoft Intune** and [Configure automatic MDM enrollment](https://docs.microsoft.com/sccm/mdm/deploy-use/enroll-hybrid-windows#enable-windows-10-automatic-enrollment) and configure the MDM user scope for some or all users.
|
2. Access **Intune > Device enrollment > Windows enrollment** and [Set up an enrollment status page](https://docs.microsoft.com/intune/windows-enrollment-status).
|
||||||
|
3. Access **Azure Active Directory > Mobility (MDM and MAM) > Microsoft Intune** and [Configure automatic MDM enrollment](https://docs.microsoft.com/sccm/mdm/deploy-use/enroll-hybrid-windows#enable-windows-10-automatic-enrollment) and configure the MDM user scope for some or all users.
|
||||||
See the following examples.
|
|
||||||
|
See the following examples.
|
||||||
<br><br>
|
|
||||||
|
<br><br>
|
||||||
|
|
||||||
### Create the JSON file
|
|
||||||
|
### Create the JSON file
|
||||||
>[!TIP]
|
|
||||||
>To run the following commands on a computer running Windows Server 2012/2012 R2 or Windows 7/8.1, you must first download and install the [Windows Management Framework](https://www.microsoft.com/download/details.aspx?id=54616).
|
>[!TIP]
|
||||||
|
>To run the following commands on a computer running Windows Server 2012/2012 R2 or Windows 7/8.1, you must first download and install the [Windows Management Framework](https://www.microsoft.com/download/details.aspx?id=54616).
|
||||||
1. On an Internet connected Windows PC or Server open an elevated Windows PowerShell command window
|
|
||||||
2. Enter the following lines to install the necessary modules
|
1. On an Internet connected Windows PC or Server open an elevated Windows PowerShell command window
|
||||||
|
2. Enter the following lines to install the necessary modules
|
||||||
#### Install required modules
|
|
||||||
|
#### Install required modules
|
||||||
```powershell
|
|
||||||
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
|
```powershell
|
||||||
Install-Module AzureAD -Force
|
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
|
||||||
Install-Module WindowsAutopilotIntune -Force
|
Install-Module AzureAD -Force
|
||||||
```
|
Install-Module WindowsAutopilotIntune -Force
|
||||||
|
```
|
||||||
3. Enter the following lines and provide Intune administrative credentials
|
|
||||||
- In the following command, replace the example user principal name for Azure authentication (admin@M365x373186.onmicrosoft.com) with your user account. Be sure that the user account you specify has sufficient administrative rights.
|
3. Enter the following lines and provide Intune administrative credentials
|
||||||
|
- In the following command, replace the example user principal name for Azure authentication (admin@M365x373186.onmicrosoft.com) with your user account. Be sure that the user account you specify has sufficient administrative rights.
|
||||||
```powershell
|
|
||||||
Connect-AutopilotIntune -user admin@M365x373186.onmicrosoft.com
|
```powershell
|
||||||
```
|
Connect-AutopilotIntune -user admin@M365x373186.onmicrosoft.com
|
||||||
The password for your account will be requested using a standard Azure AD form. Type your password and then click **Sign in**.
|
```
|
||||||
<br>See the following example:
|
The password for your account will be requested using a standard Azure AD form. Type your password and then click **Sign in**.
|
||||||
|
<br>See the following example:
|
||||||
|
|
||||||
|
|
||||||
If this is the first time you’ve used the Intune Graph APIs, you’ll also be prompted to enable read and write permissions for Microsoft Intune PowerShell. To enable these permissions:
|
|
||||||
- Select **Consent on behalf or your organization**
|
If this is the first time you’ve used the Intune Graph APIs, you’ll also be prompted to enable read and write permissions for Microsoft Intune PowerShell. To enable these permissions:
|
||||||
- Click **Accept**
|
- Select **Consent on behalf or your organization**
|
||||||
|
- Click **Accept**
|
||||||
4. Next, retrieve and display all the Autopilot profiles available in the specified Intune tenant in JSON format:
|
|
||||||
|
4. Next, retrieve and display all the Autopilot profiles available in the specified Intune tenant in JSON format:
|
||||||
#### Retrieve profiles in Autopilot for existing devices JSON format
|
|
||||||
|
#### Retrieve profiles in Autopilot for existing devices JSON format
|
||||||
```powershell
|
|
||||||
Get-AutopilotProfile | ConvertTo-AutopilotConfigurationJSON
|
```powershell
|
||||||
```
|
Get-AutopilotProfile | ConvertTo-AutopilotConfigurationJSON
|
||||||
|
```
|
||||||
See the following sample output: (use the horizontal scroll bar at the bottom to view long lines)
|
|
||||||
<pre style="overflow-y: visible">
|
See the following sample output: (use the horizontal scroll bar at the bottom to view long lines)
|
||||||
PS C:\> Get-AutopilotProfile | ConvertTo-AutopilotConfigurationJSON
|
<pre style="overflow-y: visible">
|
||||||
{
|
PS C:\> Get-AutopilotProfile | ConvertTo-AutopilotConfigurationJSON
|
||||||
"CloudAssignedTenantId": "1537de22-988c-4e93-b8a5-83890f34a69b",
|
{
|
||||||
"CloudAssignedForcedEnrollment": 1,
|
"CloudAssignedTenantId": "1537de22-988c-4e93-b8a5-83890f34a69b",
|
||||||
"Version": 2049,
|
"CloudAssignedForcedEnrollment": 1,
|
||||||
"Comment_File": "Profile Autopilot Profile",
|
"Version": 2049,
|
||||||
"CloudAssignedAadServerData": "{\"ZeroTouchConfig\":{\"CloudAssignedTenantUpn\":\"\",\"ForcedEnrollment\":1,\"CloudAssignedTenantDomain\":\"M365x373186.onmicrosoft.com\"}}",
|
"Comment_File": "Profile Autopilot Profile",
|
||||||
"CloudAssignedTenantDomain": "M365x373186.onmicrosoft.com",
|
"CloudAssignedAadServerData": "{\"ZeroTouchConfig\":{\"CloudAssignedTenantUpn\":\"\",\"ForcedEnrollment\":1,\"CloudAssignedTenantDomain\":\"M365x373186.onmicrosoft.com\"}}",
|
||||||
"CloudAssignedDomainJoinMethod": 0,
|
"CloudAssignedTenantDomain": "M365x373186.onmicrosoft.com",
|
||||||
"CloudAssignedOobeConfig": 28,
|
"CloudAssignedDomainJoinMethod": 0,
|
||||||
"ZtdCorrelationId": "7F9E6025-1E13-45F3-BF82-A3E8C5B59EAC"
|
"CloudAssignedOobeConfig": 28,
|
||||||
}</pre>
|
"ZtdCorrelationId": "7F9E6025-1E13-45F3-BF82-A3E8C5B59EAC"
|
||||||
|
}</pre>
|
||||||
Each profile is encapsulated within braces **{ }**. In the previous example, a single profile is displayed.
|
|
||||||
|
Each profile is encapsulated within braces **{ }**. In the previous example, a single profile is displayed.
|
||||||
See the following table for a description of properties used in the JSON file.
|
|
||||||
|
See the following table for a description of properties used in the JSON file.
|
||||||
|
|
||||||
| Property | Description |
|
|
||||||
|------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
| Property | Description |
|
||||||
| Version (number, optional) | The version number that identifies the format of the JSON file. For Windows 10 1809, the version specified must be 2049. |
|
|------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
| CloudAssignedTenantId (guid, required) | The Azure Active Directory tenant ID that should be used. This is the GUID for the tenant, and can be found in properties of the tenant. The value should not include braces. |
|
| Version (number, optional) | The version number that identifies the format of the JSON file. For Windows 10 1809, the version specified must be 2049. |
|
||||||
| CloudAssignedTenantDomain (string, required) | The Azure Active Directory tenant name that should be used, e.g. tenant.onmicrosoft.com. |
|
| CloudAssignedTenantId (guid, required) | The Azure Active Directory tenant ID that should be used. This is the GUID for the tenant, and can be found in properties of the tenant. The value should not include braces. |
|
||||||
| CloudAssignedOobeConfig (number, required) | This is a bitmap that shows which Autopilot settings were configured. Values include: SkipCortanaOptIn = 1, OobeUserNotLocalAdmin = 2, SkipExpressSettings = 4, SkipOemRegistration = 8, SkipEula = 16 |
|
| CloudAssignedTenantDomain (string, required) | The Azure Active Directory tenant name that should be used, e.g. tenant.onmicrosoft.com. |
|
||||||
| CloudAssignedDomainJoinMethod (number, required) | This property specifies whether the device should join Azure Active Directory or Active Directory (Hybrid Azure AD Join). Values include: Active AD Join = 0, Hybrid Azure AD Join = 1 |
|
| CloudAssignedOobeConfig (number, required) | This is a bitmap that shows which Autopilot settings were configured. Values include: SkipCortanaOptIn = 1, OobeUserNotLocalAdmin = 2, SkipExpressSettings = 4, SkipOemRegistration = 8, SkipEula = 16 |
|
||||||
| CloudAssignedForcedEnrollment (number, required) | Specifies that the device should require AAD Join and MDM enrollment. <br>0 = not required, 1 = required. |
|
| CloudAssignedDomainJoinMethod (number, required) | This property specifies whether the device should join Azure Active Directory or Active Directory (Hybrid Azure AD Join). Values include: Active AD Join = 0, Hybrid Azure AD Join = 1 |
|
||||||
| ZtdCorrelationId (guid, required) | A unique GUID (without braces) that will be provided to Intune as part of the registration process. ZtdCorrelationId will be included in enrollment message as “OfflineAutoPilotEnrollmentCorrelator”. This attribute will be present only if the enrollment is taking place on a device registered with Zero Touch Provisioning via offline registration. |
|
| CloudAssignedForcedEnrollment (number, required) | Specifies that the device should require AAD Join and MDM enrollment. <br>0 = not required, 1 = required. |
|
||||||
| CloudAssignedAadServerData (encoded JSON string, required) | An embedded JSON string used for branding. It requires AAD corp branding enabled. <br> Example value: "CloudAssignedAadServerData": "{\"ZeroTouchConfig\":{\"CloudAssignedTenantUpn\":\"\",\"CloudAssignedTenantDomain\":\"tenant.onmicrosoft.com\"}}" |
|
| ZtdCorrelationId (guid, required) | A unique GUID (without braces) that will be provided to Intune as part of the registration process. ZtdCorrelationId will be included in enrollment message as “OfflineAutoPilotEnrollmentCorrelator”. This attribute will be present only if the enrollment is taking place on a device registered with Zero Touch Provisioning via offline registration. |
|
||||||
| CloudAssignedDeviceName (string, optional) | The name automatically assigned to the computer. This follows the naming pattern convention that can be configured in Intune as part of the Autopilot profile, or can specify an explicit name to use. |
|
| CloudAssignedAadServerData (encoded JSON string, required) | An embedded JSON string used for branding. It requires AAD corp branding enabled. <br> Example value: "CloudAssignedAadServerData": "{\"ZeroTouchConfig\":{\"CloudAssignedTenantUpn\":\"\",\"CloudAssignedTenantDomain\":\"tenant.onmicrosoft.com\"}}" |
|
||||||
|
| CloudAssignedDeviceName (string, optional) | The name automatically assigned to the computer. This follows the naming pattern convention that can be configured in Intune as part of the Autopilot profile, or can specify an explicit name to use. |
|
||||||
|
|
||||||
5. The Autopilot profile must be saved as a JSON file in ASCII or ANSI format. Windows PowerShell defaults to Unicode format, so if you attempt to redirect output of the commands to a file, you must also specify the file format. For example, to save the file in ASCII format using Windows PowerShell, you can create a directory (ex: c:\Autopilot) and save the profile as shown below: (use the horizontal scroll bar at the bottom if needed to view the entire command string)
|
|
||||||
|
5. The Autopilot profile must be saved as a JSON file in ASCII or ANSI format. Windows PowerShell defaults to Unicode format, so if you attempt to redirect output of the commands to a file, you must also specify the file format. For example, to save the file in ASCII format using Windows PowerShell, you can create a directory (ex: c:\Autopilot) and save the profile as shown below: (use the horizontal scroll bar at the bottom if needed to view the entire command string)
|
||||||
```powershell
|
|
||||||
Get-AutopilotProfile | ConvertTo-AutopilotConfigurationJSON | Out-File c:\Autopilot\AutopilotConfigurationFile.json -Encoding ASCII
|
```powershell
|
||||||
```
|
Get-AutopilotProfile | ConvertTo-AutopilotConfigurationJSON | Out-File c:\Autopilot\AutopilotConfigurationFile.json -Encoding ASCII
|
||||||
**IMPORTANT**: The file name must be named **AutopilotConfigurationFile.json** in addition to being encoded as ASCII/ANSI.
|
```
|
||||||
|
**IMPORTANT**: The file name must be named **AutopilotConfigurationFile.json** in addition to being encoded as ASCII/ANSI.
|
||||||
If preferred, you can save the profile to a text file and edit in Notepad. In Notepad, when you choose **Save as** you must select Save as type: **All Files** and choose ANSI from the drop-down list next to **Encoding**. See the following example.
|
|
||||||
|
If preferred, you can save the profile to a text file and edit in Notepad. In Notepad, when you choose **Save as** you must select Save as type: **All Files** and choose ANSI from the drop-down list next to **Encoding**. See the following example.
|
||||||
|
|
||||||
|
|
||||||
After saving the file, move the file to a location suitable as an SCCM package source.
|
|
||||||
|
After saving the file, move the file to a location suitable as an SCCM package source.
|
||||||
>[!IMPORTANT]
|
|
||||||
>Multiple JSON profile files can be used, but each must be named **AutopilotConfigurationFile.json** in order for OOBE to follow the Autopilot experience. The file also must be encoded as ANSI. <br><br>**Saving the file with Unicode or UTF-8 encoding or saving it with a different file name will cause Windows 10 OOBE to not follow the Autopilot experience**.<br>
|
>[!IMPORTANT]
|
||||||
|
>Multiple JSON profile files can be used, but each must be named **AutopilotConfigurationFile.json** in order for OOBE to follow the Autopilot experience. The file also must be encoded as ANSI. <br><br>**Saving the file with Unicode or UTF-8 encoding or saving it with a different file name will cause Windows 10 OOBE to not follow the Autopilot experience**.<br>
|
||||||
|
|
||||||
### Create a package containing the JSON file
|
|
||||||
|
### Create a package containing the JSON file
|
||||||
1. In Configuration Manager, navigate to **\Software Library\Overview\Application Management\Packages**
|
|
||||||
2. On the ribbon, click **Create Package**
|
1. In Configuration Manager, navigate to **\Software Library\Overview\Application Management\Packages**
|
||||||
3. In the **Create Package and Program Wizard** enter the following **Package** and **Program Type** details:<br>
|
2. On the ribbon, click **Create Package**
|
||||||
- <u>Name</u>: **Autopilot for existing devices config**
|
3. In the **Create Package and Program Wizard** enter the following **Package** and **Program Type** details:<br>
|
||||||
- Select the **This package contains source files** checkbox
|
- <u>Name</u>: **Autopilot for existing devices config**
|
||||||
- <u>Source folder</u>: Click **Browse** and specify a UNC path containing the AutopilotConfigurationFile.json file.
|
- Select the **This package contains source files** checkbox
|
||||||
- Click **OK** and then click **Next**.
|
- <u>Source folder</u>: Click **Browse** and specify a UNC path containing the AutopilotConfigurationFile.json file.
|
||||||
- <u>Program Type</u>: **Do not create a program**
|
- Click **OK** and then click **Next**.
|
||||||
4. Click **Next** twice and then click **Close**.
|
- <u>Program Type</u>: **Do not create a program**
|
||||||
|
4. Click **Next** twice and then click **Close**.
|
||||||
**NOTE**: If you change user-driven Autopilot profile settings in Intune at a later date, you must also update the JSON file and redistribute the associated Config Mgr package.
|
|
||||||
|
**NOTE**: If you change user-driven Autopilot profile settings in Intune at a later date, you must also update the JSON file and redistribute the associated Config Mgr package.
|
||||||
### Create a target collection
|
|
||||||
|
### Create a target collection
|
||||||
>[!NOTE]
|
|
||||||
>You can also choose to reuse an existing collection
|
>[!NOTE]
|
||||||
|
>You can also choose to reuse an existing collection
|
||||||
1. Navigate to **\Assets and Compliance\Overview\Device Collections**
|
|
||||||
2. On the ribbon, click **Create** and then click **Create Device Collection**
|
1. Navigate to **\Assets and Compliance\Overview\Device Collections**
|
||||||
3. In the **Create Device Collection Wizard** enter the following **General** details:
|
2. On the ribbon, click **Create** and then click **Create Device Collection**
|
||||||
- <u>Name</u>: **Autopilot for existing devices collection**
|
3. In the **Create Device Collection Wizard** enter the following **General** details:
|
||||||
- Comment: (optional)
|
- <u>Name</u>: **Autopilot for existing devices collection**
|
||||||
- <u>Limiting collection</u>: Click **Browse** and select **All Systems**
|
- Comment: (optional)
|
||||||
|
- <u>Limiting collection</u>: Click **Browse** and select **All Systems**
|
||||||
>[!NOTE]
|
|
||||||
>You can optionally choose to use an alternative collection for the limiting collection. The device to be upgraded must be running the ConfigMgr agent in the collection that you select.
|
>[!NOTE]
|
||||||
|
>You can optionally choose to use an alternative collection for the limiting collection. The device to be upgraded must be running the ConfigMgr agent in the collection that you select.
|
||||||
4. Click **Next**, then enter the following **Membership Rules** details:
|
|
||||||
- Click **Add Rule** and specify either a direct or query based collection rule to add the target test Windows 7 devices to the new collection.
|
4. Click **Next**, then enter the following **Membership Rules** details:
|
||||||
- For example, if the hostname of the computer to be wiped and reloaded is PC-01 and you wish to use Name as the attribute, click **Add Rule > Direct Rule > (wizard opens) > Next** and then enter **PC-01** next to **Value**. Click **Next** and then choose **PC-01** under **Resources**. See the following examples.
|
- Click **Add Rule** and specify either a direct or query based collection rule to add the target test Windows 7 devices to the new collection.
|
||||||
|
- For example, if the hostname of the computer to be wiped and reloaded is PC-01 and you wish to use Name as the attribute, click **Add Rule > Direct Rule > (wizard opens) > Next** and then enter **PC-01** next to **Value**. Click **Next** and then choose **PC-01** under **Resources**. See the following examples.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
5. Continue creating the device collection with the default settings:
|
|
||||||
- Use incremental updates for this collection: not selected
|
5. Continue creating the device collection with the default settings:
|
||||||
- Schedule a full update on this collection: default
|
- Use incremental updates for this collection: not selected
|
||||||
- Click **Next** twice and then click **Close**
|
- Schedule a full update on this collection: default
|
||||||
|
- Click **Next** twice and then click **Close**
|
||||||
### Create an Autopilot for existing devices Task Sequence
|
|
||||||
|
### Create an Autopilot for existing devices Task Sequence
|
||||||
>[!TIP]
|
|
||||||
>The next procedure requires a boot image for Windows 10 1803 or later. Review your available boot images in the Configuration Manager conole under **Software Library\Overview\Operating Systems\Boot images** and verify that the **OS Version** is 10.0.17134.1 (Windows 10 version 1803) or later.
|
>[!TIP]
|
||||||
|
>The next procedure requires a boot image for Windows 10 1803 or later. Review your available boot images in the Configuration Manager conole under **Software Library\Overview\Operating Systems\Boot images** and verify that the **OS Version** is 10.0.17134.1 (Windows 10 version 1803) or later.
|
||||||
1. In the Configuration Manager console, navigate to **\Software Library\Overview\Operating Systems\Task Sequences**
|
|
||||||
2. On the Home ribbon, click **Create Task Sequence**
|
1. In the Configuration Manager console, navigate to **\Software Library\Overview\Operating Systems\Task Sequences**
|
||||||
3. Select **Install an existing image package** and then click **Next**
|
2. On the Home ribbon, click **Create Task Sequence**
|
||||||
4. In the Create Task Sequence Wizard enter the following details:
|
3. Select **Install an existing image package** and then click **Next**
|
||||||
- <u>Task sequence name</u>: **Autopilot for existing devices**
|
4. In the Create Task Sequence Wizard enter the following details:
|
||||||
- <u>Boot Image</u>: Click **Browse** and select a Windows 10 boot image (1803 or later)
|
- <u>Task sequence name</u>: **Autopilot for existing devices**
|
||||||
- Click **Next**, and then on the Install Windows page click **Browse** and select a Windows 10 **Image package** and **Image Index**, version 1803 or later.
|
- <u>Boot Image</u>: Click **Browse** and select a Windows 10 boot image (1803 or later)
|
||||||
- Select the **Partition and format the target computer before installing the operating system** checkbox.
|
- Click **Next**, and then on the Install Windows page click **Browse** and select a Windows 10 **Image package** and **Image Index**, version 1803 or later.
|
||||||
- Select or clear **Configure task sequence for use with Bitlocker** checkbox. This is optional.
|
- Select the **Partition and format the target computer before installing the operating system** checkbox.
|
||||||
- <u>Product Key</u> and <u>Server licensing mode</u>: Optionally enter a product key and server licencing mode.
|
- Select or clear **Configure task sequence for use with Bitlocker** checkbox. This is optional.
|
||||||
- <u>Randomly generate the local administrator password and disable the account on all support platforms (recommended)</u>: Optional.
|
- <u>Product Key</u> and <u>Server licensing mode</u>: Optionally enter a product key and server licensing mode.
|
||||||
- <u>Enable the account and specify the local administrator password</u>: Optional.
|
- <u>Randomly generate the local administrator password and disable the account on all support platforms (recommended)</u>: Optional.
|
||||||
- Click **Next**, and then on the Configure Network page choose **Join a workgroup** and specify a name (ex: workgroup) next to **Workgroup**.
|
- <u>Enable the account and specify the local administrator password</u>: Optional.
|
||||||
|
- Click **Next**, and then on the Configure Network page choose **Join a workgroup** and specify a name (ex: workgroup) next to **Workgroup**.
|
||||||
>[!IMPORTANT]
|
|
||||||
>The Autopilot for existing devices task sequence will run the **Prepare Windows for capture** action which calls the System Preparation Tool (syeprep). This action will fail if the target machine is joined to a domain.
|
>[!IMPORTANT]
|
||||||
|
>The Autopilot for existing devices task sequence will run the **Prepare Windows for capture** action which calls the System Preparation Tool (syeprep). This action will fail if the target machine is joined to a domain.
|
||||||
5. Click **Next** and then click **Next** again to accept the default settings on the Install Configuration Manager page.
|
|
||||||
6. On the State Migration page, enter the following details:
|
5. Click **Next** and then click **Next** again to accept the default settings on the Install Configuration Manager page.
|
||||||
- Clear the **Capture user settings and files** checkbox.
|
6. On the State Migration page, enter the following details:
|
||||||
- Clear the **Capture network settings** checkbox.
|
- Clear the **Capture user settings and files** checkbox.
|
||||||
- Clear the **Capture Microsoft Windows settings** checkbox.
|
- Clear the **Capture network settings** checkbox.
|
||||||
- Click **Next**.
|
- Clear the **Capture Microsoft Windows settings** checkbox.
|
||||||
|
- Click **Next**.
|
||||||
>[!NOTE]
|
|
||||||
>The Autopilot for existing devices task sequence will result in an Azure Active Directory Domain (AAD) joined device. The User State Migration Toolkit (USMT) does not support AAD joined or hybrid AAD joined devices.
|
>[!NOTE]
|
||||||
|
>The Autopilot for existing devices task sequence will result in an Azure Active Directory Domain (AAD) joined device. The User State Migration Toolkit (USMT) does not support AAD joined or hybrid AAD joined devices.
|
||||||
7. On the Include Updates page, choose one of the three available options. This selection is optional.
|
|
||||||
8. On the Install applications page, add applications if desired. This is optional.
|
7. On the Include Updates page, choose one of the three available options. This selection is optional.
|
||||||
9. Click **Next**, confirm settings, click **Next** and then click **Close**.
|
8. On the Install applications page, add applications if desired. This is optional.
|
||||||
10. Right click on the Autopilot for existing devices task sequence and click **Edit**.
|
9. Click **Next**, confirm settings, click **Next** and then click **Close**.
|
||||||
11. In the Task Sequence Editor under the **Install Operating System** group, click the **Apply Windows Settings** action.
|
10. Right click on the Autopilot for existing devices task sequence and click **Edit**.
|
||||||
12. Click **Add** then click **New Group**.
|
11. In the Task Sequence Editor under the **Install Operating System** group, click the **Apply Windows Settings** action.
|
||||||
13. Change the group **Name** from **New Group** to **Autopilot for existing devices config**.
|
12. Click **Add** then click **New Group**.
|
||||||
14. Click **Add**, point to **General**, then click **Run Command Line**.
|
13. Change the group **Name** from **New Group** to **Autopilot for existing devices config**.
|
||||||
15. Verify that the **Run Command Line** step is nested under the **Autopilot for existing devices config** group.
|
14. Click **Add**, point to **General**, then click **Run Command Line**.
|
||||||
16. Change the **Name** to **Apply Autopilot for existing devices config file** and paste the following into the **Command line** text box, and then click **Apply**:
|
15. Verify that the **Run Command Line** step is nested under the **Autopilot for existing devices config** group.
|
||||||
```
|
16. Change the **Name** to **Apply Autopilot for existing devices config file** and paste the following into the **Command line** text box, and then click **Apply**:
|
||||||
cmd.exe /c xcopy AutopilotConfigurationFile.json %OSDTargetSystemDrive%\windows\provisioning\Autopilot\ /c
|
```
|
||||||
```
|
cmd.exe /c xcopy AutopilotConfigurationFile.json %OSDTargetSystemDrive%\windows\provisioning\Autopilot\ /c
|
||||||
- **AutopilotConfigurationFile.json** must be the name of the JSON file present in the Autopilot for existing devices package created earlier.
|
```
|
||||||
|
- **AutopilotConfigurationFile.json** must be the name of the JSON file present in the Autopilot for existing devices package created earlier.
|
||||||
17. In the **Apply Autopilot for existing devices config file** step, select the **Package** checkbox and then click **Browse**.
|
|
||||||
18. Select the **Autopilot for existing devices config** package created earlier and click **OK**. An example is displayed at the end of this section.
|
17. In the **Apply Autopilot for existing devices config file** step, select the **Package** checkbox and then click **Browse**.
|
||||||
19. Under the **Setup Operating System** group, click the **Setup Windows and Configuration Manager** task.
|
18. Select the **Autopilot for existing devices config** package created earlier and click **OK**. An example is displayed at the end of this section.
|
||||||
20. Click **Add** and then click **New Group**.
|
19. Under the **Setup Operating System** group, click the **Setup Windows and Configuration Manager** task.
|
||||||
21. Change **Name** from **New Group** to **Prepare Device for Autopilot**
|
20. Click **Add** and then click **New Group**.
|
||||||
22. Verify that the **Prepare Device for Autopilot** group is the very last step in the task sequence. Use the **Move Down** button if necessary.
|
21. Change **Name** from **New Group** to **Prepare Device for Autopilot**
|
||||||
23. With the **Prepare device for Autopilot** group selected, click **Add**, point to **Images** and then click **Prepare ConfigMgr Client for Capture**.
|
22. Verify that the **Prepare Device for Autopilot** group is the very last step in the task sequence. Use the **Move Down** button if necessary.
|
||||||
24. Add a second step by clicking **Add**, pointing to **Images**, and clicking **Prepare Windows for Capture**. Use the following settings in this step:
|
23. With the **Prepare device for Autopilot** group selected, click **Add**, point to **Images** and then click **Prepare ConfigMgr Client for Capture**.
|
||||||
- <u>Automatically build mass storage driver list</u>: **Not selected**
|
24. Add a second step by clicking **Add**, pointing to **Images**, and clicking **Prepare Windows for Capture**. Use the following settings in this step:
|
||||||
- <u>Do not reset activation flag</u>: **Not selected**
|
- <u>Automatically build mass storage driver list</u>: **Not selected**
|
||||||
- <u>Shutdown the computer after running this action</u>: **Optional**
|
- <u>Do not reset activation flag</u>: **Not selected**
|
||||||
|
- <u>Shutdown the computer after running this action</u>: **Optional**
|
||||||
|
|
||||||
|
|
||||||
25. Click **OK** to close the Task Sequence Editor.
|
|
||||||
|
25. Click **OK** to close the Task Sequence Editor.
|
||||||
### Deploy Content to Distribution Points
|
|
||||||
|
### Deploy Content to Distribution Points
|
||||||
Next, ensure that all content required for the task sequence is deployed to distribution points.
|
|
||||||
|
Next, ensure that all content required for the task sequence is deployed to distribution points.
|
||||||
1. Right click on the **Autopilot for existing devices** task sequence and click **Distribute Content**.
|
|
||||||
2. Click **Next**, **Review the content to distribute** and then click **Next**.
|
1. Right click on the **Autopilot for existing devices** task sequence and click **Distribute Content**.
|
||||||
3. On the Specify the content distribution page click **Add** to specify either a **Distribution Point** or **Distribution Point Group**.
|
2. Click **Next**, **Review the content to distribute** and then click **Next**.
|
||||||
4. On the a Add Distribution Points or Add Distribution Point Groups wizard specify content destinations that will allow the JSON file to be retrieved when the task sequence is run.
|
3. On the Specify the content distribution page click **Add** to specify either a **Distribution Point** or **Distribution Point Group**.
|
||||||
5. When you are finished specifying content distribution, click **Next** twice then click **Close**.
|
4. On the a Add Distribution Points or Add Distribution Point Groups wizard specify content destinations that will allow the JSON file to be retrieved when the task sequence is run.
|
||||||
|
5. When you are finished specifying content distribution, click **Next** twice then click **Close**.
|
||||||
### Deploy the OS with Autopilot Task Sequence
|
|
||||||
|
### Deploy the OS with Autopilot Task Sequence
|
||||||
1. Right click on the **Autopilot for existing devices** task sequence and then click **Deploy**.
|
|
||||||
2. In the Deploy Software Wizard enter the following **General** and **Deployment Settings** details:
|
1. Right click on the **Autopilot for existing devices** task sequence and then click **Deploy**.
|
||||||
- <u>Task Sequence</u>: **Autopilot for existing devices**.
|
2. In the Deploy Software Wizard enter the following **General** and **Deployment Settings** details:
|
||||||
- <u>Collection</u>: Click **Browse** and then select **Autopilot for existing devices collection** (or another collection you prefer).
|
- <u>Task Sequence</u>: **Autopilot for existing devices**.
|
||||||
- Click **Next** to specify **Deployment Settings**.
|
- <u>Collection</u>: Click **Browse** and then select **Autopilot for existing devices collection** (or another collection you prefer).
|
||||||
- <u>Action</u>: **Install**.
|
- Click **Next** to specify **Deployment Settings**.
|
||||||
- <u>Purpose</u>: **Available**. You can optionally select **Required** instead of **Available**. This is not recommended during the test owing to the potential impact of inadvertent configurations.
|
- <u>Action</u>: **Install**.
|
||||||
- <u>Make available to the following</u>: **Only Configuration Manager Clients**. Note: Choose the option here that is relevant for the context of your test. If the target client does not have the Configuration Manager agent or Windows installed, you will need to select an option that includes PXE or Boot Media.
|
- <u>Purpose</u>: **Available**. You can optionally select **Required** instead of **Available**. This is not recommended during the test owing to the potential impact of inadvertent configurations.
|
||||||
- Click **Next** to specify **Scheduling** details.
|
- <u>Make available to the following</u>: **Only Configuration Manager Clients**. Note: Choose the option here that is relevant for the context of your test. If the target client does not have the Configuration Manager agent or Windows installed, you will need to select an option that includes PXE or Boot Media.
|
||||||
- <u>Schedule when this deployment will become available</u>: Optional
|
- Click **Next** to specify **Scheduling** details.
|
||||||
- <u>Schedule when this deployment will expire</u>: Optional
|
- <u>Schedule when this deployment will become available</u>: Optional
|
||||||
- Click **Next** to specify **User Experience** details.
|
- <u>Schedule when this deployment will expire</u>: Optional
|
||||||
- <u>Show Task Sequence progress</u>: Selected.
|
- Click **Next** to specify **User Experience** details.
|
||||||
- <u>Software Installation</u>: Not selected.
|
- <u>Show Task Sequence progress</u>: Selected.
|
||||||
- <u>System restart (if required to complete the installation)</u>: Not selected.
|
- <u>Software Installation</u>: Not selected.
|
||||||
- <u>Commit changed at deadline or during a maintenance windows (requires restart)</u>: Optional.
|
- <u>System restart (if required to complete the installation)</u>: Not selected.
|
||||||
- <u>Allow task sequence to be run for client on the Internet</u>: Optional
|
- <u>Commit changed at deadline or during a maintenance windows (requires restart)</u>: Optional.
|
||||||
- Click **Next** to specify **Alerts** details.
|
- <u>Allow task sequence to be run for client on the Internet</u>: Optional
|
||||||
- <u>Create a deployment alert when the threshold is higher than the following</u>: Optional.
|
- Click **Next** to specify **Alerts** details.
|
||||||
- Click **Next** to specify **Distribution Points** details.
|
- <u>Create a deployment alert when the threshold is higher than the following</u>: Optional.
|
||||||
- <u>Deployment options</u>: **Download content locally when needed by the running task sequence**.
|
- Click **Next** to specify **Distribution Points** details.
|
||||||
- <u>When no local distribution point is available use a remote distribution point</u>: Optional.
|
- <u>Deployment options</u>: **Download content locally when needed by the running task sequence**.
|
||||||
- <u>Allow clients to use distribution points from the default site boundary group</u>: Optional.
|
- <u>When no local distribution point is available use a remote distribution point</u>: Optional.
|
||||||
- Click **Next**, confirm settings, click **Next**, and then click **Close**.
|
- <u>Allow clients to use distribution points from the default site boundary group</u>: Optional.
|
||||||
|
- Click **Next**, confirm settings, click **Next**, and then click **Close**.
|
||||||
### Complete the client installation process
|
|
||||||
|
### Complete the client installation process
|
||||||
1. Open the Software Center on the target Windows 7 or Windows 8.1 client computer. You can do this by clicking Start and then typing **software** in the search box, or by typing the following at a Windows PowerShell or command prompt:
|
|
||||||
|
1. Open the Software Center on the target Windows 7 or Windows 8.1 client computer. You can do this by clicking Start and then typing **software** in the search box, or by typing the following at a Windows PowerShell or command prompt:
|
||||||
```
|
|
||||||
C:\Windows\CCM\SCClient.exe
|
```
|
||||||
```
|
C:\Windows\CCM\SCClient.exe
|
||||||
|
```
|
||||||
2. In the software library, select **Autopilot for existing devices** and click **Install**. See the following example:
|
|
||||||
|
2. In the software library, select **Autopilot for existing devices** and click **Install**. See the following example:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The Task Sequence will download content, reboot, format the drives and install Windows 10. The device will then proceed to be prepared for Autopilot. Once the task sequence has completed the device will boot into OOBE and provide an Autopilot experience.
|
|
||||||
|
The Task Sequence will download content, reboot, format the drives and install Windows 10. The device will then proceed to be prepared for Autopilot. Once the task sequence has completed the device will boot into OOBE and provide an Autopilot experience.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
>[!NOTE]
|
|
||||||
>If joining devices to Active Directory (Hybrid Azure AD Join), it is necessary to create a Domain Join device configuration profile that is targeted to "All Devices" (since there is no Azure Active Directory device object for the computer to do group-based targeting). See [User-driven mode for hybrid Azure Active Directory join](https://docs.microsoft.com/windows/deployment/windows-autopilot/user-driven#user-driven-mode-for-hybrid-azure-active-directory-join) for more information.
|
>[!NOTE]
|
||||||
|
>If joining devices to Active Directory (Hybrid Azure AD Join), it is necessary to create a Domain Join device configuration profile that is targeted to "All Devices" (since there is no Azure Active Directory device object for the computer to do group-based targeting). See [User-driven mode for hybrid Azure Active Directory join](https://docs.microsoft.com/windows/deployment/windows-autopilot/user-driven#user-driven-mode-for-hybrid-azure-active-directory-join) for more information.
|
||||||
### Register the device for Windows Autopilot
|
|
||||||
|
### Register the device for Windows Autopilot
|
||||||
Devices provisioned through Autopilot will only receive the guided OOBE Autopilot experience on first boot. Once updated to Windows 10, the device should be registered to ensure a continued Autopilot experience in the event of PC reset. You can enable automatic registration for an assigned group using the **Convert all targeted devices to Autopilot** setting. For more information, see [Create an Autopilot deployment profile](https://docs.microsoft.com/intune/enrollment-autopilot#create-an-autopilot-deployment-profile).
|
|
||||||
|
Devices provisioned through Autopilot will only receive the guided OOBE Autopilot experience on first boot. Once updated to Windows 10, the device should be registered to ensure a continued Autopilot experience in the event of PC reset. You can enable automatic registration for an assigned group using the **Convert all targeted devices to Autopilot** setting. For more information, see [Create an Autopilot deployment profile](https://docs.microsoft.com/intune/enrollment-autopilot#create-an-autopilot-deployment-profile).
|
||||||
Also see [Adding devices to Windows Autopilot](https://docs.microsoft.com/windows/deployment/windows-autopilot/add-devices).
|
|
||||||
|
Also see [Adding devices to Windows Autopilot](https://docs.microsoft.com/windows/deployment/windows-autopilot/add-devices).
|
||||||
## Speeding up the deployment process
|
|
||||||
|
## Speeding up the deployment process
|
||||||
|
|
||||||
|
To remove around 20 minutes from the deployment process, see Michael Niehaus's blog with instructions for [Speeding up Windows Autopilot for existing devices](https://blogs.technet.microsoft.com/mniehaus/2018/10/25/speeding-up-windows-autopilot-for-existing-devices/).
|
||||||
|
|||||||
@ -25,9 +25,15 @@ ms.topic: article
|
|||||||
|
|
||||||
<table>
|
<table>
|
||||||
<th>Issue<th>More information
|
<th>Issue<th>More information
|
||||||
<tr><td>The following known issue will be resolved by installing the KB4517211 update, due to be released in late September 2019:
|
<tr><td>Windows Autopilot for existing devices does not work for Windows 10, version 1903; you see screens that you've disabled in your Windows Autopilot profile, such as the Windows 10 License Agreement screen.
|
||||||
|
<br> <br>
|
||||||
- TPM attestation fails on Windows 10 1903 due to missing AKI extension in EK certificate. (An additional validation added in Windows 10 1903 to check that the TPM EK certs had the proper attributes according to the TCG specifications uncovered that a number of them don’t, so that validation will be removed).
|
This happens because Windows 10, version 1903 deletes the AutopilotConfigurationFile.json file.
|
||||||
|
<td>To fix this issue: <ol><li>Edit the Configuration Manager task sequence and disable the <b>Prepare Windows for Capture</b> step.
|
||||||
|
<li>Add a new <b>Run command line</b> step that runs <b>c:\windows\system32\sysprep\sysprep.exe /oobe /reboot</b>.</ol>
|
||||||
|
<a href="https://oofhours.com/2019/09/19/a-challenge-with-windows-autopilot-for-existing-devices-and-windows-10-1903/">More information</a>
|
||||||
|
<tr><td>The following known issue will be resolved by installing the KB4517211 update, due to be released in late September 2019.
|
||||||
|
<br> <br>
|
||||||
|
TPM attestation fails on Windows 10 1903 due to missing AKI extension in EK certificate. (An additional validation added in Windows 10 1903 to check that the TPM EK certs had the proper attributes according to the TCG specifications uncovered that a number of them don’t, so that validation will be removed).
|
||||||
<td>Download and install the KB4517211 update</a>. <br><br>This update is currently pending release.
|
<td>Download and install the KB4517211 update</a>. <br><br>This update is currently pending release.
|
||||||
<tr><td>The following known issues are resolved by installing the August 30, 2019 KB4512941 update (OS Build 18362.329):
|
<tr><td>The following known issues are resolved by installing the August 30, 2019 KB4512941 update (OS Build 18362.329):
|
||||||
|
|
||||||
|
|||||||
@ -50,6 +50,7 @@ sections:
|
|||||||
text: "
|
text: "
|
||||||
<table border ='0'><tr><td width='80%'>Message</td><td width='20%'>Date</td></tr>
|
<table border ='0'><tr><td width='80%'>Message</td><td width='20%'>Date</td></tr>
|
||||||
|
|
||||||
|
<tr><td><a href = 'https://portal.msrc.microsoft.com/security-guidance/advisory/CVE-2019-1367' target='_blank'><b>Advisory: Scripting Engine Memory Corruption Vulnerability (CVE-2019-1367)</b></a><br><div>On September 23, 2019, Microsoft released a security update to address a remote code execution vulnerability in the way the scripting engine handles objects in memory in Internet Explorer. An attacker who successfully exploited the vulnerability could gain the same user permissions as the current user. For example, if a user is logged on with administrative rights, an attacker could take control of an affected system and install programs; view, change, or delete data; or create new accounts with full user rights. Alternatively, an attacker could host a specially crafted website targeting Internet Explorer and then entice a user to open web page or a malicious document attached to an e-mail. For more information about the vulnerability, see the Microsoft Security Guide <a href=\"https://portal.msrc.microsoft.com/security-guidance/advisory/CVE-2019-1367\" target=\"_blank\">CVE-2019-1367 | Scripting Engine Memory Corruption Vulnerability</a>. </div><div> </div><div>Mitigation for this vulnerability is available from the <a href=\"https://portal.msrc.microsoft.com\" target=\"_blank\">Microsoft Security Update Guide</a>. For the best protection, we recommend you apply the latest Windows updates and follow security best practices and do not open attachments or documents from an untrusted source. For more information about the vulnerability, see the Microsoft Security Guide: <a href=\"https://portal.msrc.microsoft.com/security-guidance/advisory/CVE-2019-1367\" target=\"_blank\">CVE-2019-1367 | Scripting Engine Memory Corruption Vulnerability</a>. </div></td><td>September 22, 2019 <br>11:00 AM PT</td></tr>
|
||||||
<tr><td><b>Status of September 2019 “C” release</b><br><div>The optional monthly “C” release for September 2019 for all supported versions of Windows and Windows Server prior to Windows 10, version 1903 and Windows Server, version 1903 will be available in the near term. For more information on the different types of monthly quality updates, see our <a href=\"https://techcommunity.microsoft.com/t5/Windows-IT-Pro-Blog/Windows-10-update-servicing-cadence/ba-p/222376\" target=\"_blank\">Windows 10 update servicing cadence primer</a>. Follow <a href=\"https://twitter.com/windowsupdate\" target=\"_blank\"><u>@WindowsUpdate</u></a> for the latest on the availability of this release.</div></td><td>September 19, 2019 <br>04:11 PM PT</td></tr>
|
<tr><td><b>Status of September 2019 “C” release</b><br><div>The optional monthly “C” release for September 2019 for all supported versions of Windows and Windows Server prior to Windows 10, version 1903 and Windows Server, version 1903 will be available in the near term. For more information on the different types of monthly quality updates, see our <a href=\"https://techcommunity.microsoft.com/t5/Windows-IT-Pro-Blog/Windows-10-update-servicing-cadence/ba-p/222376\" target=\"_blank\">Windows 10 update servicing cadence primer</a>. Follow <a href=\"https://twitter.com/windowsupdate\" target=\"_blank\"><u>@WindowsUpdate</u></a> for the latest on the availability of this release.</div></td><td>September 19, 2019 <br>04:11 PM PT</td></tr>
|
||||||
<tr><td><b>Plan for change: End of service reminders for Windows 10, versions 1703 and 1803</b><br><div>The Enterprise and Education editions of Windows 10, version 1703 (the Creators Update) will reach end of service on October 8, 2019. The Home, Pro, Pro for Workstations, and IoT Core editions of Windows 10, version 1803 (the April 2018 Update) will reach end of service on November 12, 2019. We recommend that you update devices running these versions and editions to the latest version of Windows 10—Windows 10, version 1903—as soon as possible to help keep them protected and your environments secure.</div></td><td>September 13, 2019 <br>03:23 PM PT</td></tr>
|
<tr><td><b>Plan for change: End of service reminders for Windows 10, versions 1703 and 1803</b><br><div>The Enterprise and Education editions of Windows 10, version 1703 (the Creators Update) will reach end of service on October 8, 2019. The Home, Pro, Pro for Workstations, and IoT Core editions of Windows 10, version 1803 (the April 2018 Update) will reach end of service on November 12, 2019. We recommend that you update devices running these versions and editions to the latest version of Windows 10—Windows 10, version 1903—as soon as possible to help keep them protected and your environments secure.</div></td><td>September 13, 2019 <br>03:23 PM PT</td></tr>
|
||||||
<tr><td><b>September 2019 security update available for all supported versions of Windows</b><br><div>The September 2019 security update release, referred to as our “B” release, is now available for Windows 10, version 1903 and all supported versions of Windows. We recommend that you install these updates promptly. To be informed about the latest updates and releases, follow us on Twitter <a href=\"https://twitter.com/windowsupdate\" target=\"_blank\">@WindowsUpdate</a>.</div></td><td>September 10, 2019 <br>09:34 AM PT</td></tr>
|
<tr><td><b>September 2019 security update available for all supported versions of Windows</b><br><div>The September 2019 security update release, referred to as our “B” release, is now available for Windows 10, version 1903 and all supported versions of Windows. We recommend that you install these updates promptly. To be informed about the latest updates and releases, follow us on Twitter <a href=\"https://twitter.com/windowsupdate\" target=\"_blank\">@WindowsUpdate</a>.</div></td><td>September 10, 2019 <br>09:34 AM PT</td></tr>
|
||||||
|
|||||||
@ -121,7 +121,7 @@
|
|||||||
|
|
||||||
#### [Custom detections]()
|
#### [Custom detections]()
|
||||||
##### [Understand custom detection rules](microsoft-defender-atp/overview-custom-detections.md)
|
##### [Understand custom detection rules](microsoft-defender-atp/overview-custom-detections.md)
|
||||||
##### [Create custom detections rules](microsoft-defender-atp/custom-detection-rules.md)
|
##### [Create and manage custom detections rules](microsoft-defender-atp/custom-detection-rules.md)
|
||||||
|
|
||||||
### [Management and APIs]()
|
### [Management and APIs]()
|
||||||
#### [Overview of management and APIs](microsoft-defender-atp/management-apis.md)
|
#### [Overview of management and APIs](microsoft-defender-atp/management-apis.md)
|
||||||
|
|||||||
@ -1,16 +1,16 @@
|
|||||||
---
|
---
|
||||||
title: Create custom detection rules in Microsoft Defender ATP
|
title: Create and manage custom detection rules in Microsoft Defender ATP
|
||||||
ms.reviewer:
|
ms.reviewer:
|
||||||
description: Learn how to create custom detections rules based on advanced hunting queries
|
description: Learn how to create and manage custom detections rules based on advanced hunting queries
|
||||||
keywords: create custom detections, detections, advanced hunting, hunt, detect, query
|
keywords: custom detections, create, manage, alerts, edit, run on demand, frequency, interval, detection rules, advanced hunting, hunt, query, response actions, mdatp, microsoft defender atp
|
||||||
search.product: eADQiWindows 10XVcnh
|
search.product: eADQiWindows 10XVcnh
|
||||||
search.appverid: met150
|
search.appverid: met150
|
||||||
ms.prod: w10
|
ms.prod: w10
|
||||||
ms.mktglfcycl: deploy
|
ms.mktglfcycl: deploy
|
||||||
ms.sitesec: library
|
ms.sitesec: library
|
||||||
ms.pagetype: security
|
ms.pagetype: security
|
||||||
ms.author: macapara
|
ms.author: lomayor
|
||||||
author: mjcaparas
|
author: lomayor
|
||||||
ms.localizationpriority: medium
|
ms.localizationpriority: medium
|
||||||
manager: dansimp
|
manager: dansimp
|
||||||
audience: ITPro
|
audience: ITPro
|
||||||
@ -19,53 +19,86 @@ ms.topic: article
|
|||||||
---
|
---
|
||||||
|
|
||||||
|
|
||||||
# Create custom detections rules
|
# Create and manage custom detections rules
|
||||||
**Applies to:**
|
**Applies to:**
|
||||||
- [Microsoft Defender Advanced Threat Protection (Microsoft Defender ATP)](https://go.microsoft.com/fwlink/p/?linkid=2069559)
|
- [Microsoft Defender Advanced Threat Protection (Microsoft Defender ATP)](https://go.microsoft.com/fwlink/p/?linkid=2069559)
|
||||||
|
|
||||||
Create custom detection rules from [Advanced hunting](overview-hunting.md) queries to automatically check for threat indicators and generate alerts whenever these indicators are found.
|
Custom detection rules built from [Advanced hunting](overview-hunting.md) queries let you proactively monitor various events and system states, including suspected breach activity and misconfigured machines. The queries run every 24 hours, generating alerts and taking response actions whenever there are matches.
|
||||||
|
|
||||||
>[!NOTE]
|
>[!NOTE]
|
||||||
>To create and manage custom detections, [your role](user-roles.md#create-roles-and-assign-the-role-to-an-azure-active-directory-group) needs to have the **manage security settings** permission. For the detection rule to work properly and create alerts, the query must return in each row a set of MachineId, ReportId, EventTime which match to an actual event in advanced hunting.
|
>To create and manage custom detections, [your role](user-roles.md#create-roles-and-assign-the-role-to-an-azure-active-directory-group) needs to have the **manage security settings** permission.
|
||||||
|
|
||||||
1. In the navigation pane, select **Advanced hunting**.
|
## Create a custom detection rule
|
||||||
|
### 1. Prepare the query.
|
||||||
|
|
||||||
2. Select an existing query that you'd like to base the monitor on or create a new query.
|
In Microsoft Defender Security Center, go to **Advanced hunting** and select an existing query or create a new query. When using an new query, run the query to identify errors and understand possible results.
|
||||||
|
|
||||||
3. Select **Create detection rule**.
|
>[!NOTE]
|
||||||
|
>To use a query for a custom detection rule, the query must return the `EventTime`, `MachineId`, and `ReportId` columns in the results. Queries that don’t use the `project` operator to customize results usually return these common columns.
|
||||||
|
|
||||||
4. Specify the alert details:
|
### 2. Create new rule and provide alert details.
|
||||||
|
|
||||||
- Alert title
|
With the query in the query editor, select **Create detection rule** and specify the following alert details:
|
||||||
- Severity
|
|
||||||
- Category
|
|
||||||
- Description
|
|
||||||
- Recommended actions
|
|
||||||
|
|
||||||
5. Click **Create**.
|
- **Alert title**
|
||||||
|
- **Severity**
|
||||||
|
- **Category**
|
||||||
|
- **Description**
|
||||||
|
- **Recommended actions**
|
||||||
|
|
||||||
> [!TIP]
|
For more information about these alert details, [read about managing alerts](manage-alerts.md).
|
||||||
> TIP #1: Running the query for the first time before saving it can help you find any mistakes or errors and give you a preview of the data you can expect to be returned.<br>
|
|
||||||
> When a new detection rule is created, it will run for the first time (it might take a few minutes) and raise any alerts created by this rule. After that, the rule will automatically run every 24 hours. <br>
|
### 3. Specify actions on files or machines.
|
||||||
> TIP #2: Since the detection automatically runs every 24 hours, it's best to query data in the last 24 hours.
|
Your custom detection rule can automatically take actions on files or machines that are returned by the query.
|
||||||
|
|
||||||
|
#### Actions on machines
|
||||||
|
These actions are applied to machines in the `MachineId` column of the query results:
|
||||||
|
- **Isolate machine** — applies full network isolation, preventing the machine from connecting to any application or service, except for the Microsoft Defender ATP service. [Learn more about machine isolation](respond-machine-alerts.md#isolate-machines-from-the-network)
|
||||||
|
- **Collect investigation package** — collects machine information in a ZIP file. [Learn more about the investigation package](respond-machine-alerts.md#collect-investigation-package-from-machines)
|
||||||
|
- **Run antivirus scan** — performs a full Windows Defender Antivirus scan on the machine
|
||||||
|
- **Initiate investigation** — initiates an [automated investigation](automated-investigations.md) on the machine
|
||||||
|
|
||||||
|
#### Actions on files
|
||||||
|
These actions are applied to files in the `SHA1` or the `InitiatingProcessSHA1` column of the query results:
|
||||||
|
- **Allow/Block** — automatically adds the file to your [custom indicator list](manage-indicators.md) so that it is always allowed to run or blocked from running. You can set the scope of this action so that it is taken only on selected machine groups. This scope is independent of the scope of the rule.
|
||||||
|
- **Quarantine file** — deletes the file from its current location and places a copy in quarantine
|
||||||
|
|
||||||
|
### 4. Click **Create** to save and turn on the rule.
|
||||||
|
When saved, the custom detection rule immediately runs. It runs again every 24 hours to check for matches, generate alerts, and take response actions.
|
||||||
|
|
||||||
## Manage existing custom detection rules
|
## Manage existing custom detection rules
|
||||||
View existing rules in your network, see the last results of each rule, navigate to view all alerts that were created by each rule. You can also modify existing rules.
|
In **Settings** > **Custom detections**, you can view the list of existing custom detection rules, check their previous runs, and review the alerts they have triggered. You can also run a rule on demand and modify it.
|
||||||
|
|
||||||
1. In the navigation pane, select **Settings** > **Custom detections**. You'll see all the detections created in the system.
|
### View existing rules
|
||||||
|
|
||||||
2. Select one of the rules to take any of the following actions:
|
To view all existing custom detection rules, navigate to **Settings** > **Custom detections**. The page lists all the rules with the following run information:
|
||||||
- Open related alerts - See all the alerts that were raised based to this rule
|
|
||||||
- Run - Run the selected detection immediately.
|
|
||||||
|
|
||||||
> [!NOTE]
|
- **Last run** — when a rule was last run to check for query matches and generate alerts
|
||||||
> The next run for the query will be in 24 hours after the last run.
|
- **Last run status** — whether a rule ran successfully
|
||||||
|
- **Next run** — the next scheduled run
|
||||||
- Edit - Modify the settings of the rule.
|
- **Status** — whether a rule has been turned on or off
|
||||||
- Modify query - View and edit the query itself.
|
|
||||||
- Turn off - Stop the query from running.
|
|
||||||
- Delete
|
|
||||||
|
|
||||||
|
### View rule details, modify rule, and run rule
|
||||||
|
|
||||||
|
To view comprehensive information about a custom detection rule, select the name of rule from the list of rules in **Settings** > **Custom detections**. This opens a page about the custom detection rule with the following information:
|
||||||
|
|
||||||
|
- General information about the rule, including the details of the alert, run status, and scope
|
||||||
|
- List of triggered alerts
|
||||||
|
- List of triggered actions
|
||||||
|
|
||||||
|
<br>
|
||||||
|
*Custom detection rule page*
|
||||||
|
|
||||||
|
You can also take the following actions on the rule from this page:
|
||||||
|
|
||||||
|
- **Run** — run the rule immediately. This also resets the interval for the next run.
|
||||||
|
- **Edit** — modify the rule without changing the query
|
||||||
|
- **Modify query** — edit the query in Advanced hunting
|
||||||
|
- **Turn on** / **Turn off** — enable the rule or stop it from running
|
||||||
|
- **Delete** — turn off the rule and remove it
|
||||||
|
|
||||||
|
>[!TIP]
|
||||||
|
>To quickly view information and take action on an item in a table, use the selection column [✓] at the left of the table.
|
||||||
|
|
||||||
## Related topic
|
## Related topic
|
||||||
- [Custom detections overview](overview-custom-detections.md)
|
- [Custom detections overview](overview-custom-detections.md)
|
||||||
|
|||||||
Binary file not shown.
|
After Width: | Height: | Size: 116 KiB |
@ -1,16 +1,16 @@
|
|||||||
---
|
---
|
||||||
title: Custom detections overview
|
title: Overview of custom detections in Microsoft Defender ATP
|
||||||
ms.reviewer:
|
ms.reviewer:
|
||||||
description: Understand how you can leverage the power of advanced hunting to create custom detections
|
description: Understand how you can use Advanced hunting to create custom detections and generate alerts
|
||||||
keywords: custom detections, detections, advanced hunting, hunt, detect, query
|
keywords: custom detections, alerts, detection rules, advanced hunting, hunt, query, response actions, interval, mdatp, microsoft defender atp
|
||||||
search.product: eADQiWindows 10XVcnh
|
search.product: eADQiWindows 10XVcnh
|
||||||
search.appverid: met150
|
search.appverid: met150
|
||||||
ms.prod: w10
|
ms.prod: w10
|
||||||
ms.mktglfcycl: deploy
|
ms.mktglfcycl: deploy
|
||||||
ms.sitesec: library
|
ms.sitesec: library
|
||||||
ms.pagetype: security
|
ms.pagetype: security
|
||||||
ms.author: macapara
|
ms.author: lomayor
|
||||||
author: mjcaparas
|
author: lomayor
|
||||||
ms.localizationpriority: medium
|
ms.localizationpriority: medium
|
||||||
manager: dansimp
|
manager: dansimp
|
||||||
audience: ITPro
|
audience: ITPro
|
||||||
@ -23,18 +23,16 @@ ms.topic: conceptual
|
|||||||
**Applies to:**
|
**Applies to:**
|
||||||
- [Microsoft Defender Advanced Threat Protection (Microsoft Defender ATP)](https://go.microsoft.com/fwlink/p/?linkid=2069559)
|
- [Microsoft Defender Advanced Threat Protection (Microsoft Defender ATP)](https://go.microsoft.com/fwlink/p/?linkid=2069559)
|
||||||
|
|
||||||
|
With custom detections, you can proactively monitor for and respond to various events and system states, including suspected breach activity and misconfigured machines. This is made possible by customizable detection rules that automatically trigger alerts as well as response actions.
|
||||||
|
|
||||||
Alerts in Microsoft Defender ATP are surfaced through the system based on signals gathered from endpoints. With custom detections, you can create custom queries to monitor events for any kind of behavior such as suspicious events or emerging threats.
|
Custom detections work with [Advanced hunting](overview-hunting.md), which provides a powerful, flexible query language that covers a broad set of event and system information from your network. The queries run every 24 hours, generating alerts and taking response actions whenever there are matches.
|
||||||
|
|
||||||
This can be done by leveraging the power of [Advanced hunting](overview-hunting.md) through the creation of custom detection rules.
|
Custom detections provide:
|
||||||
Custom detections are queries that run periodically every 24 hours and can be configured so that when the query meets the criteria you set, alerts are created and are surfaced in Microsoft Defender Security Center. These alerts will be treated like any other alert in the system.
|
- Alerts from rule-based detections built from Advanced hunting queries
|
||||||
|
- Automatic response actions that apply to files and machines
|
||||||
This capability is particularly useful for scenarios when you want to pro-actively prevent threats and be notified quickly of emerging threats.
|
|
||||||
|
|
||||||
>[!NOTE]
|
>[!NOTE]
|
||||||
>To create and manage custom detections, [your role](user-roles.md#create-roles-and-assign-the-role-to-an-azure-active-directory-group) needs to have the **manage security settings** permission.
|
>To create and manage custom detections, [your role](user-roles.md#create-roles-and-assign-the-role-to-an-azure-active-directory-group) needs to have the **manage security settings** permission.
|
||||||
|
|
||||||
## Related topic
|
## Related topic
|
||||||
- [Create custom detection rules](custom-detection-rules.md)
|
- [Create and manage custom detection rules](custom-detection-rules.md)
|
||||||
|
|
||||||
|
|
||||||
Reference in New Issue
Block a user