From 0e61a4488159811927f2902d78aca3a1edb3d617 Mon Sep 17 00:00:00 2001 From: jaimeo Date: Mon, 7 Oct 2019 11:19:34 -0700 Subject: [PATCH 01/11] initial import of Charles' versions --- .../update/images/UC_commercialID.png | Bin 0 -> 29643 bytes .../update/images/UC_commercialID_GP.png | Bin 0 -> 84714 bytes .../update/images/UC_telemetrylevel.png | Bin 0 -> 88215 bytes ...update-compliance-delivery-optimization.md | 13 +- .../update/update-compliance-get-started.md | 204 +++++++++++------- .../update/update-compliance-monitor.md | 117 +++++----- .../update/update-compliance-using.md | 188 ++++++++-------- 7 files changed, 285 insertions(+), 237 deletions(-) create mode 100644 windows/deployment/update/images/UC_commercialID.png create mode 100644 windows/deployment/update/images/UC_commercialID_GP.png create mode 100644 windows/deployment/update/images/UC_telemetrylevel.png diff --git a/windows/deployment/update/images/UC_commercialID.png b/windows/deployment/update/images/UC_commercialID.png new file mode 100644 index 0000000000000000000000000000000000000000..6896be03e60f174074fb2e12627609915e40c449 GIT binary patch literal 29643 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 literal 0 HcmV?d00001 diff --git a/windows/deployment/update/images/UC_telemetrylevel.png b/windows/deployment/update/images/UC_telemetrylevel.png new file mode 100644 index 0000000000000000000000000000000000000000..a11e68a5f8e544a5dbff584a2bfab754afedbb46 GIT binary patch literal 88215 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
  • @@ -121,12 +121,13 @@ Harness the power of Surface, Windows, and Office connected together through the
    -

    Technical specifications

    -

    Surface Pro

    -

    Surface Book

    -

    Surface Studio

    -

    Surface Go

    -

    Surface Laptop 2

    +

    Tech specs

    +

    Surface Pro 7 for Business

    +

    Surface Pro X for Business

    +

    Surface Laptop 3 for Business

    +

    Surface Book 2 for Business

    +

    Surface Studio 2 for Business

    +

    Surface Go

    diff --git a/devices/surface/surface-dock-firmware-update.md b/devices/surface/surface-dock-firmware-update.md index 1bb2ddeb4b..8cbef59101 100644 --- a/devices/surface/surface-dock-firmware-update.md +++ b/devices/surface/surface-dock-firmware-update.md @@ -48,6 +48,12 @@ You can use Windows Installer commands (Msiexec.exe) to deploy Surface Dock Firm For more information, refer to [Command line options](https://docs.microsoft.com/windows/win32/msi/command-line-options) documentation. +## Intune deployment +You can use Intune to distribute Surface Dock Firmware Update to your devices. First you will need to convert the MSI file to the .intunewin format, as described in the following documentation: [Intune Standalone - Win32 app management](https://docs.microsoft.com/intune/apps/apps-win32-app-management). + +Use the following command: + - **msiexec /i /quiet /q** + ## How to verify completion of firmware update Surface dock firmware consists of two components: diff --git a/devices/surface/wake-on-lan-for-surface-devices.md b/devices/surface/wake-on-lan-for-surface-devices.md index 0c63bbe4b5..0ee065cb59 100644 --- a/devices/surface/wake-on-lan-for-surface-devices.md +++ b/devices/surface/wake-on-lan-for-surface-devices.md @@ -43,7 +43,7 @@ The following devices are supported for WOL: * Surface Laptop 2 * Surface Go * Surface Go with LTE Advanced -* Surface Studio (see Surface Studio instructions below) +* Surface Studio 2 (see Surface Studio 2 instructions below) ## WOL driver @@ -60,9 +60,9 @@ To extract the contents of SurfaceWOL.msi, use the MSIExec administrative instal `msiexec /a surfacewol.msi targetdir=C:\WOL /qn` -## Surface Studio instructions +## Surface Studio 2 instructions -To enable WOL on Surface Studio, you must use the following procedure +To enable WOL on Surface Studio 2, you must use the following procedure 1. Create the following registry keys: From f71273a5e0949220811bc8c55940173e054ecd93 Mon Sep 17 00:00:00 2001 From: John Liu <49762389+ShenLanJohn@users.noreply.github.com> Date: Tue, 15 Oct 2019 11:01:09 -0700 Subject: [PATCH 09/11] CAT Auto Pulish for Windows Release Messages - CAT_AutoPublish_20191015100154 (#1350) --- .../release-information/resolved-issues-windows-10-1803.yml | 2 ++ ...esolved-issues-windows-10-1809-and-windows-server-2019.yml | 2 ++ windows/release-information/status-windows-10-1803.yml | 4 ++-- .../status-windows-10-1809-and-windows-server-2019.yml | 4 ++-- windows/release-information/windows-message-center.yml | 1 + 5 files changed, 9 insertions(+), 4 deletions(-) diff --git a/windows/release-information/resolved-issues-windows-10-1803.yml b/windows/release-information/resolved-issues-windows-10-1803.yml index 9af252fa36..902f0805e5 100644 --- a/windows/release-information/resolved-issues-windows-10-1803.yml +++ b/windows/release-information/resolved-issues-windows-10-1803.yml @@ -32,6 +32,7 @@ sections: - type: markdown text: " + @@ -93,6 +94,7 @@ sections: - type: markdown text: "
    SummaryOriginating updateStatusDate resolved
    Startup to a black screen after installing updates
    Your device may startup to a black screen during the first logon after installing updates.

    See details >    		OS Build 17134.829

    June 11, 2019
    KB4503286    		Resolved
    KB4519978    		October 15, 2019
    10:00 AM PT
    Intermittent issues when printing
    The print spooler service may intermittently have issues completing a print job and may result in a print job being canceled or failing.

    See details >    		OS Build 17134.1009

    September 23, 2019
    KB4522014    		Resolved
    KB4520008    		October 08, 2019
    10:00 AM PT
    IME may become unresponsive or have High CPU usage
    Some Input Method Editor (IME) including ChsIME.EXE and ChtIME.EXE, may become unresponsive or may have high CPU usage.

    See details >    		OS Build 17134.1006

    September 10, 2019
    KB4516058    		Resolved
    		September 19, 2019
    04:08 PM PT
    Domain connected devices that use MIT Kerberos realms will not start up
    Devices may not start after updating when connected to a domain that is configured to use MIT Kerberos realms.

    See details >    		OS Build 17134.915

    July 16, 2019
    KB4507466    		Resolved
    KB4512501    		August 13, 2019
    10:00 AM PT
    + diff --git a/windows/release-information/resolved-issues-windows-10-1809-and-windows-server-2019.yml b/windows/release-information/resolved-issues-windows-10-1809-and-windows-server-2019.yml index 576221ee19..b7f21815a9 100644 --- a/windows/release-information/resolved-issues-windows-10-1809-and-windows-server-2019.yml +++ b/windows/release-information/resolved-issues-windows-10-1809-and-windows-server-2019.yml @@ -32,6 +32,7 @@ sections: - type: markdown text: "
    DetailsOriginating updateStatusHistory
    Startup to a black screen after installing updates
    We are investigating reports that a small number of devices may startup to a black screen during the first logon after installing updates.


    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803
    • Server: Windows Server 2019
    Resolution: This issue was resolved in KB4519978.

    Back to top    		OS Build 17134.829

    June 11, 2019
    KB4503286    		Resolved
    KB4519978    		Resolved:
    October 15, 2019
    10:00 AM PT

    Opened:
    June 14, 2019
    04:41 PM PT
    Difficulty connecting to some iSCSI-based SANs
    Devices may have issues connecting to some Storage Area Network (SAN) devices using Internet Small Computer System Interface (iSCSI) after installing KB4499183. You may also receive an error in the System log section of Event Viewer with Event ID 43 from iScsiPrt and a description of “Target failed to respond in time for a login request.”

    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803; Windows 10, version 1709; Windows 10, version 1703; Windows 10, version 1607; Windows 10 Enterprise LTSC 2016
    • Server: Windows Server 2019; Windows Server 2016
    Resolution: This issue was resolved in KB4509478.

    Back to top    		OS Build 17134.799

    May 21, 2019
    KB4499183    		Resolved
    KB4509478    		Resolved:
    June 26, 2019
    04:00 PM PT

    Opened:
    June 20, 2019
    04:46 PM PT
    Event Viewer may close or you may receive an error when using Custom Views
    When trying to expand, view, or create Custom Views in Event Viewer, you may receive the error, \"MMC has detected an error in a snap-in and will unload it.\" and the app may stop responding or close. You may also receive the same error when using Filter Current Log in the Action menu with built-in views or logs. Built-in views and other features of Event Viewer should work as expected.

    Affected platforms:
    • Client: Windows 10, version 1903; Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803; Windows 10, version 1709; Windows 10, version 1703; Windows 10, version 1607; Windows 10 Enterprise LTSC 2016; Windows 10 Enterprise LTSC 2015; Windows 8.1; Windows 7 SP1
    • Server: Windows Server 2019; Windows Server 2016; Windows Server 2012 R2; Windows Server 2012; Windows Server 2008 R2 SP1; Windows Server 2008 SP2
    Resolution: This issue was resolved in KB4503288.

    Back to top    		OS Build 17134.829

    June 11, 2019
    KB4503286    		Resolved
    KB4503288    		Resolved:
    June 18, 2019
    02:00 PM PT

    Opened:
    June 12, 2019
    11:11 AM PT
    Opening Internet Explorer 11 may fail
    Internet Explorer 11 may fail to open if Default Search Provider is not set or is malformed.

    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803; Windows 10, version 1709; Windows 10, version 1703; Windows 10 Enterprise LTSC 2016; Windows 10, version 1607
    • Server: Windows Server 2019; Windows Server 2016
    Resolution: This issue was resolved in KB4503286.

    Back to top    		OS Build 17134.799

    May 21, 2019
    KB4499183    		Resolved
    KB4503286    		Resolved:
    June 11, 2019
    10:00 AM PT

    Opened:
    June 05, 2019
    05:49 PM PT
    + @@ -100,6 +101,7 @@ sections: - type: markdown text: "
    SummaryOriginating updateStatusDate resolved
    Startup to a black screen after installing updates
    Your device may startup to a black screen during the first logon after installing updates.

    See details >    		OS Build 17763.557

    June 11, 2019
    KB4503327    		Resolved
    KB4520062    		October 15, 2019
    10:00 AM PT
    Intermittent issues when printing
    The print spooler service may intermittently have issues completing a print job and may result in a print job being canceled or failing.

    See details >    		OS Build 17763.740

    September 23, 2019
    KB4522015    		Resolved
    KB4519338    		October 08, 2019
    10:00 AM PT
    Apps and scripts using the NetQueryDisplayInformation API may fail with error
    Applications and scripts that call NetQueryDisplayInformation may fail to return results after the first page of data.

    See details >    		OS Build 17763.55

    October 09, 2018
    KB4464330    		Resolved
    KB4516077    		September 24, 2019
    10:00 AM PT
    IME may become unresponsive or have High CPU usage
    Some Input Method Editor (IME) including ChsIME.EXE and ChtIME.EXE, may become unresponsive or may have high CPU usage.

    See details >    		OS Build 17763.737

    September 10, 2019
    KB4512578    		Resolved
    		September 19, 2019
    04:08 PM PT
    + diff --git a/windows/release-information/status-windows-10-1803.yml b/windows/release-information/status-windows-10-1803.yml index 807dd2cfdf..b5ca2b64cb 100644 --- a/windows/release-information/status-windows-10-1803.yml +++ b/windows/release-information/status-windows-10-1803.yml @@ -64,10 +64,10 @@ sections: - type: markdown text: "
    This table offers a summary of current active issues and those issues that have been resolved in the last 30 days.

    DetailsOriginating updateStatusHistory
    Startup to a black screen after installing updates
    We are investigating reports that a small number of devices may startup to a black screen during the first logon after installing updates.


    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803
    • Server: Windows Server 2019
    Resolution: This issue was resolved in KB4520062.

    Back to top    		OS Build 17763.557

    June 11, 2019
    KB4503327    		Resolved
    KB4520062    		Resolved:
    October 15, 2019
    10:00 AM PT

    Opened:
    June 14, 2019
    04:41 PM PT
    Difficulty connecting to some iSCSI-based SANs
    Devices may have issues connecting to some Storage Area Network (SAN) devices using Internet Small Computer System Interface (iSCSI) after installing KB4497934. You may also receive an error in the System log section of Event Viewer with Event ID 43 from iScsiPrt and a description of “Target failed to respond in time for a login request.”

    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803; Windows 10, version 1709; Windows 10, version 1703; Windows 10, version 1607; Windows 10 Enterprise LTSC 2016
    • Server: Windows Server 2019; Windows Server 2016
    Resolution: This issue was resolved in KB4509479.

    Back to top    		OS Build 17763.529

    May 21, 2019
    KB4497934    		Resolved
    KB4509479    		Resolved:
    June 26, 2019
    04:00 PM PT

    Opened:
    June 20, 2019
    04:46 PM PT
    Devices with Realtek Bluetooth radios drivers may not pair or connect as expected
    In some circumstances, devices with Realtek Bluetooth radios may have issues pairing or connecting to Bluetooth devices due to a driver issue.

    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019
    • Server: Windows Server 2019
    Resolution: This issue was resolved in KB4501371.

    Back to top    		OS Build 17763.503

    May 14, 2019
    KB4494441    		Resolved
    KB4501371    		Resolved:
    June 18, 2019
    02:00 PM PT

    Opened:
    June 14, 2019
    05:45 PM PT
    Event Viewer may close or you may receive an error when using Custom Views
    When trying to expand, view, or create Custom Views in Event Viewer, you may receive the error, \"MMC has detected an error in a snap-in and will unload it.\" and the app may stop responding or close. You may also receive the same error when using Filter Current Log in the Action menu with built-in views or logs. Built-in views and other features of Event Viewer should work as expected.

    Affected platforms:
    • Client: Windows 10, version 1903; Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803; Windows 10, version 1709; Windows 10, version 1703; Windows 10, version 1607; Windows 10 Enterprise LTSC 2016; Windows 10 Enterprise LTSC 2015; Windows 8.1; Windows 7 SP1
    • Server: Windows Server 2019; Windows Server 2016; Windows Server 2012 R2; Windows Server 2012; Windows Server 2008 R2 SP1; Windows Server 2008 SP2
    Resolution: This issue was resolved in KB4501371.

    Back to top    		OS Build 17763.557

    June 11, 2019
    KB4503327    		Resolved
    KB4501371    		Resolved:
    June 18, 2019
    02:00 PM PT

    Opened:
    June 12, 2019
    11:11 AM PT
    + -
    SummaryOriginating updateStatusLast updated
    Startup to a black screen after installing updates
    Your device may startup to a black screen during the first logon after installing updates.

    See details >    		OS Build 17134.829

    June 11, 2019
    KB4503286    		Resolved
    KB4519978    		October 15, 2019
    10:00 AM PT
    Intermittent issues when printing
    The print spooler service may intermittently have issues completing a print job and may result in a print job being canceled or failing.

    See details >    		OS Build 17134.1009

    September 23, 2019
    KB4522014    		Resolved
    KB4520008    		October 08, 2019
    10:00 AM PT
    IME may become unresponsive or have High CPU usage
    Some Input Method Editor (IME) including ChsIME.EXE and ChtIME.EXE, may become unresponsive or may have high CPU usage.

    See details >    		OS Build 17134.1006

    September 10, 2019
    KB4516058    		Resolved
    		September 19, 2019
    04:08 PM PT
    Windows Mixed Reality Portal users may intermittently receive a 15-5 error code
    You may receive a 15-5 error code in Windows Mixed Reality Portal and your headset may not wake up from sleep.

    See details >    		OS Build 17134.950

    August 13, 2019
    KB4512501    		Mitigated
    		September 11, 2019
    05:32 PM PT
    Startup to a black screen after installing updates
    Your device may startup to a black screen during the first logon after installing updates.

    See details >    		OS Build 17134.829

    June 11, 2019
    KB4503286    		Mitigated
    		June 14, 2019
    04:41 PM PT
    Certain operations performed on a Cluster Shared Volume may fail
    Operations performed on files or folders on a CSV may fail with the error: STATUS_BAD_IMPERSONATION_LEVEL (0xC00000A5).

    See details >    		OS Build 17134.523

    January 08, 2019
    KB4480966    		Mitigated
    		April 25, 2019
    02:00 PM PT
    " @@ -95,7 +95,7 @@ sections: - type: markdown text: " - +
    DetailsOriginating updateStatusHistory
    Startup to a black screen after installing updates
    We are investigating reports that a small number of devices may startup to a black screen during the first logon after installing updates.


    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803
    • Server: Windows Server 2019
    Workaround: To mitigate this issue, press Ctrl+Alt+Delete, then select the Power button in the lower right corner of the screen and select Restart. Your device should now restart normally.

    Next steps: We are working on a resolution and will provide an update in an upcoming release.

    Back to top    		OS Build 17134.829

    June 11, 2019
    KB4503286    		Mitigated
    		Last updated:
    June 14, 2019
    04:41 PM PT

    Opened:
    June 14, 2019
    04:41 PM PT
    Startup to a black screen after installing updates
    We are investigating reports that a small number of devices may startup to a black screen during the first logon after installing updates.


    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803
    • Server: Windows Server 2019
    Resolution: This issue was resolved in KB4519978.

    Back to top    		OS Build 17134.829

    June 11, 2019
    KB4503286    		Resolved
    KB4519978    		Resolved:
    October 15, 2019
    10:00 AM PT

    Opened:
    June 14, 2019
    04:41 PM PT
    " diff --git a/windows/release-information/status-windows-10-1809-and-windows-server-2019.yml b/windows/release-information/status-windows-10-1809-and-windows-server-2019.yml index 9bae55dbb7..86439683f6 100644 --- a/windows/release-information/status-windows-10-1809-and-windows-server-2019.yml +++ b/windows/release-information/status-windows-10-1809-and-windows-server-2019.yml @@ -64,11 +64,11 @@ sections: - type: markdown text: "
    This table offers a summary of current active issues and those issues that have been resolved in the last 30 days.

    + -
    SummaryOriginating updateStatusLast updated
    Startup to a black screen after installing updates
    Your device may startup to a black screen during the first logon after installing updates.

    See details >    		OS Build 17763.557

    June 11, 2019
    KB4503327    		Resolved
    KB4520062    		October 15, 2019
    10:00 AM PT
    Intermittent issues when printing
    The print spooler service may intermittently have issues completing a print job and may result in a print job being canceled or failing.

    See details >    		OS Build 17763.740

    September 23, 2019
    KB4522015    		Resolved
    KB4519338    		October 08, 2019
    10:00 AM PT
    Apps and scripts using the NetQueryDisplayInformation API may fail with error
    Applications and scripts that call NetQueryDisplayInformation may fail to return results after the first page of data.

    See details >    		OS Build 17763.55

    October 09, 2018
    KB4464330    		Resolved
    KB4516077    		September 24, 2019
    10:00 AM PT
    IME may become unresponsive or have High CPU usage
    Some Input Method Editor (IME) including ChsIME.EXE and ChtIME.EXE, may become unresponsive or may have high CPU usage.

    See details >    		OS Build 17763.737

    September 10, 2019
    KB4512578    		Resolved
    		September 19, 2019
    04:08 PM PT
    Windows Mixed Reality Portal users may intermittently receive a 15-5 error code
    You may receive a 15-5 error code in Windows Mixed Reality Portal and your headset may not wake up from sleep.

    See details >    		OS Build 17763.678

    August 13, 2019
    KB4511553    		Mitigated
    		September 11, 2019
    05:32 PM PT
    Startup to a black screen after installing updates
    Your device may startup to a black screen during the first logon after installing updates.

    See details >    		OS Build 17763.557

    June 11, 2019
    KB4503327    		Mitigated
    		June 14, 2019
    04:41 PM PT
    Devices with some Asian language packs installed may receive an error
    Devices with Asian language packs installed may receive the error, \"0x800f0982 - PSFX_E_MATCHING_COMPONENT_NOT_FOUND.\"

    See details >    		OS Build 17763.437

    April 09, 2019
    KB4493509    		Mitigated
    		May 03, 2019
    10:59 AM PT
    Certain operations performed on a Cluster Shared Volume may fail
    Operations performed on files or folders on a CSV may fail with the error: STATUS_BAD_IMPERSONATION_LEVEL (0xC00000A5).

    See details >    		OS Build 17763.253

    January 08, 2019
    KB4480116    		Mitigated
    		April 09, 2019
    10:00 AM PT
    @@ -106,7 +106,7 @@ sections: - type: markdown text: " - +
    DetailsOriginating updateStatusHistory
    Startup to a black screen after installing updates
    We are investigating reports that a small number of devices may startup to a black screen during the first logon after installing updates.


    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803
    • Server: Windows Server 2019
    Workaround: To mitigate this issue, press Ctrl+Alt+Delete, then select the Power button in the lower right corner of the screen and select Restart. Your device should now restart normally.

    Next steps: We are working on a resolution and will provide an update in an upcoming release.

    Back to top    		OS Build 17763.557

    June 11, 2019
    KB4503327    		Mitigated
    		Last updated:
    June 14, 2019
    04:41 PM PT

    Opened:
    June 14, 2019
    04:41 PM PT
    Startup to a black screen after installing updates
    We are investigating reports that a small number of devices may startup to a black screen during the first logon after installing updates.


    Affected platforms:
    • Client: Windows 10, version 1809; Windows 10 Enterprise LTSC 2019; Windows 10, version 1803
    • Server: Windows Server 2019
    Resolution: This issue was resolved in KB4520062.

    Back to top    		OS Build 17763.557

    June 11, 2019
    KB4503327    		Resolved
    KB4520062    		Resolved:
    October 15, 2019
    10:00 AM PT

    Opened:
    June 14, 2019
    04:41 PM PT
    " diff --git a/windows/release-information/windows-message-center.yml b/windows/release-information/windows-message-center.yml index c6fa6957a7..a41c2b4de0 100644 --- a/windows/release-information/windows-message-center.yml +++ b/windows/release-information/windows-message-center.yml @@ -50,6 +50,7 @@ sections: text: " + From 270f0bfb3f29bff95ee3562af01e662bbcb9c7d5 Mon Sep 17 00:00:00 2001 From: jaimeo Date: Tue, 15 Oct 2019 11:13:15 -0700 Subject: [PATCH 10/11] fixing spelling and other errors --- .../deployment/update/update-compliance-get-started.md | 4 ++-- windows/deployment/update/update-compliance-using.md | 2 +- .../deployment/update/waas-delivery-optimization-setup.md | 4 ++-- .../upgrade/upgrade-readiness-deployment-script.md | 2 +- .../deployment/upgrade/upgrade-readiness-get-started.md | 8 ++++---- .../upgrade/upgrade-readiness-monitor-deployment.md | 2 +- .../deployment/upgrade/upgrade-readiness-requirements.md | 2 +- .../upgrade/upgrade-readiness-upgrade-overview.md | 4 ++-- 8 files changed, 14 insertions(+), 14 deletions(-) diff --git a/windows/deployment/update/update-compliance-get-started.md b/windows/deployment/update/update-compliance-get-started.md index 7b176cbb39..03cf9cabc8 100644 --- a/windows/deployment/update/update-compliance-get-started.md +++ b/windows/deployment/update/update-compliance-get-started.md @@ -50,7 +50,7 @@ Update Compliance is offered as a solution which is linked to a new or existing ![Update Compliance solution creation](images/UC_01_marketplace_create.png) 4. Choose an existing workspace or create a new workspace that will be assigned to the Update Compliance solution. - - [Desktop Analytics](TODO: Add Desktop Analytics reference: https://docs.microsoft.com/en-us/sccm/desktop-analytics/overview) customers are advised to use the same workspace for Update Compliance. + - [Desktop Analytics](https://docs.microsoft.com/en-us/sccm/desktop-analytics/overview) customers are advised to use the same workspace for Update Compliance. - If you are creating a new workspace, and your organization does not have policies governing naming conventions and structure, consider the following workspace settings to get started: - Choose a workspace name which reflects the scope of planned usage in your organization, for example *PC-Analytics*. - For the resource group setting select **Create new** and use the same name you chose for your new workspace. @@ -106,7 +106,7 @@ To enable data sharing between devices, your network, and Microsoft's Diagnostic | `https://login.live.com` | This endpoint is optional but allows for the Update Compliance service to more reliably identify and process devices. If you want to disable end-user managed service account (MSA) access, you should apply the appropriate [policy](https://docs.microsoft.com/windows/security/identity-protection/access-control/microsoft-accounts#block-all-consumer-microsoft-account-user-authentication) instead of blocking this endpoint. | ### Set diagnostic data levels -Update Compliance requries that devices are configured to send Microsoft at least the Basic level of diagnostic data in order to function. For more information on Windows diagnostic data, see [Configure Windows diagnostic data in your organization](https://docs.microsoft.com/en-us/windows/privacy/configure-windows-diagnostic-data-in-your-organization). +Update Compliance requires that devices are configured to send Microsoft at least the Basic level of diagnostic data in order to function. For more information on Windows diagnostic data, see [Configure Windows diagnostic data in your organization](https://docs.microsoft.com/en-us/windows/privacy/configure-windows-diagnostic-data-in-your-organization). #### Configuring Telemetry level using Group Policy You can set Allow Telemetry through Group Policy, this setting is in the same place as the Commercial ID policy, under **Computer Configuration\Administrative Templates\Windows Components\Data Collection and Preview Builds\Allow Telemetry**. Update Compliance requires at least Basic (level 1) to function. diff --git a/windows/deployment/update/update-compliance-using.md b/windows/deployment/update/update-compliance-using.md index 4234827db4..932d20458b 100644 --- a/windows/deployment/update/update-compliance-using.md +++ b/windows/deployment/update/update-compliance-using.md @@ -2,7 +2,7 @@ title: Using Update Compliance (Windows 10) ms.reviewer: manager: laurawi -description: Explains how to begin usihg Update Compliance. +description: Explains how to begin using Update Compliance. keywords: oms, operations management suite, wdav, updates, upgrades, antivirus, antimalware, signature, log analytics ms.prod: w10 ms.mktglfcycl: deploy diff --git a/windows/deployment/update/waas-delivery-optimization-setup.md b/windows/deployment/update/waas-delivery-optimization-setup.md index de20e4993f..0d016a2ce4 100644 --- a/windows/deployment/update/waas-delivery-optimization-setup.md +++ b/windows/deployment/update/waas-delivery-optimization-setup.md @@ -25,7 +25,7 @@ ms.topic: article ## Recommended Delivery Optimization settings -Delivery Optimization offers a great many settings to fine-tune its behavior (see [Delivery Optimization reference](waas-delivery-optimization-reference.md) for a comprehensive list), but for the most efficient performance, there are just a few key parameters that will have the greates impact if particular situations exist in your deployment: +Delivery Optimization offers a great many settings to fine-tune its behavior (see [Delivery Optimization reference](waas-delivery-optimization-reference.md) for a comprehensive list), but for the most efficient performance, there are just a few key parameters that will have the greatest impact if particular situations exist in your deployment: - Does your topology include multiple breakouts to the internet (i.e., a "hybrid WAN") or are there only a few connections to the internet, so that all requests appear to come from a single external IP address (a "hub and spoke" topology)? - If you use boundary groups in your topology, how many devices are present in a given group? @@ -156,7 +156,7 @@ You can now "pin" files to keep them persistent in the cache. You can only do th `set-DeliveryOptimizationStatus -Pin [True] -File ID [FileID]` keeps a specific file in the cache such that it won't be deleted until the expiration date and time (which you set with `set-DeliveryOptimizationStatus -ExpireOn [date time] -FileID [FileID]`). The file is also excluded from the cache quota calculation. -`set-DeliveryOptimizationStatus -Pin [False] -File ID [FileID]` "unpins" a file, so that it will be deleted when the expiration date and time are rreached. The file is included in the cache quota calculation. +`set-DeliveryOptimizationStatus -Pin [False] -File ID [FileID]` "unpins" a file, so that it will be deleted when the expiration date and time are reached. The file is included in the cache quota calculation. `delete-DeliveryOptimizationCache` lets you clear files from the cache and remove all persisted data related to them. You can use these options with this cmdlet: diff --git a/windows/deployment/upgrade/upgrade-readiness-deployment-script.md b/windows/deployment/upgrade/upgrade-readiness-deployment-script.md index 1891acd137..a56896ded3 100644 --- a/windows/deployment/upgrade/upgrade-readiness-deployment-script.md +++ b/windows/deployment/upgrade/upgrade-readiness-deployment-script.md @@ -143,7 +143,7 @@ Error creating or updating registry key: **CommercialId** at **HKLM:\SOFTWARE\Mi | 45 - Diagtrack.dll was not found. | Update the device using Windows Update or Windows Server Update Services. | | 48 - **CommercialID** mentioned in RunConfig.bat should be a GUID. | Copy the commercial ID from your workspace. To find your commercial ID, first navigate to the Solutions tab for your workspace in Azure Portal, and then select the solution. From there, select the **Settings** page, where you can find and copy your commercial ID.| | 50 - Diagtrack Service is not running. | The Diagtrack service is required to send data to Microsoft. Enable and run the "Connected User Experiences and Telemetry" service. | -| 51 - RunCensus failed with an unexpected exception. | RunCensus explitly runs the process used to collect device information. The method failed with an unexpected exception. The most common cause is incorrect setup of diagnostic data. Check the ExceptionHResult and ExceptionMessage for more details. | +| 51 - RunCensus failed with an unexpected exception. | RunCensus explicitly runs the process used to collect device information. The method failed with an unexpected exception. The most common cause is incorrect setup of diagnostic data. Check the ExceptionHResult and ExceptionMessage for more details. | | 52 - DeviceCensus.exe not found on a Windows 10 machine. | On computers running Windows 10, the process devicecensus.exe should be present in the \system32 directory. Error code 52 is returned if the process was not found. Ensure that it exists at the specified location. | | 53 - There is a different CommercialID present at the GPO path: **HKLM:\SOFTWARE\Policies\Microsoft \Windows\DataCollection**. This will take precedence over the CommercialID provided in the script. | Provide the correct CommercialID at the GPO location. | | 54 - Microsoft Account Sign In Assistant Service is Disabled. | This service is required for devices running Windows 10. The diagnostic data client relies on the Microsoft Account Sign In Assistant (MSA) to get the Global Device ID for the device. Without the MSA service running, the global device ID will not be generated and sent by the client and Windows Update will no longer offer feature updates to devices running Windows 10 1709 or higher. See [Feature updates are not being offered while other updates are](https://docs.microsoft.com/windows/deployment/update/windows-update-troubleshooting#feature-updates-are-not-being-offered-while-other-updates-are). | diff --git a/windows/deployment/upgrade/upgrade-readiness-get-started.md b/windows/deployment/upgrade/upgrade-readiness-get-started.md index 19c322e4bf..bbac04bea3 100644 --- a/windows/deployment/upgrade/upgrade-readiness-get-started.md +++ b/windows/deployment/upgrade/upgrade-readiness-get-started.md @@ -23,7 +23,7 @@ ms.collection: M365-analytics This topic explains how to obtain and configure Upgrade Readiness for your organization. -You can use Upgrade Readiness to plan and manage your upgrade project end-to-end. Upgrade Readiness works by establishing communications between computers in your organization and Microsoft. Upgrade Readiness collects computer, application, and driver data for analysis. This data is used to identify compatibility issues that can block your upgrade and to suggest fixes that are known to Microsoft. +You can use Upgrade Readiness to plan and manage your upgrade project end to end. Upgrade Readiness works by establishing communications between computers in your organization and Microsoft. Upgrade Readiness collects computer, application, and driver data for analysis. This data is used to identify compatibility issues that can block your upgrade and to suggest fixes that are known to Microsoft. Before you begin, consider reviewing the following helpful information:
    - [Upgrade Readiness requirements](upgrade-readiness-requirements.md): Provides detailed requirements to use Upgrade Readiness.
    @@ -34,17 +34,17 @@ Before you begin, consider reviewing the following helpful information:
    When you are ready to begin using Upgrade Readiness, perform the following steps: 1. Review [data collection and privacy](#data-collection-and-privacy) information. -2. [Add the Upgrade Readiness solution to your Azure subsctiption](#add-the-upgrade-readiness-solution-to-your-azure-subscription). +2. [Add the Upgrade Readiness solution to your Azure subscription](#add-the-upgrade-readiness-solution-to-your-azure-subscription). 3. [Enroll devices in Windows Analytics](#enroll-devices-in-windows-analytics). 4. [Use Upgrade Readiness to manage Windows Upgrades](#use-upgrade-readiness-to-manage-windows-upgrades) once your devices are enrolled. ## Data collection and privacy -To enable system, application, and driver data to be shared with Microsoft, you must configure user computers to send data. For information about what diagnostic data Microsoft collects and how that data is used and protected by Microsoft, see the following topics, refer to [Frequently asked questions and troubleshooting Windows Analytics](https://docs.microsoft.com/windows/deployment/update/windows-analytics-FAQ-troubleshooting), which discusses the issues and provides links to still more detailed information. +To enable system, application, and driver data to be shared with Microsoft, you must configure user computers to send data. For information about what diagnostic data Microsoft collects and how that data is used and protected by Microsoft, see [Frequently asked questions and troubleshooting Windows Analytics](https://docs.microsoft.com/windows/deployment/update/windows-analytics-FAQ-troubleshooting), which discusses the issues and provides links to still more detailed information. ## Add the Upgrade Readiness solution to your Azure subscription -Upgrade Readiness is offered as a *solution* which you link to a new or existing [Azure Log Analytics](https://azure.microsoft.com/services/log-analytics/) *workspace* within your Azure *subscription*. To configure this, follows these steps: +Upgrade Readiness is offered as a *solution* which you link to a new or existing [Azure Log Analytics](https://azure.microsoft.com/services/log-analytics/) *workspace* within your Azure *subscription*. To configure this, follow these steps: 1. Sign in to the [Azure Portal](https://portal.azure.com) with your work or school account or a Microsoft account. If you don't already have an Azure subscription you can create one (including free trial options) through the portal. diff --git a/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md b/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md index 50d11a0876..7fdb58ffe0 100644 --- a/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md +++ b/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md @@ -25,7 +25,7 @@ Now that you have started deploying an update with Upgrade Readiness, you can us ## Update progress -The **Update progress** blade allows you to monitor the progress and status of your deployment. Any device that has attepted to upgrade in the last 30 days displays the **DeploymentStatus** attribute. You'll be able to see the number of computers that have successfully upgraded, failed to upgrade, are stalled, etc. +The **Update progress** blade allows you to monitor the progress and status of your deployment. Any device that has attempted to upgrade in the last 30 days displays the **DeploymentStatus** attribute. You'll be able to see the number of computers that have successfully upgraded, failed to upgrade, are stalled, etc. Selecting this blade allows you to view device-level details about the deployment. For example, select **Failed** to view the original operating system version, the target operating system version, and the reason the update failed for each of the devices that failed to upgrade. In the case of the device illustrated in the following image, an attempt was made to upgrade from Windows 10, version 1703 to 1709, but the operation timed out. diff --git a/windows/deployment/upgrade/upgrade-readiness-requirements.md b/windows/deployment/upgrade/upgrade-readiness-requirements.md index fd00c603e7..5de1e052e6 100644 --- a/windows/deployment/upgrade/upgrade-readiness-requirements.md +++ b/windows/deployment/upgrade/upgrade-readiness-requirements.md @@ -63,7 +63,7 @@ Upgrade Readiness can be integrated with your installation of Configuration Mana ## Important information about this release -Before you get started configuring Upgrade Anatlyics, review the following tips and limitations about this release. +Before you get started configuring Upgrade Readiness, review the following tips and limitations about this release. **Upgrade Readiness does not support on-premises Windows deployments.** Upgrade Readiness is built as a cloud service, which allows Upgrade Readiness to provide you with insights based on the data from user computers and other Microsoft compatibility services. Cloud services are easy to get up and running and are cost-effective because there is no requirement to physically implement and maintain services on-premises. diff --git a/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md b/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md index b78fcd2044..78ad55ad25 100644 --- a/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md +++ b/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md @@ -18,7 +18,7 @@ ms.collection: M365-analytics The first blade in the Upgrade Readiness solution is the upgrade overview blade. This blade displays the total count of computers sharing data with Microsoft, and the count of computers upgraded. As you successfully upgrade computers, the count of computers upgraded increases. -The upgrade overivew blade displays data refresh status, including the date and time of the most recent data update and whether user changes are reflected. The upgrade overview blade also displays the current target OS version. For more information about the target OS version, see [target version](use-upgrade-readiness-to-manage-windows-upgrades.md#target-version). +The upgrade overview blade displays data refresh status, including the date and time of the most recent data update and whether user changes are reflected. The upgrade overview blade also displays the current target OS version. For more information about the target OS version, see [target version](use-upgrade-readiness-to-manage-windows-upgrades.md#target-version). The following color-coded status changes are reflected on the upgrade overview blade: @@ -53,7 +53,7 @@ In the following example, there is no delay in data processing, more than 10% of If data processing is delayed, the "Last updated" banner will indicate the date on which data was last updated. You can continue using your workspace as normal. However, any changes or additional information that is added might not be displayed until data is refreshed. When your workspace is in this state, there is no action required; data is typically refreshed and the display will return to normal again within 24 hours. -If there are computers with incomplete data, verify that you have installed the latest compatibilty updates. Install the updates if necessary and then run the most recent [Update Readiness deployment script](https://go.microsoft.com/fwlink/?LinkID=822966&clcid=0x409) from the Microsoft download center. The updated data payload should appear in Upgrade Readiness within 48 hours of a successful run on the deployment script. +If there are computers with incomplete data, verify that you have installed the latest compatibility updates. Install the updates if necessary and then run the most recent [Upgrade Readiness deployment script](https://go.microsoft.com/fwlink/?LinkID=822966&clcid=0x409) from the Microsoft download center. The updated data payload should appear in Upgrade Readiness within 48 hours of a successful run on the deployment script. Select **Total computers** for a list of computers and details about them, including: From e67976b0c08f89432e5a6b51a7b1c27ba4bec60a Mon Sep 17 00:00:00 2001 From: Joey Caparas Date: Tue, 15 Oct 2019 14:19:47 -0700 Subject: [PATCH 11/11] add note --- .../threat-protection/microsoft-defender-atp/machine-tags.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/windows/security/threat-protection/microsoft-defender-atp/machine-tags.md b/windows/security/threat-protection/microsoft-defender-atp/machine-tags.md index 08ab2a0d71..3d3a959ecb 100644 --- a/windows/security/threat-protection/microsoft-defender-atp/machine-tags.md +++ b/windows/security/threat-protection/microsoft-defender-atp/machine-tags.md @@ -49,6 +49,9 @@ To add machine tags using API, see [Add or remove machine tags API](add-or-remov Tags are added to the machine view and will also be reflected on the **Machines list** view. You can then use the **Tags** filter to see the relevant list of machines. +>[!NOTE] +> Filtering might not work on tag names that contain parenthesis. + You can also delete tags from this view. ![Image of adding tags on a machine](images/more-manage-tags.png)
    MessageDate
    October 2019 Windows \"C\" optional release is available.
    The October 2019 optional monthly “C” release for all supported versions of Windows is now available. For more information on the different types of monthly quality updates, see our Windows 10 update servicing cadence primer. Follow @WindowsUpdate for the latest on the availability of this release.
    		October 15, 2019
    09:59 AM PT
    Windows 10, version 1703 has reached end of service
    Consumer and commercial editions of Windows 10, version 1703 have reached end of service. As devices running these editions are no longer receiving monthly security and quality updates containing protections from the latest security threats, we recommend that you update these devices to the latest version of Windows 10 immediately. For more information on end of service dates currently supported versions of Windows 10, see the Windows lifecycle fact sheet.
    		October 09, 2019
    12:00 PM PT
    Take Action: October 2019 security update available for all supported versions of Windows
    The October 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. For more information on the different types of monthly quality updates, see our Windows 10 update servicing cadence primer. To be informed about the latest updates and releases, follow us on Twitter @WindowsUpdate.
     
    		October 08, 2019
    08:00 AM PT
    Take action: Security update available for all supported versions of Windows
    On October 3, 2019, Microsoft expanded delivery of the out-of-band Internet Explorer scripting engine security vulnerability (CVE-2019-1367) update released on September 23, 2019 to Windows Update and Windows Server Update Services (WSUS). This is now a required security update for all supported versions of Windows as it includes the Internet Explorer scripting engine vulnerability mitigation and corrects a recent printing issue some users have experienced. All customers using Windows Update or WSUS will be offered this update automatically. We recommend that you install this update as soon as a possible, then restart your PC to fully apply the mitigations and help secure your devices. As with all cumulative updates, this update supersedes any preceding update.
     
    Note: This update does not replace the standard October 2019 monthly security update release, which is scheduled for October 8, 2019.
    		October 03, 2019
    08:00 AM PT

aBeFlGWn@xH=z?T)xWycX=OAoHJ$Y+wT$0o1wos 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 QhOco!`{KEhv-aWt2ScY}cK`qY literal 0 HcmV?d00001 diff --git a/windows/deployment/update/update-compliance-delivery-optimization.md b/windows/deployment/update/update-compliance-delivery-optimization.md index a637aea0a8..0f64c2b157 100644 --- a/windows/deployment/update/update-compliance-delivery-optimization.md +++ b/windows/deployment/update/update-compliance-delivery-optimization.md @@ -17,14 +17,8 @@ ms.topic: article --- # Delivery Optimization in Update Compliance -The Update Compliance solution of Windows Analytics provides you with information about your Delivery Optimization configuration, including the observed bandwidth savings across all devices that used peer-to-peer distribution over the past 28 days. - ![DO status](images/UC_workspace_DO_status.png) - -> [!IMPORTANT] -> There is a known issue with the way device configuration is displayed for Delivery Optimization. Some devices running Windows 10, versions 1809 or 1903 report the Delivery Optimization DownloadMode configuration value as the sequential value in the list of possible configurations rather than the actual configured value. For example, a device that is configured as HTTP + Group (2), will be shown as HTTP + Internet (3) in Update Compliance. -> ->**This issue is now fixed by installing the 2019-07 cumulative update appropriate for the device.** +The Update Compliance solution of Windows Analytics provides you with information about your Delivery Optimization configuration, including the observed bandwidth savings across all devices that used peer-to-peer distribution over the past 28 days. ## Delivery Optimization Status @@ -34,11 +28,9 @@ The Delivery Optimization Status section includes three blades: - The **Content Distribution (%)** blade shows the percentage of bandwidth savings for each category - The **Content Distribution (GB)** blade shows the total amount of data seen from each content type broken down by the download source (peers vs non-peers). - - ## Device Configuration blade -Devices can be set to use different download modes; these download modes determine in what situations Delivery Optimization will use peer-to-peer distribution to accomplish the downloads. The top section shows the number of devices configured to use peer-to-peer distribution in *Peering On* compared to *Peering Off* modes. The table shows a breakdown of the various download mode configurations seen in your environment. For more information about the different configuration options, see [Set up Delivery Optimization for Windows 10 updates](waas-delivery-optimization-setup.md) for recommendations for different scenarios or [Delivery Optimization reference](waas-delivery-optimization-reference.md#download-mode) for complete details of this setting. +Devices can be set to use different download modes; these download modes determine in what situations Delivery Optimization will use peer-to-peer distribution to accomplish the downloads. The top section shows the number of devices configured to use peer-to-peer distribution in *Peering On* compared to *Peering Off* modes. The table shows a breakdown of the various download mode configurations seen in your environment. For more information about the different configuration options, see [Configure Delivery Optimization for Windows 10 updates](waas-delivery-optimization.md#download-mode). ## Content Distribution (%) blade The first of two blades showing information on content breakdown, this blade shows a ring chart summarizing **Bandwidth Savings %**, which is the percentage of data received from peer sources out of the total data downloaded (for any device that used peer-to-peer distribution). @@ -52,4 +44,3 @@ The download sources that could be included are: - LAN Bytes: Bytes downloaded from LAN Peers which are other devices on the same local network - Group Bytes: Bytes downloaded from Group Peers which are other devices that belong to the same Group (available when the “Group” download mode is used) - HTTP Bytes: Non-peer bytes. The HTTP download source can be Microsoft Servers, Windows Update Servers, a WSUS server or an SCCM Distribution Point for Express Updates. - diff --git a/windows/deployment/update/update-compliance-get-started.md b/windows/deployment/update/update-compliance-get-started.md index 8a005eb69d..7b176cbb39 100644 --- a/windows/deployment/update/update-compliance-get-started.md +++ b/windows/deployment/update/update-compliance-get-started.md @@ -1,75 +1,129 @@ ---- -title: Get started with Update Compliance (Windows 10) -ms.reviewer: -manager: laurawi -description: Configure Update Compliance in Azure Portal to see the status of updates and antimalware protection on devices in your network. -keywords: update compliance, oms, operations management suite, prerequisites, requirements, updates, upgrades, antivirus, antimalware, signature, log analytics, wdav -ms.prod: w10 -ms.mktglfcycl: deploy -ms.sitesec: library -ms.pagetype: deploy -audience: itpro author: greg-lindsay -ms.author: greglin -ms.localizationpriority: medium -ms.collection: M365-analytics -ms.topic: article ---- - -# Get started with Update Compliance -This topic explains the steps necessary to configure your environment for Windows Analytics: Update Compliance. - -Steps are provided in sections that follow the recommended setup process: - -1. Ensure you meet the [Update Compliance prerequisites](#update-compliance-prerequisites). -2. [Add Update Compliance to your Azure subscription](#add-update-compliance-to-your-azure-subscription). -3. [Enroll devices in Windows Analytics](#enroll-devices-in-windows-analytics). -4. [Use Update Compliance](update-compliance-using.md) to monitor Windows Updates, Windows Defender Antivirus status, and Delivery Optimization. - -## Update Compliance prerequisites -Before you begin the process to add Update Compliance to your Azure subscription, first ensure you can meet the prerequisites: -1. Update Compliance works only with Windows 10 Professional, Education, and Enterprise editions. Update Compliance only provides data for the standard Desktop Windows 10 version and is not currently compatible with Windows Server, Surface Hub, IoT, etc. -2. Update Compliance provides detailed deployment data for devices on the Semi-Annual Channel and the Long-term Servicing Channel. Update Compliance will show Windows Insider Preview devices, but currently will not provide detailed deployment information for them. -3. Update Compliance requires at least the Basic level of diagnostic data and a Commercial ID to be enabled on the device. -4. To show device names for versions of Windows 10 starting with 1803 in Windows Analytics you must opt in. For details about this, see the "AllowDeviceNameinTelemetry (in Windows 10)" entry in the table in the [Distributing policies at scale](windows-analytics-get-started.md#deploying-windows-analytics-at-scale) section of [Enrolling devices in Windows Analytics](windows-analytics-get-started.md). -5. To use the Windows Defender Status, devices must be E3-licensed and have Cloud Protection enabled. E5-licensed devices will not appear here. For E5 devices, you should use [Windows Defender ATP](https://docs.microsoft.com/sccm/protect/deploy-use/windows-defender-advanced-threat-protection) instead. For more information on Windows 10 Enterprise licensing, see [Windows 10 Enterprise: FAQ for IT Professionals](https://docs.microsoft.com/windows/deployment/planning/windows-10-enterprise-faq-itpro). - -## Add Update Compliance to your Azure subscription -Update Compliance is offered as a solution which is linked to a new or existing [Azure Log Analytics](https://docs.microsoft.com/azure/log-analytics/query-language/get-started-analytics-portal) workspace within your Azure subscription. To configure this, follow these steps: - -1. Sign in to the [Azure Portal](https://portal.azure.com) with your work or school account or a Microsoft account. If you don't already have an Azure subscription you can create one (including free trial options) through the portal. - -> [!NOTE] -> Update Compliance is included at no additional cost with Windows 10 Professional, Education, and Enterprise editions. An Azure subscription is required for managing and using Update Compliance, but no Azure charges are expected to accrue to the subscription as a result of using Update Compliance. - -2. In the Azure portal select **+ Create a resource**, and search for “Update Compliance". You should see it in the results below. - -![Update Compliance marketplace search results](images/UC_00_marketplace_search.png) - -3. Select **Update Compliance** and a blade will appear summarizing the solution’s offerings. At the bottom, select **Create** to begin adding the solution to Azure. - -![Update Compliance solution creation](images/UC_01_marketplace_create.png) - -4. Choose an existing workspace or create a new workspace that will be assigned to the Update Compliance solution. - - If you already have another Windows Analytics solution, you should use the same workspace. - - If you are creating a new workspace, and your organization does not have policies governing naming conventions and structure, consider the following workspace settings to get started: - - Choose a workspace name which reflects the scope of planned usage in your organization, for example *PC-Analytics*. - - For the resource group setting select **Create new** and use the same name you chose for your new workspace. - - For the location setting, choose the Azure region where you would prefer the data to be stored. - - For the pricing tier select **per GB**. - -![Update Compliance workspace creation](images/UC_02_workspace_create.png) - -5. The resource group and workspace creation process could take a few minutes. After this, you are able to use that workspace for Update Compliance. Select **Create**. - -![Update Compliance workspace selection](images/UC_03_workspace_select.png) - -6. Watch for a notification in the Azure portal that your deployment has been successful. This might take a few minutes. Then, select **Go to resource**. - -![Update Compliance deployment successful](images/UC_04_resourcegrp_deployment_successful.png) - -## Enroll devices in Windows Analytics -Once you've added Update Compliance to a workspace in your Azure subscription, you can start enrolling the devices in your organization. For Update Compliance there are two key steps for enrollment: -1. Deploy your Commercial ID (from the Update Compliance Settings page) to your Windows 10 devices (typically by using Group Policy, [Mobile Device Management](https://docs.microsoft.com/windows/client-management/windows-10-mobile-and-mdm), [System Center Configuration Manager](https://docs.microsoft.com/sccm/core/understand/introduction) or similar). -2. Ensure the Windows Diagnostic Data setting on devices is set to at least Basic (typically using Group Policy or similar). For full enrollment instructions and troubleshooting, see [Enrolling devices in Windows Analytics](windows-analytics-get-started.md). - -After enrolling your devices (by deploying your CommercialID and Windows Diagnostic Data settings), it might take 48-72 hours for the first data to appear in the solution. Until then, Update Compliance will indicate it is still assessing devices. +--- +title: Get started with Update Compliance (Windows 10) +ms.reviewer: +manager: laurawi +description: Configure Update Compliance in Azure Portal to see the status of updates and antimalware protection on devices in your network. +keywords: update compliance, oms, operations management suite, prerequisites, requirements, updates, upgrades, antivirus, antimalware, signature, log analytics, wdav +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.pagetype: deploy +audience: itpro +author: jaimeo +ms.author: jaimeo +ms.localizationpriority: medium +ms.collection: M365-analytics +ms.topic: article +--- + +# Get started with Update Compliance +This topic explains the steps necessary to configure your environment for Update Compliance. + +Steps are provided in sections that follow the recommended setup process: + +1. Ensure you meet the [Update Compliance prerequisites](#update-compliance-prerequisites). +2. [Add Update Compliance to your Azure subscription](#add-update-compliance-to-your-azure-subscription). +3. [Enroll devices in Update Compliance](#enroll-devices-in-update-compliance). +4. [Use Update Compliance](update-compliance-using.md) to monitor Windows Updates and get Delivery Optimization insights. + +## Update Compliance prerequisites +Before you begin the process to add Update Compliance to your Azure subscription, first ensure you can meet the prerequisites: +1. Update Compliance works only with Windows 10 Professional, Education, and Enterprise editions. Update Compliance only provides data for the standard Desktop Windows 10 version and is not currently compatible with Windows Server, Surface Hub, IoT, etc. +2. Update Compliance provides detailed deployment data for devices on the Semi-Annual Channel and the Long-term Servicing Channel. Update Compliance will show Windows Insider Preview devices, but currently will not provide detailed deployment information for them. +3. Update Compliance requires at least the Basic level of diagnostic data and a Commercial ID to be enabled on the device. +4. For Windows 10 1803+, device names will not appear in Update Compliance unless you opt in. The steps to accomplish this is outlined in the [Enroll devices in Update Compliance](#enroll-devices-in-update-compliance) section. + +## Add Update Compliance to your Azure subscription +Update Compliance is offered as a solution which is linked to a new or existing [Azure Log Analytics](https://docs.microsoft.com/azure/log-analytics/query-language/get-started-analytics-portal) workspace within your Azure subscription. To configure this, follow these steps: + +1. Sign in to the [Azure Portal](https://portal.azure.com) with your work or school account or a Microsoft account. If you don't already have an Azure subscription you can create one (including free trial options) through the portal. + +> [!NOTE] +> Update Compliance is included at no additional cost with Windows 10 Professional, Education, and Enterprise editions. An Azure subscription is required for managing and using Update Compliance, but no Azure charges are expected to accrue to the subscription as a result of using Update Compliance. + +2. In the Azure portal select **+ Create a resource**, and search for “Update Compliance". You should see it in the results below. + +![Update Compliance marketplace search results](images/UC_00_marketplace_search.png) + +3. Select **Update Compliance** and a blade will appear summarizing the solution’s offerings. At the bottom, select **Create** to begin adding the solution to Azure. + +![Update Compliance solution creation](images/UC_01_marketplace_create.png) + +4. Choose an existing workspace or create a new workspace that will be assigned to the Update Compliance solution. + - [Desktop Analytics](TODO: Add Desktop Analytics reference: https://docs.microsoft.com/en-us/sccm/desktop-analytics/overview) customers are advised to use the same workspace for Update Compliance. + - If you are creating a new workspace, and your organization does not have policies governing naming conventions and structure, consider the following workspace settings to get started: + - Choose a workspace name which reflects the scope of planned usage in your organization, for example *PC-Analytics*. + - For the resource group setting select **Create new** and use the same name you chose for your new workspace. + - For the location setting, choose the Azure region where you would prefer the data to be stored. + - For the pricing tier select **per GB**. + +![Update Compliance workspace creation](images/UC_02_workspace_create.png) + +5. The resource group and workspace creation process could take a few minutes. After this, you are able to use that workspace for Update Compliance. Select **Create**. + +![Update Compliance workspace selection](images/UC_03_workspace_select.png) + +6. Watch for a notification in the Azure portal that your deployment has been successful. This might take a few minutes. Then, select **Go to resource**. + +![Update Compliance deployment successful](images/UC_04_resourcegrp_deployment_successful.png) + +## Enroll devices in Update Compliance +Once you've added Update Compliance to a workspace in your Azure subscription, you can start enrolling the devices in your organization. For Update Compliance there are three key steps to ensure successful enrollment: + +### Deploy your Commercial ID to devices +A Commercial ID is a globally-unique identifier assigned to a specific Log Analytics workspace. This is used to identify devices as part of your environment. + +To find your Commercial ID within Azure: +1. Navigate to the **Solutions** tab for your workspace, and then select the **WaaSUpdateInsights** solution. +2. From there, select the Update Compliance Settings page on the navbar. +3. Your Commercial ID is available in the settings page. + +![Update Compliance Settings page](images/UC_commercialID.png) + +>**Important** +> +>Regenerate your Commercial ID only if your Original ID key can no longer be used or if you want to completely reset your workspace. Regenerating your Commercial ID cannot be undone and will result in you losing data for all devices that have the current Commercial ID until the new Commercial ID is deployed to devices. + +#### Deploying Commercial ID using Group Policy +Commercial ID can be deployed using Group Policy. The Group Policy for Commercial ID is under **Computer Configuration\Administrative Templates\Windows Components\Data Collection and Preview Builds\Configure the Commercial ID**. + +![Commercial ID Group Policy location](images/UC_commercialID_GP.png) + +#### Deploying Commercial ID using MDM +Commercial ID can be deployed through a [Mobile Device Management](https://docs.microsoft.com/en-us/windows/client-management/mdm/) (MDM) policy beginning with Windows 10, version 1607. Commercial ID is under the [DMClient configuration service provider](https://docs.microsoft.com/en-us/windows/client-management/mdm/dmclient-csp). + +### Ensure endpoints are whitelisted +To enable data sharing between devices, your network, and Microsoft's Diagnostic Data Service, configure your proxy to whitelist the following endpoints. You may need security group approval to do this. + +| **Endpoint** | **Function** | +|---------------------------------------------------------|-----------| +| `https://v10c.events.data.microsoft.com` | Connected User Experience and Diagnostic component endpoint for Windows 10, version 1803 and later. | +| `https://v10.vortex-win.data.microsoft.com` | Connected User Experience and Diagnostic component endpoint for Windows 10, version 1709 or earlier. | +| `https://settings-win.data.microsoft.com` | Enables the compatibility update to send data to Microsoft. | +| `http://adl.windows.com` | Allows the compatibility update to receive the latest compatibility data from Microsoft. | +| `https://watson.telemetry.microsoft.com` | Windows Error Reporting (WER), used to provide more advanced error reporting in the event of certain Feature Update deployment failures. | +| `https://oca.telemetry.microsoft.com` | Online Crash Analysis, used to provide device-specific recommendations and detailed errors in the event of certain crashes. | +| `https://login.live.com` | This endpoint is optional but allows for the Update Compliance service to more reliably identify and process devices. If you want to disable end-user managed service account (MSA) access, you should apply the appropriate [policy](https://docs.microsoft.com/windows/security/identity-protection/access-control/microsoft-accounts#block-all-consumer-microsoft-account-user-authentication) instead of blocking this endpoint. | + +### Set diagnostic data levels +Update Compliance requries that devices are configured to send Microsoft at least the Basic level of diagnostic data in order to function. For more information on Windows diagnostic data, see [Configure Windows diagnostic data in your organization](https://docs.microsoft.com/en-us/windows/privacy/configure-windows-diagnostic-data-in-your-organization). + +#### Configuring Telemetry level using Group Policy +You can set Allow Telemetry through Group Policy, this setting is in the same place as the Commercial ID policy, under **Computer Configuration\Administrative Templates\Windows Components\Data Collection and Preview Builds\Allow Telemetry**. Update Compliance requires at least Basic (level 1) to function. + +![Allow Telemetry in Group Policy](images/UC_telemetrylevel.png) + +#### Configuring Telemetry level using MDM +Telemetry level can additionally be configured through a [Mobile Device Management](https://docs.microsoft.com/en-us/windows/client-management/mdm/) (MDM) policy. Allow Telemetry is under the [Policy Configuration Service Provider](https://docs.microsoft.com/en-us/windows/client-management/mdm/policy-configuration-service-provider) as [System/AllowTelemetry](https://docs.microsoft.com/en-us/windows/client-management/mdm/policy-csp-system#system-allowtelemetry). + +### Enabling Device Name in telemetry +Beginning with Windows 10, version 1803, Device Name is no longer collected as part of normal Windows Diagnostic Data and must explicitly be allowed to be sent to Microsoft. If devices do not have this policy enabled, their device name will appear as '#' instead. + +#### Allow Device Name in Telemetry with Group Policy +Allow Device Name in Telemetry is under the same node as Commercial ID and Allow Telemetry policies in Group Policy, listed as **Allow device name to be sent in Windows diagnostic data**. + +#### Allow Device Name in Telemetry with MDM +Allow Device Name in Telemetry is under the [Policy Configuration Service Provider](https://docs.microsoft.com/en-us/windows/client-management/mdm/policy-configuration-service-provider) as [System/AllowTelemetry](https://docs.microsoft.com/en-us/windows/client-management/mdm/policy-csp-system#system-allowtelemetry). + +>[!NOTE] +>After enrolling your devices (by deploying your CommercialID and Windows Diagnostic Data settings), it might take 48-72 hours for the first data to appear in the solution. Until then, Update Compliance will indicate it is still assessing devices. \ No newline at end of file diff --git a/windows/deployment/update/update-compliance-monitor.md b/windows/deployment/update/update-compliance-monitor.md index 1ece514b2e..46ef650f22 100644 --- a/windows/deployment/update/update-compliance-monitor.md +++ b/windows/deployment/update/update-compliance-monitor.md @@ -1,57 +1,60 @@ ---- -title: Monitor Windows Updates and Windows Defender AV with Update Compliance (Windows 10) -ms.reviewer: -manager: laurawi -description: You can use Update Compliance in Azure Portal to monitor the progress of updates and key antimalware protection features on devices in your network. -keywords: oms, operations management suite, wdav, updates, upgrades, antivirus, antimalware, signature, log analytics -ms.prod: w10 -ms.mktglfcycl: deploy -ms.sitesec: library -ms.pagetype: deploy -audience: itpro author: greg-lindsay -ms.author: greglin -ms.localizationpriority: medium -ms.collection: M365-analytics -ms.topic: article ---- - -# Monitor Windows Updates with Update Compliance - -## Introduction - -Update Compliance is a [Windows Analytics solution](windows-analytics-overview.md) that enables organizations to: - -* Monitor Windows 10 Professional, Education, and Enterprise security, quality, and feature updates. -* View a report of device and update issues related to compliance that need attention. -* See the status of Windows Defender Antivirus signatures and threats. -* Check bandwidth savings incurred across multiple content types by using [Delivery Optimization](waas-delivery-optimization.md). - -Update Compliance is offered through the Azure portal, and is available free for devices that meet the [prerequisites](update-compliance-get-started.md#update-compliance-prerequisites). - -Update Compliance uses Windows 10 and Windows Defender Antivirus diagnostic data for all of its reporting. It collects system data including update deployment progress, [Windows Update for Business](waas-manage-updates-wufb.md) configuration data, Windows Defender Antivirus data, and Delivery Optimization usage data, and then sends this data to a secure cloud to be stored for analysis and usage in [Azure Log Analytics](https://docs.microsoft.com/azure/log-analytics/query-language/get-started-analytics-portal). - -See the following topics in this guide for detailed information about configuring and using the Update Compliance solution: - -- [Get started with Update Compliance](update-compliance-get-started.md): How to add Update Compliance to your environment. -- [Using Update Compliance](update-compliance-using.md): How to begin using Update Compliance. - -## Update Compliance architecture - -The Update Compliance architecture and data flow is summarized by the following four-step process: - -1. User computers send diagnostic data to a secure Microsoft data center using the Microsoft Data Management Service.
-2. Diagnostic data is analyzed by the Update Compliance Data Service.
-3. Diagnostic data is pushed from the Update Compliance Data Service to your Azure Monitor workspace.
-4. Diagnostic data is available in the Update Compliance solution.
- - ->[!NOTE] ->This process assumes that Windows diagnostic data is enabled and data sharing is enabled as described in [Enrolling devices in Windows Analytics](windows-analytics-get-started.md). - - - -  -## Related topics - -[Get started with Update Compliance](update-compliance-get-started.md)
-[Use Update Compliance to monitor Windows Updates](update-compliance-using.md) +--- +title: Monitor Windows Updates and Windows Defender AV with Update Compliance (Windows 10) +ms.reviewer: +manager: laurawi +description: You can use Update Compliance in Azure Portal to monitor the progress of updates and key antimalware protection features on devices in your network. +keywords: oms, operations management suite, wdav, updates, upgrades, antivirus, antimalware, signature, log analytics +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.pagetype: deploy +audience: itpro +author: jaimeo +ms.author: jaimeo +ms.localizationpriority: medium +ms.collection: M365-analytics +ms.topic: article +--- + +# Monitor Windows Updates with Update Compliance + +>[!IMPORTANT] +>Update Compliance is moving out of Windows Analytics. Windows Analytics is being retired, but Update Compliance will continue to be supported. For more information, see the [Update Compliance FAQ](windows-analytics-get-started.md). + +## Introduction + +Update Compliance is a [Windows Analytics solution](windows-analytics-overview.md) that enables organizations to: + +* Monitor security, quality, and feature updates for Windows 10 Professional, Education, and Enterprise editions. +* View a report of device and update issues related to compliance that need attention. +* Check bandwidth savings incurred across multiple content types by using [Delivery Optimization](waas-delivery-optimization.md). + +Update Compliance is offered through the Azure portal, and is included as part of Windows 10 licenses listed in the [prerequisites](update-compliance-get-started.md#update-compliance-prerequisites). + +Update Compliance uses Windows 10 and Windows Defender Antivirus diagnostic data for all of its reporting. It collects system data including update deployment progress, [Windows Update for Business](waas-manage-updates-wufb.md) configuration data, Windows Defender Antivirus data, and Delivery Optimization usage data, and then sends this data to a secure cloud to be stored for analysis and usage in [Azure Log Analytics](https://docs.microsoft.com/azure/log-analytics/query-language/get-started-analytics-portal). + +See the following topics in this guide for detailed information about configuring and using the Update Compliance solution: + +- [Get started with Update Compliance](update-compliance-get-started.md): How to add Update Compliance to your environment. +- [Using Update Compliance](update-compliance-using.md): How to begin using Update Compliance. + +## Update Compliance architecture + +The Update Compliance architecture and data flow follows this process: + +1. User computers send diagnostic data to a secure Microsoft data center using the Microsoft Data Management Service. +2. Diagnostic data is analyzed by the Update Compliance Data Service. +3. Diagnostic data is pushed from the Update Compliance Data Service to your Azure Monitor workspace. +4. Diagnostic data is available in the Update Compliance solution. + + +>[!NOTE] +>This process assumes that Windows diagnostic data is enabled and data sharing is enabled as outlined in the enrollment section of [Get started with Update Compliance](update-compliance-get-started.md). + + + +  +## Related topics + +[Get started with Update Compliance](update-compliance-get-started.md)
+[Use Update Compliance to monitor Windows Updates](update-compliance-using.md) \ No newline at end of file diff --git a/windows/deployment/update/update-compliance-using.md b/windows/deployment/update/update-compliance-using.md index 501c1bcb57..4234827db4 100644 --- a/windows/deployment/update/update-compliance-using.md +++ b/windows/deployment/update/update-compliance-using.md @@ -1,94 +1,94 @@ ---- -title: Using Update Compliance (Windows 10) -ms.reviewer: -manager: laurawi -description: Explains how to begin usihg Update Compliance. -keywords: oms, operations management suite, wdav, updates, upgrades, antivirus, antimalware, signature, log analytics -ms.prod: w10 -ms.mktglfcycl: deploy -ms.sitesec: library -ms.pagetype: deploy -audience: itpro author: greg-lindsay -ms.author: greglin -ms.localizationpriority: medium -ms.collection: M365-analytics -ms.topic: article ---- - -# Use Update Compliance - -In this section you'll learn how to use Update Compliance to monitor your device's Windows updates and Windows Defender Antivirus status. To configure your environment for use with Update Compliance, refer to [Get started with Update Compliance](update-compliance-get-started.md). - - -Update Compliance: -- Provides detailed deployment data for Windows 10 security, quality, and feature updates. -- Reports when devices have issues related to updates that need attention. -- Shows Windows Defender AV status information for devices that use it and meet the [prerequisites](update-compliance-get-started.md#update-compliance-prerequisites). -- Shows bandwidth usage and savings for devices that are configured to use [Delivery Optimization](waas-delivery-optimization.md). -- Provides all of the above data in [Log Analytics](#using-log-analytics), which affords additional querying and export capabilities. - -## The Update Compliance tile -After Update Compliance has successfully been [added to your Azure subscription](update-compliance-get-started.md#add-update-compliance-to-your-azure-subscription), you’ll see this tile: - -![Update Compliance tile no data](images/UC_tile_assessing.png) - -When the solution is added, data is not immediately available. Data will begin to be collected after data is sent up that belongs to the Commercial ID associated with the device. This process assumes that Windows diagnostic data is enabled and data sharing is enabled as described in [Enrolling devices in Windows Analytics](windows-analytics-get-started.md). After Microsoft has collected and processed any device data associated with your Commercial ID, the tile will be replaced with the following summary: - -![Update Compliance tile with data](images/UC_tile_filled.png) - -The summary details the total number of devices that Microsoft has received data from with your Commercial ID. It also provides the number of devices that need attention if any. Finally, it details the last point at which your Update Compliance workspace was refreshed. - -## The Update Compliance workspace - -![Update Compliance workspace view](images/UC_workspace_needs_attention.png) - -When you select this tile, you will be redirected to the Update Compliance workspace. The workspace is organized with the Overview blade providing a hub from which to navigate to different reports of your devices' data. - -### Overview blade - -![The Overview blade](images/UC_workspace_overview_blade.png) - -Update Compliance’s overview blade summarizes all the data Update Compliance provides. It functions as a hub from which you can navigate to different sections. The total number of devices detected by Update Compliance is reported in the title of this blade. What follows is a distribution for all devices as to whether they are up to date on the following items: -* Security updates: A device is up to date on quality updates whenever it has the latest applicable quality update installed. Quality updates are monthly cumulative updates that are specific to a version of Windows 10. -* Feature updates: A device is up to date on feature updates whenever it has the latest applicable feature update installed. Update Compliance considers [Servicing Channel](waas-overview.md#servicing-channels) when determining update applicability. -* AV Signature: A device is up to date on Antivirus Signature when the latest Windows Defender Signatures have been downloaded. This distribution only considers devices that are running Windows Defender Antivirus. - -The blade also provides the time at which your Update Compliance workspace was [refreshed](#update-compliance-data-latency). - -The following is a breakdown of the different sections available in Update Compliance: -* [Need Attention!](update-compliance-need-attention.md) - This section is the default section when arriving to your Update Compliance workspace. It provides a summary of the different issues devices are facing relative to Windows 10 updates. -* [Security Update Status](update-compliance-security-update-status.md) - This section lists the percentage of devices that are on the latest security update released for the version of Windows 10 it is running. Selecting this section provides blades that summarize the overall status of security updates across all devices and a summary of their deployment progress towards the latest two security updates. -* [Feature Update Status](update-compliance-feature-update-status.md) - This section lists the percentage of devices that are on the latest feature update that is applicable to a given device. Selecting this section provides blades that summarize the overall feature update status across all devices and a summary of deployment status for different versions of Windows 10 in your environment. -* [Windows Defender AV Status](update-compliance-wd-av-status.md) - This section lists the percentage of devices running Windows Defender Antivirus that are not sufficiently protected. Selecting this section provides a summary of signature and threat status across all devices that are running Windows Defender Antivirus. This section is not applicable to devices not running Windows Defender Antivirus or devices that do not meet the [prerequisites](update-compliance-get-started.md#update-compliance-prerequisites) to be assessed. -* [Delivery Optimization Status](update-compliance-delivery-optimization.md) - This section summarizes bandwidth savings incurred by utilizing Delivery Optimization in your environment. It provides a breakdown of Delivery Optimization configuration across devices, and summarizes bandwidth savings and utilization across multiple content types. - - -## Update Compliance data latency -Update Compliance uses Windows 10 diagnostic data as its data source. After you add Update Compliance and appropriately configure your devices, it could take 48-72 hours before they first appear. The process that follows is as follows: - -Update Compliance is refreshed every 12 hours. This means that every 12 hours all data that has been gathered over the last 12-hour interval is pushed to Log Analytics. However, the rate that each data type is sent and how long it takes to be ready for Update Compliance varies, roughly outlined below. - -| Data Type | Refresh Rate | Data Latency | -|--|--|--| -|WaaSUpdateStatus | Once per day |4 hours | -|WaaSInsiderStatus| Once per day |4 hours | -|WaaSDeploymentStatus|Every update event (Download, install, etc.)|24-36 hours | -|WDAVStatus|On signature update|24 hours | -|WDAVThreat|On threat detection|24 hours | -|WUDOAggregatedStatus|On update event, aggregated over time|24-36 hours | -|WUDOStatus|Once per day|12 hours | - -This means you should generally expect to see new data every 24-36 hours, except for WaaSDeploymentStatus and WUDOAggregatedStatus, which may take 36-48 hours (if it misses the 36th hour refresh, it would be in the 48th, so the data will be present in the 48th hour refresh). - -## Using Log Analytics - -Update Compliance is built on the Log Analytics platform that is integrated into Operations Management Suite. All data in the workspace is the direct result of a query. Understanding the tools and features at your disposal, all integrated within Azure Portal, can deeply enhance your experience and complement Update Compliance. - -See below for a few topics related to Log Analytics: -* Learn how to effectively execute custom Log Searches by referring to Microsoft Azure’s excellent documentation on [querying data in Log Analytics](https://docs.microsoft.com/azure/log-analytics/log-analytics-log-searches). -* To develop your own custom data views in Operations Management Suite or [Power BI](https://powerbi.microsoft.com/); check out documentation on [analyzing data for use in Log Analytics](https://docs.microsoft.com/azure/log-analytics/log-analytics-dashboards). -* [Gain an overview of Log Analytics’ alerts](https://docs.microsoft.com/azure/log-analytics/log-analytics-alerts) and learn how to use it to always stay informed about the most critical issues you care about. - -## Related topics - -[Get started with Update Compliance](update-compliance-get-started.md) +--- +title: Using Update Compliance (Windows 10) +ms.reviewer: +manager: laurawi +description: Explains how to begin usihg Update Compliance. +keywords: oms, operations management suite, wdav, updates, upgrades, antivirus, antimalware, signature, log analytics +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.pagetype: deploy +audience: itpro +author: jaimeo +ms.author: jaimeo +ms.localizationpriority: medium +ms.collection: M365-analytics +ms.topic: article +--- + +# Use Update Compliance + +In this section you'll learn how to use Update Compliance to monitor your device's Windows updates and Windows Defender Antivirus status. To configure your environment for use with Update Compliance, refer to [Get started with Update Compliance](update-compliance-get-started.md). + + +Update Compliance: +- Provides detailed deployment data for Windows 10 security, quality, and feature updates. +- Reports when devices have issues related to updates that need attention. +- Shows Windows Defender AV status information for devices that use it and meet the [prerequisites](update-compliance-get-started.md#update-compliance-prerequisites). +- Shows bandwidth usage and savings for devices that are configured to use [Delivery Optimization](waas-delivery-optimization.md). +- Provides all of the above data in [Log Analytics](#using-log-analytics), which affords additional querying and export capabilities. + +## The Update Compliance tile +After Update Compliance has successfully been [added to your Azure subscription](update-compliance-get-started.md#add-update-compliance-to-your-azure-subscription), you’ll see this tile: + +![Update Compliance tile no data](images/UC_tile_assessing.png) + +When the solution is added, data is not immediately available. Data will begin to be collected after data is sent up that belongs to the Commercial ID associated with the device. This process assumes that Windows diagnostic data is enabled and data sharing is enabled as described in [Enrolling devices in Update Compliance](update-compliance-get-started.md#enroll-devices-in-update-compliance). After Microsoft has collected and processed any device data associated with your Commercial ID, the tile will be replaced with the following summary: + +![Update Compliance tile with data](images/UC_tile_filled.png) + +The summary details the total number of devices that Microsoft has received data from with your Commercial ID. It also provides the number of devices that need attention if any. Finally, it details the last point at which your Update Compliance workspace was refreshed. + +## The Update Compliance workspace + +![Update Compliance workspace view](images/UC_workspace_needs_attention.png) + +When you select this tile, you will be redirected to the Update Compliance workspace. The workspace is organized with the Overview blade providing a hub from which to navigate to different reports of your devices' data. + +### Overview blade + +![The Overview blade](images/UC_workspace_overview_blade.png) + +Update Compliance’s overview blade summarizes all the data Update Compliance provides. It functions as a hub from which you can navigate to different sections. The total number of devices detected by Update Compliance is reported in the title of this blade. What follows is a distribution for all devices as to whether they are up to date on the following items: +* Security updates: A device is up to date on quality updates whenever it has the latest applicable quality update installed. Quality updates are monthly cumulative updates that are specific to a version of Windows 10. +* Feature updates: A device is up to date on feature updates whenever it has the latest applicable feature update installed. Update Compliance considers [Servicing Channel](waas-overview.md#servicing-channels) when determining update applicability. +* AV Signature: A device is up to date on Antivirus Signature when the latest Windows Defender Signatures have been downloaded. This distribution only considers devices that are running Windows Defender Antivirus. + +The blade also provides the time at which your Update Compliance workspace was [refreshed](#update-compliance-data-latency). + +The following is a breakdown of the different sections available in Update Compliance: +* [Need Attention!](update-compliance-need-attention.md) - This section is the default section when arriving to your Update Compliance workspace. It provides a summary of the different issues devices are facing relative to Windows 10 updates. +* [Security Update Status](update-compliance-security-update-status.md) - This section lists the percentage of devices that are on the latest security update released for the version of Windows 10 it is running. Selecting this section provides blades that summarize the overall status of security updates across all devices and a summary of their deployment progress towards the latest two security updates. +* [Feature Update Status](update-compliance-feature-update-status.md) - This section lists the percentage of devices that are on the latest feature update that is applicable to a given device. Selecting this section provides blades that summarize the overall feature update status across all devices and a summary of deployment status for different versions of Windows 10 in your environment. +* [Delivery Optimization Status](update-compliance-delivery-optimization.md) - This section summarizes bandwidth savings incurred by utilizing Delivery Optimization in your environment. It provides a breakdown of Delivery Optimization configuration across devices, and summarizes bandwidth savings and utilization across multiple content types. + + +## Update Compliance data latency +Update Compliance uses Windows 10 diagnostic data as its data source. After you add Update Compliance and appropriately configure your devices, it could take 48-72 hours before they first appear. The process that follows is as follows: + +Update Compliance is refreshed every 12 hours. This means that every 12 hours all data that has been gathered over the last 12-hour interval is pushed to Log Analytics. However, the rate at which each type of data is sent from the device and how long it takes to be ready for Update Compliance varies, roughly outlined below. + +| Data Type | Data upload rate from device | Data Latency | +|--|--|--| +|WaaSUpdateStatus | Once per day |4 hours | +|WaaSInsiderStatus| Once per day |4 hours | +|WaaSDeploymentStatus|Every update event (Download, install, etc.)|24-36 hours | +|WDAVStatus|On signature update|24 hours | +|WDAVThreat|On threat detection|24 hours | +|WUDOAggregatedStatus|On update event, aggregated over time|24-36 hours | +|WUDOStatus|Once per day|12 hours | + +This means you should generally expect to see new data device data every 24 hours, except for WaaSDeploymentStatus and WUDOAggregatedStatus, which may take 36-48 hours (if it misses the 36th hour refresh, it would be in the 48th, so the data will be present in the 48th hour refresh). + +## Using Log Analytics + +Update Compliance is built on the Log Analytics platform that is integrated into Operations Management Suite. All data in the workspace is the direct result of a query. Understanding the tools and features at your disposal, all integrated within Azure Portal, can deeply enhance your experience and complement Update Compliance. + +See below for a few topics related to Log Analytics: +* Learn how to effectively execute custom Log Searches by referring to Microsoft Azure’s excellent documentation on [querying data in Log Analytics](https://docs.microsoft.com/azure/log-analytics/log-analytics-log-searches). +* To develop your own custom data views in Operations Management Suite or [Power BI](https://powerbi.microsoft.com/); check out documentation on [analyzing data for use in Log Analytics](https://docs.microsoft.com/azure/log-analytics/log-analytics-dashboards). +* [Gain an overview of Log Analytics’ alerts](https://docs.microsoft.com/azure/log-analytics/log-analytics-alerts) and learn how to use it to always stay informed about the most critical issues you care about. + +## Related topics + +[Get started with Update Compliance](update-compliance-get-started.md) \ No newline at end of file From 71f7c7867a7acee6e5686011ab84990b9125883b Mon Sep 17 00:00:00 2001 From: jaimeo Date: Mon, 7 Oct 2019 12:07:02 -0700 Subject: [PATCH 02/11] fixed a crosslink issue --- ...update-compliance-delivery-optimization.md | 2 +- .../waas-delivery-optimization-setup.md | 381 +++++++++--------- 2 files changed, 192 insertions(+), 191 deletions(-) diff --git a/windows/deployment/update/update-compliance-delivery-optimization.md b/windows/deployment/update/update-compliance-delivery-optimization.md index 0f64c2b157..ef10467607 100644 --- a/windows/deployment/update/update-compliance-delivery-optimization.md +++ b/windows/deployment/update/update-compliance-delivery-optimization.md @@ -30,7 +30,7 @@ The Delivery Optimization Status section includes three blades: ## Device Configuration blade -Devices can be set to use different download modes; these download modes determine in what situations Delivery Optimization will use peer-to-peer distribution to accomplish the downloads. The top section shows the number of devices configured to use peer-to-peer distribution in *Peering On* compared to *Peering Off* modes. The table shows a breakdown of the various download mode configurations seen in your environment. For more information about the different configuration options, see [Configure Delivery Optimization for Windows 10 updates](waas-delivery-optimization.md#download-mode). +Devices can be set to use different download modes; these download modes determine in what situations Delivery Optimization will use peer-to-peer distribution to accomplish the downloads. The top section shows the number of devices configured to use peer-to-peer distribution in *Peering On* compared to *Peering Off* modes. The table shows a breakdown of the various download mode configurations seen in your environment. For more information about the different configuration options, see [Configure Delivery Optimization for Windows 10 updates](waas-delivery-optimization-setup.md). ## Content Distribution (%) blade The first of two blades showing information on content breakdown, this blade shows a ring chart summarizing **Bandwidth Savings %**, which is the percentage of data received from peer sources out of the total data downloaded (for any device that used peer-to-peer distribution). diff --git a/windows/deployment/update/waas-delivery-optimization-setup.md b/windows/deployment/update/waas-delivery-optimization-setup.md index f21112405f..de20e4993f 100644 --- a/windows/deployment/update/waas-delivery-optimization-setup.md +++ b/windows/deployment/update/waas-delivery-optimization-setup.md @@ -1,190 +1,191 @@ ---- -title: Set up Delivery Optimization -ms.reviewer: -manager: laurawi -description: Delivery Optimization is a new peer-to-peer distribution method in Windows 10 -keywords: oms, operations management suite, wdav, updates, downloads, log analytics -ms.prod: w10 -ms.mktglfcycl: deploy -ms.sitesec: library -audience: itpro author: greg-lindsay -ms.localizationpriority: medium -ms.author: greglin -ms.collection: M365-modern-desktop -ms.topic: article ---- - -# Set up Delivery Optimization for Windows 10 updates - -**Applies to** - -- Windows 10 - -> **Looking for consumer information?** See [Windows Update: FAQ](https://support.microsoft.com/help/12373/windows-update-faq) - -## Recommended Delivery Optimization settings - -Delivery Optimization offers a great many settings to fine-tune its behavior (see [Delivery Optimization reference](waas-delivery-optimization-reference.md) for a comprehensive list), but for the most efficient performance, there are just a few key parameters that will have the greates impact if particular situations exist in your deployment: - -- Does your topology include multiple breakouts to the internet (i.e., a "hybrid WAN") or are there only a few connections to the internet, so that all requests appear to come from a single external IP address (a "hub and spoke" topology)? -- If you use boundary groups in your topology, how many devices are present in a given group? -- What percentage of your devices are mobile? -- Do your devices have a lot of free space on their drives? -- Do you have a lab scenario with many devices on AC power? - ->[!NOTE] ->These scenarios (and the recommended settings for each) are not mutually exclusive. It's possible that your deployment might involve more than one of these scenarios, in which case you can employ the related settings in any combination as needed. In all cases, however, "download mode" is the most important one to set. - -Quick-reference table: - -| Use case | Policy | Recommended value | Reason | -| --- | --- | --- | --- | -| Hub & spoke topology | Download mode | 1 or 2 | Automatic grouping of peers to match your topology | -| Sites with > 30 devices | Minimum file size to cache | 10 MB (or 1 MB) | Leverage peers-to-peer capability in more downloads | -| Large number of mobile devices | Allow uploads on battery power | 60% | Increase # of devices that can upload while limiting battery drain | -| Labs with AC-powered devices | Content Expiration | 7 (up to 30) days | Leverage devices that can upload more for a longer period | - - -### Hybrid WAN scenario - -For this scenario, grouping devices by domain allows devices to be included in peer downloads and uploads across VLANs. **Set Download Mode to 2 - Group**. The default group is the authenticated domain or Active Directory site. If your domain-based group is too wide, or your Active Directory sites aren’t aligned with your site network topology, then you should consider additional options for dynamically creating groups, for example by using the GroupIDSrc parameter. - - - - -To do this in Group Policy go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Download mode** to **2**. - -To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set DODownloadMode to 1 or 2. - -### Hub and spoke topology with boundary groups - -The default download mode setting is **1**; this means all devices breaking out to the internet using the same public IP will be considered as a single peer group. To prevent peer-to-peer activity across groups, you should set the download mode to **2**. If you have already defined Active Directory sites per hub or branch office, then you don't need to do anything else. If you're not using Active Directory sites, you should set *RestrictPeerSelectionBy* policies to restrict the activity to the subnet or set a different source for Groups by using the GroupIDSrc parameter. See [Select a method to restrict peer selection](waas-delivery-optimization-reference.md#select-a-method-to-restrict-peer-selection). - - - -To do this in Group Policy go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Download mode** to **2**. - -To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set **DODownloadMode** to **2**. - - -### Large number of mobile devices - -If you have a mobile workforce with a great many mobile devices, set Delivery Optimization to allow uploads on battery power, while limiting the use to prevent battery drain. A setting for **DOMinBatteryPercentageAllowedToUpload** of 60% is a good starting point, though you might want to adjust it later. - -To do this in Group Policy, go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Allow uploads while the device is on battery while under set Battery level** to 60. - -To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set **DOMinBatteryPercentageAllowedToUpload** to 60. - -### Plentiful free space and large numbers of devices - -Many devices now come with large internal drives. You can set Delivery Optimization to take better advantage of this space (especially if you have large numbers of devices) by changing the minimum file size to cache. If you have more than 30 devices in your local network or group, change it from the default 50 MB to 10 MB. If you have more than 100 devices (and are running Windows 10, version 1803 or later), set this value to 1 MB. - -[//]: # (default of 50 aimed at consumer) - -To do this in Group Policy, go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Minimum Peer Caching Content File Size** to 100 (if you have more than 30 devices) or 1 (if you have more than 100 devices). - -To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set **DOMinFileSizeToCache** to 100 (if you have more than 30 devices) or 1 (if you have more than 100 devices). - -### Lab scenario - -In a lab situation, you typically have a large number of devices that are plugged in and have a lot of free disk space. By increasing the content expiration interval, you can take advantage of these devices, using them as excellent upload sources in order to upload much more content over a longer period. - -To do this in Group Policy, go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Max Cache Age** to **6048000** (7 days) or more (up to 30 days). - -To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set DOMaxCacheAge to 7 or more (up to 30 days). - -[//]: # (material about "preferred" devices; remove MinQos/MaxCacheAge; table format?) - - -## Monitor Delivery Optimization -[//]: # (How to tell if it’s working? What values are reasonable; which are not? If not, which way to adjust and how? -- check PercentPeerCaching for files > minimum >= 50%) - -### Windows PowerShell cmdlets - -**Starting in Windows 10, version 1703**, you can use new PowerShell cmdlets to check the performance of Delivery Optimization. - -#### Analyze usage - -`Get-DeliveryOptimizationStatus` returns a real-time snapshot of all current Delivery Optimization jobs. - -| Key | Value | -| --- | --- | -| File ID | A GUID that identifies the file being processed | -| Priority | Priority of the download; values are **foreground** or **background** | -| FileSize | Size of the file | -| TotalBytesDownloaded | The number of bytes from any source downloaded so far | -| PercentPeerCaching |The percentage of bytes downloaded from peers versus over HTTP | -| BytesFromPeers | Total bytes downloaded from peer devices (sum of bytes downloaded from LAN, Group, and Internet Peers) | -| BytesfromHTTP | Total number of bytes received over HTTP | -| DownloadDuration | Total download time in seconds | -| Status | Current state of the operation. Possible values are: **Downloading** (download in progress); **Complete** (download completed, but is not uploading yet); **Caching** (download completed successfully and is ready to upload or uploading); **Paused** (download/upload paused by caller) | -| NumPeers | Indicates the total number of peers returned from the service. | -| PredefinedCallerApplication | Indicates the last caller that initiated a request for the file. | -| ExpireOn | The target expiration date and time for the file. | -| Pinned | A yes/no value indicating whether an item has been "pinned" in the cache (see `setDeliveryOptmizationStatus`). | - -`Get-DeliveryOptimizationPerfSnap` returns a list of key performance data: - -- Number of files downloaded  -- Number of files uploaded  -- Total bytes downloaded  -- Total bytes uploaded  -- Average transfer size (download); that is, the number bytes downloaded divided by the number of files  -- Average transfer size (upload); the number of bytes uploaded divided by the number of files -- Peer efficiency; same as PercentPeerCaching - -Using the `-Verbose` option returns additional information: - -- Bytes from peers (per type)  -- Bytes from CDN (the number of bytes received over HTTP) -- Average number of peer connections per download  - -Starting in Window 10, version 1903, `get-DeliveryOptimizationPerfSnap` has a new option `-CacheSummary` which provides a summary of the cache status. - -Starting in Windows 10, version 1803, `Get-DeliveryOptimizationPerfSnapThisMonth` returns data similar to that from `Get-DeliveryOptimizationPerfSnap` but limited to the current calendar month. - -#### Manage the Delivery Optimization cache - -**Starting in Windows 10, version 1903:** - -`set-DeliveryOptimizationStatus -ExpireOn [date time]` extends the expiration of all files in the cache. You can set the expiration immediately for all files that are in the "caching" state. For files in progress ("downloading"), the expiration is applied once the download is complete. You can set the expiration up to one year from the current date and time. - -`set-DeliveryOptimizationStatus -ExpireOn [date time] -FileID [FileID]` extends expiration for a single specific file in the cache. - -You can now "pin" files to keep them persistent in the cache. You can only do this with files that are downloaded in modes 1, 2, or 3. - -`set-DeliveryOptimizationStatus -Pin [True] -File ID [FileID]` keeps a specific file in the cache such that it won't be deleted until the expiration date and time (which you set with `set-DeliveryOptimizationStatus -ExpireOn [date time] -FileID [FileID]`). The file is also excluded from the cache quota calculation. - -`set-DeliveryOptimizationStatus -Pin [False] -File ID [FileID]` "unpins" a file, so that it will be deleted when the expiration date and time are rreached. The file is included in the cache quota calculation. - -`delete-DeliveryOptimizationCache` lets you clear files from the cache and remove all persisted data related to them. You can use these options with this cmdlet: - -- `-FileID` specifies a particular file to delete. -- `-IncludePinnedFiles` deletes all files that are pinned. -- `-Force` deletes the cache with no prompts. - - -#### Work with Delivery Optimization logs - -**Starting in Windows 10, version 1803:** - -`Get-DeliveryOptimizationLog [-Path ] [-Flush]` - -If `Path` is not specified, this cmdlet reads all logs from the dosvc log directory, which requires administrator permissions. If `Flush` is specified, the cmdlet stops dosvc before reading logs. - -Log entries are written to the PowerShell pipeline as objects. To dump logs to a text file, run `Get-DeliveryOptimizationLog | Set-Content ` or something similar. - -[//]: # (section on what to look for in logs, list of peers, connection failures) - - - -[//]: # (possibly move to Troubleshooting) - -### Monitor with Update Compliance - -The Update Compliance solution of Windows Analytics provides you with information about your Delivery Optimization configuration, including the observed bandwidth savings across all devices that used peer-to-peer distribution over the past 28 days. - -![DO status](images/UC_workspace_DO_status.png) - -For details, see [Delivery Optimization in Update Compliance](update-compliance-delivery-optimization.md). - +--- +title: Set up Delivery Optimization +ms.reviewer: +manager: laurawi +description: Delivery Optimization is a new peer-to-peer distribution method in Windows 10 +keywords: oms, operations management suite, wdav, updates, downloads, log analytics +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +audience: itpro +author: jaimeo +ms.localizationpriority: medium +ms.author: jaimeo +ms.collection: M365-modern-desktop +ms.topic: article +--- + +# Set up Delivery Optimization for Windows 10 updates + +**Applies to** + +- Windows 10 + +> **Looking for consumer information?** See [Windows Update: FAQ](https://support.microsoft.com/help/12373/windows-update-faq) + +## Recommended Delivery Optimization settings + +Delivery Optimization offers a great many settings to fine-tune its behavior (see [Delivery Optimization reference](waas-delivery-optimization-reference.md) for a comprehensive list), but for the most efficient performance, there are just a few key parameters that will have the greates impact if particular situations exist in your deployment: + +- Does your topology include multiple breakouts to the internet (i.e., a "hybrid WAN") or are there only a few connections to the internet, so that all requests appear to come from a single external IP address (a "hub and spoke" topology)? +- If you use boundary groups in your topology, how many devices are present in a given group? +- What percentage of your devices are mobile? +- Do your devices have a lot of free space on their drives? +- Do you have a lab scenario with many devices on AC power? + +>[!NOTE] +>These scenarios (and the recommended settings for each) are not mutually exclusive. It's possible that your deployment might involve more than one of these scenarios, in which case you can employ the related settings in any combination as needed. In all cases, however, "download mode" is the most important one to set. + +Quick-reference table: + +| Use case | Policy | Recommended value | Reason | +| --- | --- | --- | --- | +| Hub & spoke topology | Download mode | 1 or 2 | Automatic grouping of peers to match your topology | +| Sites with > 30 devices | Minimum file size to cache | 10 MB (or 1 MB) | Leverage peers-to-peer capability in more downloads | +| Large number of mobile devices | Allow uploads on battery power | 60% | Increase # of devices that can upload while limiting battery drain | +| Labs with AC-powered devices | Content Expiration | 7 (up to 30) days | Leverage devices that can upload more for a longer period | + + +### Hybrid WAN scenario + +For this scenario, grouping devices by domain allows devices to be included in peer downloads and uploads across VLANs. **Set Download Mode to 2 - Group**. The default group is the authenticated domain or Active Directory site. If your domain-based group is too wide, or your Active Directory sites aren’t aligned with your site network topology, then you should consider additional options for dynamically creating groups, for example by using the GroupIDSrc parameter. + + + + +To do this in Group Policy go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Download mode** to **2**. + +To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set DODownloadMode to 1 or 2. + +### Hub and spoke topology with boundary groups + +The default download mode setting is **1**; this means all devices breaking out to the internet using the same public IP will be considered as a single peer group. To prevent peer-to-peer activity across groups, you should set the download mode to **2**. If you have already defined Active Directory sites per hub or branch office, then you don't need to do anything else. If you're not using Active Directory sites, you should set *RestrictPeerSelectionBy* policies to restrict the activity to the subnet or set a different source for Groups by using the GroupIDSrc parameter. See [Select a method to restrict peer selection](waas-delivery-optimization-reference.md#select-a-method-to-restrict-peer-selection). + + + +To do this in Group Policy go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Download mode** to **2**. + +To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set **DODownloadMode** to **2**. + + +### Large number of mobile devices + +If you have a mobile workforce with a great many mobile devices, set Delivery Optimization to allow uploads on battery power, while limiting the use to prevent battery drain. A setting for **DOMinBatteryPercentageAllowedToUpload** of 60% is a good starting point, though you might want to adjust it later. + +To do this in Group Policy, go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Allow uploads while the device is on battery while under set Battery level** to 60. + +To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set **DOMinBatteryPercentageAllowedToUpload** to 60. + +### Plentiful free space and large numbers of devices + +Many devices now come with large internal drives. You can set Delivery Optimization to take better advantage of this space (especially if you have large numbers of devices) by changing the minimum file size to cache. If you have more than 30 devices in your local network or group, change it from the default 50 MB to 10 MB. If you have more than 100 devices (and are running Windows 10, version 1803 or later), set this value to 1 MB. + +[//]: # (default of 50 aimed at consumer) + +To do this in Group Policy, go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Minimum Peer Caching Content File Size** to 100 (if you have more than 30 devices) or 1 (if you have more than 100 devices). + +To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set **DOMinFileSizeToCache** to 100 (if you have more than 30 devices) or 1 (if you have more than 100 devices). + +### Lab scenario + +In a lab situation, you typically have a large number of devices that are plugged in and have a lot of free disk space. By increasing the content expiration interval, you can take advantage of these devices, using them as excellent upload sources in order to upload much more content over a longer period. + +To do this in Group Policy, go to **Configuration\Policies\Administrative Templates\Windows Components\Delivery Optimization** and set **Max Cache Age** to **6048000** (7 days) or more (up to 30 days). + +To do this with MDM, go to **.Vendor/MSFT/Policy/Config/DeliveryOptimization/** and set DOMaxCacheAge to 7 or more (up to 30 days). + +[//]: # (material about "preferred" devices; remove MinQos/MaxCacheAge; table format?) + + +## Monitor Delivery Optimization +[//]: # (How to tell if it’s working? What values are reasonable; which are not? If not, which way to adjust and how? -- check PercentPeerCaching for files > minimum >= 50%) + +### Windows PowerShell cmdlets + +**Starting in Windows 10, version 1703**, you can use new PowerShell cmdlets to check the performance of Delivery Optimization. + +#### Analyze usage + +`Get-DeliveryOptimizationStatus` returns a real-time snapshot of all current Delivery Optimization jobs. + +| Key | Value | +| --- | --- | +| File ID | A GUID that identifies the file being processed | +| Priority | Priority of the download; values are **foreground** or **background** | +| FileSize | Size of the file | +| TotalBytesDownloaded | The number of bytes from any source downloaded so far | +| PercentPeerCaching |The percentage of bytes downloaded from peers versus over HTTP | +| BytesFromPeers | Total bytes downloaded from peer devices (sum of bytes downloaded from LAN, Group, and Internet Peers) | +| BytesfromHTTP | Total number of bytes received over HTTP | +| DownloadDuration | Total download time in seconds | +| Status | Current state of the operation. Possible values are: **Downloading** (download in progress); **Complete** (download completed, but is not uploading yet); **Caching** (download completed successfully and is ready to upload or uploading); **Paused** (download/upload paused by caller) | +| NumPeers | Indicates the total number of peers returned from the service. | +| PredefinedCallerApplication | Indicates the last caller that initiated a request for the file. | +| ExpireOn | The target expiration date and time for the file. | +| Pinned | A yes/no value indicating whether an item has been "pinned" in the cache (see `setDeliveryOptmizationStatus`). | + +`Get-DeliveryOptimizationPerfSnap` returns a list of key performance data: + +- Number of files downloaded  +- Number of files uploaded  +- Total bytes downloaded  +- Total bytes uploaded  +- Average transfer size (download); that is, the number bytes downloaded divided by the number of files  +- Average transfer size (upload); the number of bytes uploaded divided by the number of files +- Peer efficiency; same as PercentPeerCaching + +Using the `-Verbose` option returns additional information: + +- Bytes from peers (per type)  +- Bytes from CDN (the number of bytes received over HTTP) +- Average number of peer connections per download  + +Starting in Window 10, version 1903, `get-DeliveryOptimizationPerfSnap` has a new option `-CacheSummary` which provides a summary of the cache status. + +Starting in Windows 10, version 1803, `Get-DeliveryOptimizationPerfSnapThisMonth` returns data similar to that from `Get-DeliveryOptimizationPerfSnap` but limited to the current calendar month. + +#### Manage the Delivery Optimization cache + +**Starting in Windows 10, version 1903:** + +`set-DeliveryOptimizationStatus -ExpireOn [date time]` extends the expiration of all files in the cache. You can set the expiration immediately for all files that are in the "caching" state. For files in progress ("downloading"), the expiration is applied once the download is complete. You can set the expiration up to one year from the current date and time. + +`set-DeliveryOptimizationStatus -ExpireOn [date time] -FileID [FileID]` extends expiration for a single specific file in the cache. + +You can now "pin" files to keep them persistent in the cache. You can only do this with files that are downloaded in modes 1, 2, or 3. + +`set-DeliveryOptimizationStatus -Pin [True] -File ID [FileID]` keeps a specific file in the cache such that it won't be deleted until the expiration date and time (which you set with `set-DeliveryOptimizationStatus -ExpireOn [date time] -FileID [FileID]`). The file is also excluded from the cache quota calculation. + +`set-DeliveryOptimizationStatus -Pin [False] -File ID [FileID]` "unpins" a file, so that it will be deleted when the expiration date and time are rreached. The file is included in the cache quota calculation. + +`delete-DeliveryOptimizationCache` lets you clear files from the cache and remove all persisted data related to them. You can use these options with this cmdlet: + +- `-FileID` specifies a particular file to delete. +- `-IncludePinnedFiles` deletes all files that are pinned. +- `-Force` deletes the cache with no prompts. + + +#### Work with Delivery Optimization logs + +**Starting in Windows 10, version 1803:** + +`Get-DeliveryOptimizationLog [-Path ] [-Flush]` + +If `Path` is not specified, this cmdlet reads all logs from the dosvc log directory, which requires administrator permissions. If `Flush` is specified, the cmdlet stops dosvc before reading logs. + +Log entries are written to the PowerShell pipeline as objects. To dump logs to a text file, run `Get-DeliveryOptimizationLog | Set-Content ` or something similar. + +[//]: # (section on what to look for in logs, list of peers, connection failures) + + + +[//]: # (possibly move to Troubleshooting) + +### Monitor with Update Compliance + +The Update Compliance solution of Windows Analytics provides you with information about your Delivery Optimization configuration, including the observed bandwidth savings across all devices that used peer-to-peer distribution over the past 28 days. + +![DO status](images/UC_workspace_DO_status.png) + +For details, see [Delivery Optimization in Update Compliance](update-compliance-delivery-optimization.md). + From 0f1316cf58f705d5252caf580772e915ed4cfd69 Mon Sep 17 00:00:00 2001 From: jaimeo Date: Mon, 7 Oct 2019 15:31:31 -0700 Subject: [PATCH 03/11] adjusted TOC and WA Overview topic --- windows/deployment/TOC.md | 21 ++-- .../update/windows-analytics-overview.md | 114 +++++++++--------- 2 files changed, 65 insertions(+), 70 deletions(-) diff --git a/windows/deployment/TOC.md b/windows/deployment/TOC.md index 2ac2f8253f..461bbb314e 100644 --- a/windows/deployment/TOC.md +++ b/windows/deployment/TOC.md @@ -240,6 +240,16 @@ #### [Delivery Optimization reference](update/waas-delivery-optimization-reference.md) #### [Configure BranchCache for Windows 10 updates](update/waas-branchcache.md) #### [Whitepaper: Windows Updates using forward and reverse differentials](update/PSFxWhitepaper.md) +### Monitor Windows Updates +#### [Monitor Windows Updates with Update Compliance](update/update-compliance-monitor.md) +#### [Get started with Update Compliance](update/update-compliance-get-started.md) +#### [Use Update Compliance](update/update-compliance-using.md) +##### [Need Attention! report](update/update-compliance-need-attention.md) +##### [Security Update Status report](update/update-compliance-security-update-status.md) +##### [Feature Update Status report](update/update-compliance-feature-update-status.md) +##### [Windows Defender AV Status report](update/update-compliance-wd-av-status.md) +##### [Delivery Optimization in Update Compliance](update/update-compliance-delivery-optimization.md) +##### [Update Compliance Perspectives](update/update-compliance-perspectives.md) ### Best practices #### [Best practices for feature updates on mission-critical devices](update/feature-update-mission-critical.md) #### [Deploy feature updates during maintenance windows](update/feature-update-maintenance-window.md) @@ -260,7 +270,6 @@ ### [Manage device restarts after updates](update/waas-restart.md) ### [Manage additional Windows Update settings](update/waas-wu-settings.md) ### [Determine the source of Windows updates](update/windows-update-sources.md) - ## Windows Analytics ### [Windows Analytics overview](update/windows-analytics-overview.md) ### [Windows Analytics in the Azure Portal](update/windows-analytics-azure-portal.md) @@ -281,16 +290,6 @@ ##### [Step 4: Monitor deployment](upgrade/upgrade-readiness-monitor-deployment.md) ##### [Additional insights](upgrade/upgrade-readiness-additional-insights.md) ##### [Targeting a new operating system version](upgrade/upgrade-readiness-target-new-OS.md) -### Monitor Windows Updates -#### [Monitor Windows Updates with Update Compliance](update/update-compliance-monitor.md) -#### [Get started with Update Compliance](update/update-compliance-get-started.md) -#### [Use Update Compliance](update/update-compliance-using.md) -##### [Need Attention! report](update/update-compliance-need-attention.md) -##### [Security Update Status report](update/update-compliance-security-update-status.md) -##### [Feature Update Status report](update/update-compliance-feature-update-status.md) -##### [Windows Defender AV Status report](update/update-compliance-wd-av-status.md) -##### [Delivery Optimization in Update Compliance](update/update-compliance-delivery-optimization.md) -##### [Update Compliance Perspectives](update/update-compliance-perspectives.md) ### Device Health #### [Device Health overview](update/device-health-monitor.md) #### [Get started with Device Health](update/device-health-get-started.md) diff --git a/windows/deployment/update/windows-analytics-overview.md b/windows/deployment/update/windows-analytics-overview.md index 833f2db650..37a3525581 100644 --- a/windows/deployment/update/windows-analytics-overview.md +++ b/windows/deployment/update/windows-analytics-overview.md @@ -1,59 +1,55 @@ ---- -title: Windows Analytics -ms.reviewer: -manager: laurawi -description: Introduction and overview of Windows Analytics -keywords: Device Health, Upgrade Readiness, Update Compliance, oms, operations management suite, prerequisites, requirements, monitoring, crash, drivers -ms.prod: w10 -ms.mktglfcycl: deploy -ms.sitesec: library -ms.pagetype: deploy -audience: itpro author: greg-lindsay -ms.audience: itpro author: greg-lindsay -ms.localizationpriority: medium -ms.collection: M365-analytics -ms.topic: article ---- - -# Windows Analytics overview - -Windows Analytics is a set of solutions for Azure Portal that provide you with extensive data about the state of devices in your deployment. There are currently three solutions which you can use singly or in any combination: - -## Device Health - -[Device Health](device-health-get-started.md) provides the following: - -- Identification of devices that crash frequently, and therefore might need to be rebuilt or replaced -- Identification of device drivers that are causing device crashes, with suggestions of alternative versions of those drivers that might reduce the number of crashes -- Notification of Windows Information Protection misconfigurations that send prompts to end users - - -## Update Compliance - -[Update Compliance](update-compliance-get-started.md) shows you the state of your devices with respect to the Windows updates so that you can ensure that they are on the most current updates as appropriate. In addition, Update Compliance provides the following: - -- Dedicated drill-downs for devices that might need attention -- An inventory of devices, including the version of Windows they are running and their update status -- The ability to track protection and threat status for Windows Defender Antivirus-enabled devices -- An overview of Windows Update for Business deferral configurations (Windows 10, version 1607 and later) -- Powerful built-in log analytics to create useful custom queries -- Cloud-connected access utilizing Windows 10 diagnostic data means no need for new complex, customized infrastructure - -## Upgrade Readiness - -[Upgrade Readiness](../upgrade/upgrade-readiness-get-started.md) offers a set of tools to plan and manage the upgrade process end to end, allowing you to adopt new Windows releases more quickly. With new Windows versions being released multiple times a year, ensuring application and driver compatibility on an ongoing basis is key to adopting new Windows versions as they are released. Upgrade Readiness not only supports upgrade management from Windows 7 and Windows 8.1 to Windows 10, but also Windows 10 upgrades in the Windows as a service model. - -Use Upgrade Readiness to get: - -- A visual workflow that guides you from pilot to production -- Detailed computer and application inventory -- Powerful computer-level search and drill-downs -- Guidance and insights into application and driver compatibility issues, with suggested fixes -- Data-driven application rationalization tools -- Application usage information, allowing targeted validation; workflow to track validation progress and decisions -- Data export to commonly used software deployment tools, including System Center Configuration Manager - -To get started with any of these solutions, visit the links for instructions to add it to Azure Portal. - ->[!NOTE] -> For details about licensing requirements and costs associated with using Windows Analytics solutions, see [What are the requirements and costs for Windows Analytics solutions?](windows-analytics-FAQ-troubleshooting.md#what-are-the-requirements-and-costs-for-windows-analytics-solutions). +--- +title: Windows Analytics +ms.reviewer: +manager: laurawi +description: Introduction and overview of Windows Analytics +keywords: Device Health, Upgrade Readiness, Update Compliance, oms, operations management suite, prerequisites, requirements, monitoring, crash, drivers +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.pagetype: deploy +audience: itpro +author: jaimeo +ms.audience: itpro +author: jaimeo +ms.localizationpriority: medium +ms.collection: M365-analytics +ms.topic: article +--- + +# Windows Analytics overview + +Windows Analytics is a set of solutions for Azure Portal that provide you with extensive data about the state of devices in your deployment. There are currently three solutions which you can use singly or in any combination: + +>[!IMPORTANT] +>[Update Compliance](update-compliance-get-started.md) is moving out of Windows Analytics. Windows Analytics is being retired, but Update Compliance will continue to be supported. For more information, see the [Update Compliance FAQ](windows-analytics-get-started.md). + + +## Device Health + +[Device Health](device-health-get-started.md) provides the following: + +- Identification of devices that crash frequently, and therefore might need to be rebuilt or replaced +- Identification of device drivers that are causing device crashes, with suggestions of alternative versions of those drivers that might reduce the number of crashes +- Notification of Windows Information Protection misconfigurations that send prompts to end users + + + +## Upgrade Readiness + +[Upgrade Readiness](../upgrade/upgrade-readiness-get-started.md) offers a set of tools to plan and manage the upgrade process end to end, allowing you to adopt new Windows releases more quickly. With new Windows versions being released multiple times a year, ensuring application and driver compatibility on an ongoing basis is key to adopting new Windows versions as they are released. Upgrade Readiness not only supports upgrade management from Windows 7 and Windows 8.1 to Windows 10, but also Windows 10 upgrades in the Windows as a service model. + +Use Upgrade Readiness to get: + +- A visual workflow that guides you from pilot to production +- Detailed computer and application inventory +- Powerful computer-level search and drill-downs +- Guidance and insights into application and driver compatibility issues, with suggested fixes +- Data-driven application rationalization tools +- Application usage information, allowing targeted validation; workflow to track validation progress and decisions +- Data export to commonly used software deployment tools, including System Center Configuration Manager + +To get started with any of these solutions, visit the links for instructions to add it to Azure Portal. + +>[!NOTE] +> For details about licensing requirements and costs associated with using Windows Analytics solutions, see [What are the requirements and costs for Windows Analytics solutions?](windows-analytics-FAQ-troubleshooting.md#what-are-the-requirements-and-costs-for-windows-analytics-solutions). From a3bf01deb432262722fbb494d0351bc8357325e1 Mon Sep 17 00:00:00 2001 From: jaimeo Date: Tue, 8 Oct 2019 14:13:43 -0700 Subject: [PATCH 04/11] edits from Albert, et al. --- windows/deployment/update/update-compliance-monitor.md | 3 ++- windows/deployment/update/windows-analytics-overview.md | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/windows/deployment/update/update-compliance-monitor.md b/windows/deployment/update/update-compliance-monitor.md index 46ef650f22..3a02fa37ca 100644 --- a/windows/deployment/update/update-compliance-monitor.md +++ b/windows/deployment/update/update-compliance-monitor.md @@ -19,7 +19,8 @@ ms.topic: article # Monitor Windows Updates with Update Compliance >[!IMPORTANT] ->Update Compliance is moving out of Windows Analytics. Windows Analytics is being retired, but Update Compliance will continue to be supported. For more information, see the [Update Compliance FAQ](windows-analytics-get-started.md). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + ## Introduction diff --git a/windows/deployment/update/windows-analytics-overview.md b/windows/deployment/update/windows-analytics-overview.md index 37a3525581..c84fb0d8a4 100644 --- a/windows/deployment/update/windows-analytics-overview.md +++ b/windows/deployment/update/windows-analytics-overview.md @@ -22,7 +22,7 @@ ms.topic: article Windows Analytics is a set of solutions for Azure Portal that provide you with extensive data about the state of devices in your deployment. There are currently three solutions which you can use singly or in any combination: >[!IMPORTANT] ->[Update Compliance](update-compliance-get-started.md) is moving out of Windows Analytics. Windows Analytics is being retired, but Update Compliance will continue to be supported. For more information, see the [Update Compliance FAQ](windows-analytics-get-started.md). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). ## Device Health From 304ddc5d4247a5158f029473da6bfed1c01db66c Mon Sep 17 00:00:00 2001 From: jaimeo Date: Fri, 11 Oct 2019 10:27:18 -0700 Subject: [PATCH 05/11] added WA deprecation note to DH and UR topics --- .../update/device-health-get-started.md | 157 ++++++++--------- .../upgrade/upgrade-readiness-get-started.md | 163 +++++++++--------- 2 files changed, 161 insertions(+), 159 deletions(-) diff --git a/windows/deployment/update/device-health-get-started.md b/windows/deployment/update/device-health-get-started.md index eb1b10ab08..82d1a27df0 100644 --- a/windows/deployment/update/device-health-get-started.md +++ b/windows/deployment/update/device-health-get-started.md @@ -1,78 +1,79 @@ ---- -title: Get started with Device Health -description: Configure Device Health in Azure Monitor to monitor health (such as crashes and sign-in failures) for your Windows 10 devices. -keywords: Device Health, oms, operations management suite, prerequisites, requirements, monitoring, crash, drivers, azure -ms.prod: w10 -ms.mktglfcycl: deploy -ms.sitesec: library -ms.date: 10/29/2018 -ms.reviewer: -manager: laurawi -ms.pagetype: deploy -audience: itpro author: greg-lindsay -ms.author: greglin -ms.localizationpriority: medium -ms.collection: M365-analytics -ms.topic: article ---- - -# Get started with Device Health - -This topic explains the steps necessary to configure your environment for Windows Analytics Device Health. - -- [Get started with Device Health](#get-started-with-device-health) - - [Add the Device Health solution to your Azure subscription](#add-the-device-health-solution-to-your-azure-subscription) - - [Enroll devices in Windows Analytics](#enroll-devices-in-windows-analytics) - - [Use Device Health to monitor device crashes, app crashes, sign-in failures, and more](#use-device-health-to-monitor-device-crashes-app-crashes-sign-in-failures-and-more) - - [Related topics](#related-topics) - - - -## Add the Device Health solution to your Azure subscription - -Device Health is offered as a *solution* which you link to a new or existing [Azure Monitor](https://azure.microsoft.com/services/monitor/) *workspace* within your Azure *subscription*. To configure this, follows these steps: - -1. Sign in to the [Azure Portal](https://portal.azure.com) with your work or school account or a Microsoft account. If you don't already have an Azure subscription you can create one (including free trial options) through the portal. - - >[!NOTE] - > Device Health is included at no additional cost with Windows 10 [education and enterprise licensing](https://docs.microsoft.com/windows/deployment/update/device-health-monitor#device-health-licensing). An Azure subscription is required for managing and using Device Health, but no Azure charges are expected to accrue to the subscription as a result of using Device Health. - -2. In the Azure portal select **Create a resource**, search for "Device Health", and then select **Create** on the **Device Health** solution. - ![Azure portal page highlighting + Create a resource and with Device Health selected](images/CreateSolution-Part1-Marketplace.png) - - ![Azure portal showing Device Health fly-in and Create button highlighted(images/CreateSolution-Part2-Create.png)](images/CreateSolution-Part2-Create.png) -3. Choose an existing workspace or create a new workspace to host the Device Health solution. - ![Azure portal showing Azure Monitor workspace fly-in](images/CreateSolution-Part3-Workspace.png) - - If you are using other Windows Analytics solutions (Upgrade Readiness or Update Compliance) you should add Device Health to the same workspace. - - If you are creating a new workspace, and your organization does not have policies governing naming conventions and structure, consider the following workspace settings to get started: - - Choose a workspace name which reflects the scope of planned usage in your organization, for example *PC-Analytics*. - - For the resource group setting select **Create new** and use the same name you chose for your new workspace. - - For the location setting, choose the Azure region where you would prefer the data to be stored. - - For the pricing tier select **per GB**. -4. Now that you have selected a workspace, you can go back to the Device Health blade and select **Create**. - ![Azure portal showing workspace selected and with Create button highlighted](images/CreateSolution-Part4-WorkspaceSelected.png) -5. Watch for a Notification (in the Azure portal) that "Deployment 'Microsoft.DeviceHealth' to resource group 'YourResourceGroupName' was successful." and then select **Go to resource** This might take several minutes to appear. - ![Azure portal all services page with Azure Monitor found and selected as favorite](images/CreateSolution-Part5-GoToResource.png) - - Suggestion: Choose the **Pin to Dashboard** option to make it easy to navigate to your newly added Device Health solution. - - Suggestion: If a "resource unavailable" error occurs when navigating to the solution, try again after one hour. - -## Enroll devices in Windows Analytics - -Once you've added Device Health to a workspace in your Azure subscription, you can start enrolling the devices in your organization. For Device Health there are two key steps for enrollment: -1. Deploy your CommercialID (from Device Health Settings page) to your Windows 10 devices (typically using Group Policy or similar) -2. Ensure the Windows Diagnostic Data setting on devices is set to Enhanced or Full (typically using Group Policy or similar). Note that the [Limit Enhanced](https://docs.microsoft.com/windows/privacy/enhanced-diagnostic-data-windows-analytics-events-and-fields) policy can substantially reduce the amount of diagnostic data shared with Microsoft while still allowing Device Health to function. -For full enrollment instructions and troubleshooting, see [Enrolling devices in Windows Analytics](windows-analytics-get-started.md). - -After enrolling your devices (by deploying your CommercialID and Windows Diagnostic Data settings), it may take 48-72 hours for the first data to appear in the solution. Until then, the Device Health tile will show "Performing Assessment." - -## Use Device Health to monitor device crashes, app crashes, sign-in failures, and more - -Once your devices are enrolled and data is flowing, you can move on to [Using Device Health](device-health-using.md). - ->[!NOTE] ->You can remove the Device Health solution from your workspace if you no longer want to monitor your organization’s devices. Windows diagnostic data will continue to be shared with Microsoft as normal as per the diagnostic data sharing settings on the devices. - -## Related topics - -[Use Device Health to monitor frequency and causes of device crashes](device-health-using.md)
-For the latest information on Windows Analytics, including new features and usage tips, see the [Windows Analytics blog](https://blogs.technet.microsoft.com/upgradeanalytics) +--- +title: Get started with Device Health +description: Configure Device Health in Azure Monitor to monitor health (such as crashes and sign-in failures) for your Windows 10 devices. +keywords: Device Health, oms, operations management suite, prerequisites, requirements, monitoring, crash, drivers, azure +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.reviewer: +manager: laurawi +ms.pagetype: deploy +audience: itpro +author: jaimeo +ms.author: jaimeo +ms.localizationpriority: medium +ms.collection: M365-analytics +ms.topic: article +--- + +# Get started with Device Health + +This topic explains the steps necessary to configure your environment for Windows Analytics Device Health. + +- [Get started with Device Health](#get-started-with-device-health) + - [Add the Device Health solution to your Azure subscription](#add-the-device-health-solution-to-your-azure-subscription) + - [Enroll devices in Windows Analytics](#enroll-devices-in-windows-analytics) + - [Use Device Health to monitor device crashes, app crashes, sign-in failures, and more](#use-device-health-to-monitor-device-crashes-app-crashes-sign-in-failures-and-more) + - [Related topics](#related-topics) + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +## Add the Device Health solution to your Azure subscription + +Device Health is offered as a *solution* which you link to a new or existing [Azure Monitor](https://azure.microsoft.com/services/monitor/) *workspace* within your Azure *subscription*. To configure this, follows these steps: + +1. Sign in to the [Azure Portal](https://portal.azure.com) with your work or school account or a Microsoft account. If you don't already have an Azure subscription you can create one (including free trial options) through the portal. + + >[!NOTE] + > Device Health is included at no additional cost with Windows 10 [education and enterprise licensing](https://docs.microsoft.com/windows/deployment/update/device-health-monitor#device-health-licensing). An Azure subscription is required for managing and using Device Health, but no Azure charges are expected to accrue to the subscription as a result of using Device Health. + +2. In the Azure portal select **Create a resource**, search for "Device Health", and then select **Create** on the **Device Health** solution. + ![Azure portal page highlighting + Create a resource and with Device Health selected](images/CreateSolution-Part1-Marketplace.png) + + ![Azure portal showing Device Health fly-in and Create button highlighted(images/CreateSolution-Part2-Create.png)](images/CreateSolution-Part2-Create.png) +3. Choose an existing workspace or create a new workspace to host the Device Health solution. + ![Azure portal showing Azure Monitor workspace fly-in](images/CreateSolution-Part3-Workspace.png) + - If you are using other Windows Analytics solutions (Upgrade Readiness or Update Compliance) you should add Device Health to the same workspace. + - If you are creating a new workspace, and your organization does not have policies governing naming conventions and structure, consider the following workspace settings to get started: + - Choose a workspace name which reflects the scope of planned usage in your organization, for example *PC-Analytics*. + - For the resource group setting select **Create new** and use the same name you chose for your new workspace. + - For the location setting, choose the Azure region where you would prefer the data to be stored. + - For the pricing tier select **per GB**. +4. Now that you have selected a workspace, you can go back to the Device Health blade and select **Create**. + ![Azure portal showing workspace selected and with Create button highlighted](images/CreateSolution-Part4-WorkspaceSelected.png) +5. Watch for a Notification (in the Azure portal) that "Deployment 'Microsoft.DeviceHealth' to resource group 'YourResourceGroupName' was successful." and then select **Go to resource** This might take several minutes to appear. + ![Azure portal all services page with Azure Monitor found and selected as favorite](images/CreateSolution-Part5-GoToResource.png) + - Suggestion: Choose the **Pin to Dashboard** option to make it easy to navigate to your newly added Device Health solution. + - Suggestion: If a "resource unavailable" error occurs when navigating to the solution, try again after one hour. + +## Enroll devices in Windows Analytics + +Once you've added Device Health to a workspace in your Azure subscription, you can start enrolling the devices in your organization. For Device Health there are two key steps for enrollment: +1. Deploy your CommercialID (from Device Health Settings page) to your Windows 10 devices (typically using Group Policy or similar) +2. Ensure the Windows Diagnostic Data setting on devices is set to Enhanced or Full (typically using Group Policy or similar). Note that the [Limit Enhanced](https://docs.microsoft.com/windows/privacy/enhanced-diagnostic-data-windows-analytics-events-and-fields) policy can substantially reduce the amount of diagnostic data shared with Microsoft while still allowing Device Health to function. +For full enrollment instructions and troubleshooting, see [Enrolling devices in Windows Analytics](windows-analytics-get-started.md). + +After enrolling your devices (by deploying your CommercialID and Windows Diagnostic Data settings), it may take 48-72 hours for the first data to appear in the solution. Until then, the Device Health tile will show "Performing Assessment." + +## Use Device Health to monitor device crashes, app crashes, sign-in failures, and more + +Once your devices are enrolled and data is flowing, you can move on to [Using Device Health](device-health-using.md). + +>[!NOTE] +>You can remove the Device Health solution from your workspace if you no longer want to monitor your organization’s devices. Windows diagnostic data will continue to be shared with Microsoft as normal as per the diagnostic data sharing settings on the devices. + +## Related topics + +[Use Device Health to monitor frequency and causes of device crashes](device-health-using.md)
+For the latest information on Windows Analytics, including new features and usage tips, see the [Windows Analytics blog](https://blogs.technet.microsoft.com/upgradeanalytics) diff --git a/windows/deployment/upgrade/upgrade-readiness-get-started.md b/windows/deployment/upgrade/upgrade-readiness-get-started.md index 47a7fc7fe2..7681eb53ba 100644 --- a/windows/deployment/upgrade/upgrade-readiness-get-started.md +++ b/windows/deployment/upgrade/upgrade-readiness-get-started.md @@ -1,81 +1,82 @@ ---- -title: Get started with Upgrade Readiness (Windows 10) -ms.reviewer: -manager: laurawi -description: Explains how to get started with Upgrade Readiness. -keywords: windows analytics, oms, operations management suite, prerequisites, requirements, upgrades, log analytics, -ms.prod: w10 -ms.mktglfcycl: deploy -ms.sitesec: library -ms.pagetype: deploy -audience: itpro author: greg-lindsay -ms.author: greglin -ms.localizationpriority: medium -ms.topic: article -ms.collection: M365-analytics ---- - -# Get started with Upgrade Readiness - ->[!IMPORTANT] ->**The OMS portal has been deprecated; you should start using the [Azure portal](https://portal.azure.com) instead as soon as possible.** Many experiences are the same in the two portals, but there are some key differences. See [Windows Analytics in the Azure Portal](../update/windows-analytics-azure-portal.md) for steps to use Windows Analytics in the Azure portal. For much more information about the transition from OMS to Azure, see [OMS portal moving to Azure](https://docs.microsoft.com/azure/log-analytics/log-analytics-oms-portal-transition). - -This topic explains how to obtain and configure Upgrade Readiness for your organization. - -You can use Upgrade Readiness to plan and manage your upgrade project end-to-end. Upgrade Readiness works by establishing communications between computers in your organization and Microsoft. Upgrade Readiness collects computer, application, and driver data for analysis. This data is used to identify compatibility issues that can block your upgrade and to suggest fixes that are known to Microsoft. - -Before you begin, consider reviewing the following helpful information:
- - [Upgrade Readiness requirements](upgrade-readiness-requirements.md): Provides detailed requirements to use Upgrade Readiness.
- - [Upgrade Readiness blog](https://techcommunity.microsoft.com/t5/Windows-Analytics-Blog/bg-p/WindowsAnalyticsBlog): Contains announcements of new features and provides helpful tips for using Upgrade Readiness. - ->If you are using System Center Configuration Manager, also check out information about how to integrate Upgrade Readiness with Configuration Manager: [Integrate Upgrade Readiness with System Center Configuration Manager](https://docs.microsoft.com/sccm/core/clients/manage/upgrade/upgrade-analytics). - -When you are ready to begin using Upgrade Readiness, perform the following steps: - -1. Review [data collection and privacy](#data-collection-and-privacy) information. -2. [Add the Upgrade Readiness solution to your Azure subsctiption](#add-the-upgrade-readiness-solution-to-your-azure-subscription). -3. [Enroll devices in Windows Analytics](#enroll-devices-in-windows-analytics). -4. [Use Upgrade Readiness to manage Windows Upgrades](#use-upgrade-readiness-to-manage-windows-upgrades) once your devices are enrolled. - -## Data collection and privacy - -To enable system, application, and driver data to be shared with Microsoft, you must configure user computers to send data. For information about what diagnostic data Microsoft collects and how that data is used and protected by Microsoft, see the following topics, refer to [Frequently asked questions and troubleshooting Windows Analytics](https://docs.microsoft.com/windows/deployment/update/windows-analytics-FAQ-troubleshooting), which discusses the issues and provides links to still more detailed information. - -## Add the Upgrade Readiness solution to your Azure subscription - -Upgrade Readiness is offered as a *solution* which you link to a new or existing [Azure Log Analytics](https://azure.microsoft.com/services/log-analytics/) *workspace* within your Azure *subscription*. To configure this, follows these steps: - -1. Sign in to the [Azure Portal](https://portal.azure.com) with your work or school account or a Microsoft account. If you don't already have an Azure subscription you can create one (including free trial options) through the portal. - - >[!NOTE] - > Upgrade Readiness is included at no additional cost with Windows 10 Professional, Education, and Enterprise editions. An Azure subscription is required for managing and using Upgrade Readiness, but no Azure charges are expected to accrue to the subscription as a result of using Upgrade Readiness. - -2. In the Azure portal select **Create a resource**, search for "Upgrade Readiness", and then select **Create** on the **Upgrade Readiness** solution. - ![Azure portal page highlighting + Create a resource and with Upgrade Readiness selected](../images/UR-Azureportal1.png) - - ![Azure portal showing Upgrade Readiness fly-in and Create button highlighted(images/CreateSolution-Part2-Create.png)](../images/UR-Azureportal2.png) -3. Choose an existing workspace or create a new workspace to host the Upgrade Readiness solution. - ![Azure portal showing Log Analytics workspace fly-in](../images/UR-Azureportal3.png) - - If you are using other Windows Analytics solutions (Device Health or Update Compliance) you should add Upgrade Readiness to the same workspace. - - If you are creating a new workspace, and your organization does not have policies governing naming conventions and structure, consider the following workspace settings to get started: - - Choose a workspace name which reflects the scope of planned usage in your organization, for example *PC-Analytics*. - - For the resource group setting select **Create new** and use the same name you chose for your new workspace. - - For the location setting, choose the Azure region where you would prefer the data to be stored. - - For the pricing tier select **per GB**. -4. Now that you have selected a workspace, you can go back to the Upgrade Readiness blade and select **Create**. - ![Azure portal showing workspace selected and with Create button highlighted](../images/UR-Azureportal4.png) -5. Watch for a Notification (in the Azure portal) that "Deployment 'Microsoft.CompatibilityAssessmentOMS' to resource group 'YourResourceGroupName' was successful." and then select **Go to resource** This might take several minutes to appear. - ![Azure portal all services page with Log Analytics found and selected as favorite](../images/CreateSolution-Part5-GoToResource.png) - - Suggestion: Choose the **Pin to Dashboard** option to make it easy to navigate to your newly added Upgrade Readiness solution. - - Suggestion: If a "resource unavailable" error occurs when navigating to the solution, try again after one hour. - -## Enroll devices in Windows Analytics - - -Once you've added Upgrade Readiness to a workspace in your Azure subscription, you can start enrolling the devices in your organization. For full instructions, see [Enrolling devices in Windows Analytics](https://docs.microsoft.com/windows/deployment/update/windows-analytics-get-started). - - - -## Use Upgrade Readiness to manage Windows Upgrades - -Now that your devices are enrolled, you can move on to [Use Upgrade Readiness to manage Windows Upgrades](https://docs.microsoft.com/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades). +--- +title: Get started with Upgrade Readiness (Windows 10) +ms.reviewer: +manager: laurawi +description: Explains how to get started with Upgrade Readiness. +keywords: windows analytics, oms, operations management suite, prerequisites, requirements, upgrades, log analytics, +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.pagetype: deploy +audience: itpro +author: jaimeo +ms.author: jaimeo +ms.localizationpriority: medium +ms.topic: article +ms.collection: M365-analytics +--- + +# Get started with Upgrade Readiness + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +This topic explains how to obtain and configure Upgrade Readiness for your organization. + +You can use Upgrade Readiness to plan and manage your upgrade project end-to-end. Upgrade Readiness works by establishing communications between computers in your organization and Microsoft. Upgrade Readiness collects computer, application, and driver data for analysis. This data is used to identify compatibility issues that can block your upgrade and to suggest fixes that are known to Microsoft. + +Before you begin, consider reviewing the following helpful information:
+ - [Upgrade Readiness requirements](upgrade-readiness-requirements.md): Provides detailed requirements to use Upgrade Readiness.
+ - [Upgrade Readiness blog](https://techcommunity.microsoft.com/t5/Windows-Analytics-Blog/bg-p/WindowsAnalyticsBlog): Contains announcements of new features and provides helpful tips for using Upgrade Readiness. + +>If you are using System Center Configuration Manager, also check out information about how to integrate Upgrade Readiness with Configuration Manager: [Integrate Upgrade Readiness with System Center Configuration Manager](https://docs.microsoft.com/sccm/core/clients/manage/upgrade/upgrade-analytics). + +When you are ready to begin using Upgrade Readiness, perform the following steps: + +1. Review [data collection and privacy](#data-collection-and-privacy) information. +2. [Add the Upgrade Readiness solution to your Azure subsctiption](#add-the-upgrade-readiness-solution-to-your-azure-subscription). +3. [Enroll devices in Windows Analytics](#enroll-devices-in-windows-analytics). +4. [Use Upgrade Readiness to manage Windows Upgrades](#use-upgrade-readiness-to-manage-windows-upgrades) once your devices are enrolled. + +## Data collection and privacy + +To enable system, application, and driver data to be shared with Microsoft, you must configure user computers to send data. For information about what diagnostic data Microsoft collects and how that data is used and protected by Microsoft, see the following topics, refer to [Frequently asked questions and troubleshooting Windows Analytics](https://docs.microsoft.com/windows/deployment/update/windows-analytics-FAQ-troubleshooting), which discusses the issues and provides links to still more detailed information. + +## Add the Upgrade Readiness solution to your Azure subscription + +Upgrade Readiness is offered as a *solution* which you link to a new or existing [Azure Log Analytics](https://azure.microsoft.com/services/log-analytics/) *workspace* within your Azure *subscription*. To configure this, follows these steps: + +1. Sign in to the [Azure Portal](https://portal.azure.com) with your work or school account or a Microsoft account. If you don't already have an Azure subscription you can create one (including free trial options) through the portal. + + >[!NOTE] + > Upgrade Readiness is included at no additional cost with Windows 10 Professional, Education, and Enterprise editions. An Azure subscription is required for managing and using Upgrade Readiness, but no Azure charges are expected to accrue to the subscription as a result of using Upgrade Readiness. + +2. In the Azure portal select **Create a resource**, search for "Upgrade Readiness", and then select **Create** on the **Upgrade Readiness** solution. + ![Azure portal page highlighting + Create a resource and with Upgrade Readiness selected](../images/UR-Azureportal1.png) + + ![Azure portal showing Upgrade Readiness fly-in and Create button highlighted(images/CreateSolution-Part2-Create.png)](../images/UR-Azureportal2.png) +3. Choose an existing workspace or create a new workspace to host the Upgrade Readiness solution. + ![Azure portal showing Log Analytics workspace fly-in](../images/UR-Azureportal3.png) + - If you are using other Windows Analytics solutions (Device Health or Update Compliance) you should add Upgrade Readiness to the same workspace. + - If you are creating a new workspace, and your organization does not have policies governing naming conventions and structure, consider the following workspace settings to get started: + - Choose a workspace name which reflects the scope of planned usage in your organization, for example *PC-Analytics*. + - For the resource group setting select **Create new** and use the same name you chose for your new workspace. + - For the location setting, choose the Azure region where you would prefer the data to be stored. + - For the pricing tier select **per GB**. +4. Now that you have selected a workspace, you can go back to the Upgrade Readiness blade and select **Create**. + ![Azure portal showing workspace selected and with Create button highlighted](../images/UR-Azureportal4.png) +5. Watch for a Notification (in the Azure portal) that "Deployment 'Microsoft.CompatibilityAssessmentOMS' to resource group 'YourResourceGroupName' was successful." and then select **Go to resource** This might take several minutes to appear. + ![Azure portal all services page with Log Analytics found and selected as favorite](../images/CreateSolution-Part5-GoToResource.png) + - Suggestion: Choose the **Pin to Dashboard** option to make it easy to navigate to your newly added Upgrade Readiness solution. + - Suggestion: If a "resource unavailable" error occurs when navigating to the solution, try again after one hour. + +## Enroll devices in Windows Analytics + + +Once you've added Upgrade Readiness to a workspace in your Azure subscription, you can start enrolling the devices in your organization. For full instructions, see [Enrolling devices in Windows Analytics](https://docs.microsoft.com/windows/deployment/update/windows-analytics-get-started). + + + +## Use Upgrade Readiness to manage Windows Upgrades + +Now that your devices are enrolled, you can move on to [Use Upgrade Readiness to manage Windows Upgrades](https://docs.microsoft.com/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades). From 1642ecb349d82d06c43e6e6538f9a86d1da69ba6 Mon Sep 17 00:00:00 2001 From: jaimeo Date: Mon, 14 Oct 2019 09:01:50 -0700 Subject: [PATCH 06/11] added warning about UR/DH retirement to all UR and DC topics --- .../update/device-health-get-started.md | 3 + .../update/device-health-monitor.md | 172 +++---- .../deployment/update/device-health-using.md | 3 + .../upgrade-readiness-additional-insights.md | 7 +- .../upgrade/upgrade-readiness-architecture.md | 74 +-- .../upgrade/upgrade-readiness-data-sharing.md | 118 ++--- .../upgrade-readiness-deploy-windows.md | 208 +++++---- .../upgrade-readiness-deployment-script.md | 7 +- .../upgrade-readiness-identify-apps.md | 86 ++-- .../upgrade-readiness-monitor-deployment.md | 106 +++-- .../upgrade/upgrade-readiness-requirements.md | 156 ++++--- .../upgrade-readiness-resolve-issues.md | 436 +++++++++--------- .../upgrade-readiness-target-new-OS.md | 126 ++--- .../upgrade-readiness-upgrade-overview.md | 150 +++--- ...de-readiness-to-manage-windows-upgrades.md | 3 + 15 files changed, 855 insertions(+), 800 deletions(-) diff --git a/windows/deployment/update/device-health-get-started.md b/windows/deployment/update/device-health-get-started.md index 82d1a27df0..23a56637e9 100644 --- a/windows/deployment/update/device-health-get-started.md +++ b/windows/deployment/update/device-health-get-started.md @@ -18,6 +18,9 @@ ms.topic: article # Get started with Device Health +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + This topic explains the steps necessary to configure your environment for Windows Analytics Device Health. - [Get started with Device Health](#get-started-with-device-health) diff --git a/windows/deployment/update/device-health-monitor.md b/windows/deployment/update/device-health-monitor.md index 027f6cd65b..a87d7b2ed5 100644 --- a/windows/deployment/update/device-health-monitor.md +++ b/windows/deployment/update/device-health-monitor.md @@ -1,84 +1,88 @@ ---- -title: Monitor the health of devices with Device Health -ms.reviewer: -manager: laurawi -description: You can use Device Health in Azure Portal to monitor the frequency and causes of crashes and misbehaving apps on devices in your network. -keywords: oms, operations management suite, wdav, health, log analytics -ms.prod: w10 -ms.mktglfcycl: deploy -ms.sitesec: library -ms.localizationpriority: medium -ms.pagetype: deploy -audience: itpro author: greg-lindsay -ms.author: greglin -ms.collection: M365-analytics -ms.topic: article ---- - -# Monitor the health of devices with Device Health - -## Introduction - -Device Health is the newest Windows Analytics solution that complements the existing Upgrade Readiness and Update Compliance solutions by providing IT with reports on some common problems the end users might experience so they can be proactively remediated, thus saving support calls and improving end-user productivity. - -Like Upgrade Readiness and Update Compliance, Device Health is a solution built in Azure Portal, a cloud-based monitoring and automation service that has a flexible servicing subscription based on data usage and retention. This release is free for customers to try and will not incur charges on your Azure Portal workspace for its use. For more information about Azure Portal, see [Windows Analytics in the Azure Portal](windows-analytics-azure-portal.md) . - -Device Health uses Windows diagnostic data that is part of all Windows 10 devices. If you have already employed Upgrade Readiness or Update Compliance solutions, all you need to do is select Device Health from the Azure Portal solution gallery and add it to your Azure Portal workspace. Device Health requires enhanced diagnostic data, so you might need to implement this policy if you've not already done so. - - -Device Health provides the following: - -- Identification of devices that crash frequently, and therefore might need to be rebuilt or replaced -- Identification of device drivers that are causing device crashes, with suggestions of alternative versions of those drivers that might reduce the number of crashes -- Notification of Windows Information Protection misconfigurations that send prompts to end users -- No need for new complex customized infrastructure, thanks to cloud-connected access using Windows 10 diagnostic data - -See the following topics in this guide for detailed information about configuring and using the Device Health solution: - -- [Get started with Device Health](device-health-get-started.md): How to add Device Health to your environment. -- [Using Device Health](device-health-using.md): How to begin using Device Health. - -An overview of the processes used by the Device Health solution is provided below. - -## Device Health licensing - -Use of Windows Analytics Device Health requires one of the following licenses: - -- Windows 10 Enterprise or Windows 10 Education per-device with active Software Assurance -- Windows 10 Enterprise E3 or E5 per-device or per-user subscription (including Microsoft 365 F1, E3, or E5) -- Windows 10 Education A3 or A5 (including Microsoft 365 Education A3 or A5) -- Windows VDA E3 or E5 per-device or per-user subscription - - -You don't have to install Windows 10 Enterprise on a per-device basis--you just need enough of the above licenses for the number of devices using Device Health. - - -## Device Health architecture - -The Device Health architecture and data flow is summarized by the following five-step process: - - - -**(1)** User computers send diagnostic data to a secure Microsoft data center using the Microsoft Data Management Service.
-**(2)** Diagnostic data is analyzed by the Microsoft Telemetry Service.
-**(3)** Diagnostic data is pushed from the Microsoft Telemetry Service to your Azure Portal workspace.
-**(4)** Diagnostic data is available in the Device Health solution.
-**(5)** You are now able to proactively monitor Device Health issues in your environment.
- -These steps are illustrated in following diagram: - - [![](images/analytics-architecture.png)](images/analytics-architecture.png) - ->[!NOTE] ->This process assumes that Windows diagnostic data is enabled and data sharing is enabled as described in [Enrolling devices in Windows Analytics](windows-analytics-get-started.md). - - - -  -## Related topics - -[Get started with Device Health](device-health-get-started.md) - -[Use Device Health to monitor frequency and causes of device crashes](device-health-using.md) - -For the latest information on Windows Analytics, including new features and usage tips, see the [Windows Analytics blog](https://blogs.technet.microsoft.com/upgradeanalytics) +--- +title: Monitor the health of devices with Device Health +ms.reviewer: +manager: laurawi +description: You can use Device Health in Azure Portal to monitor the frequency and causes of crashes and misbehaving apps on devices in your network. +keywords: oms, operations management suite, wdav, health, log analytics +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.localizationpriority: medium +ms.pagetype: deploy +audience: itpro +author: jaimeo +ms.author: jaimeo +ms.collection: M365-analytics +ms.topic: article +--- + +# Monitor the health of devices with Device Health + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +## Introduction + +Device Health is the newest Windows Analytics solution that complements the existing Upgrade Readiness and Update Compliance solutions by providing IT with reports on some common problems the end users might experience so they can be proactively remediated, thus saving support calls and improving end-user productivity. + +Like Upgrade Readiness and Update Compliance, Device Health is a solution built in Azure Portal, a cloud-based monitoring and automation service that has a flexible servicing subscription based on data usage and retention. This release is free for customers to try and will not incur charges on your Azure Portal workspace for its use. For more information about Azure Portal, see [Windows Analytics in the Azure Portal](windows-analytics-azure-portal.md) . + +Device Health uses Windows diagnostic data that is part of all Windows 10 devices. If you have already employed Upgrade Readiness or Update Compliance solutions, all you need to do is select Device Health from the Azure Portal solution gallery and add it to your Azure Portal workspace. Device Health requires enhanced diagnostic data, so you might need to implement this policy if you've not already done so. + + +Device Health provides the following: + +- Identification of devices that crash frequently, and therefore might need to be rebuilt or replaced +- Identification of device drivers that are causing device crashes, with suggestions of alternative versions of those drivers that might reduce the number of crashes +- Notification of Windows Information Protection misconfigurations that send prompts to end users +- No need for new complex customized infrastructure, thanks to cloud-connected access using Windows 10 diagnostic data + +See the following topics in this guide for detailed information about configuring and using the Device Health solution: + +- [Get started with Device Health](device-health-get-started.md): How to add Device Health to your environment. +- [Using Device Health](device-health-using.md): How to begin using Device Health. + +An overview of the processes used by the Device Health solution is provided below. + +## Device Health licensing + +Use of Windows Analytics Device Health requires one of the following licenses: + +- Windows 10 Enterprise or Windows 10 Education per-device with active Software Assurance +- Windows 10 Enterprise E3 or E5 per-device or per-user subscription (including Microsoft 365 F1, E3, or E5) +- Windows 10 Education A3 or A5 (including Microsoft 365 Education A3 or A5) +- Windows VDA E3 or E5 per-device or per-user subscription + + +You don't have to install Windows 10 Enterprise on a per-device basis--you just need enough of the above licenses for the number of devices using Device Health. + + +## Device Health architecture + +The Device Health architecture and data flow is summarized by the following five-step process: + + + +**(1)** User computers send diagnostic data to a secure Microsoft data center using the Microsoft Data Management Service.
+**(2)** Diagnostic data is analyzed by the Microsoft Telemetry Service.
+**(3)** Diagnostic data is pushed from the Microsoft Telemetry Service to your Azure Portal workspace.
+**(4)** Diagnostic data is available in the Device Health solution.
+**(5)** You are now able to proactively monitor Device Health issues in your environment.
+ +These steps are illustrated in following diagram: + + [![](images/analytics-architecture.png)](images/analytics-architecture.png) + +>[!NOTE] +>This process assumes that Windows diagnostic data is enabled and data sharing is enabled as described in [Enrolling devices in Windows Analytics](windows-analytics-get-started.md). + + + +  +## Related topics + +[Get started with Device Health](device-health-get-started.md) + +[Use Device Health to monitor frequency and causes of device crashes](device-health-using.md) + +For the latest information on Windows Analytics, including new features and usage tips, see the [Windows Analytics blog](https://blogs.technet.microsoft.com/upgradeanalytics) diff --git a/windows/deployment/update/device-health-using.md b/windows/deployment/update/device-health-using.md index d2d9086345..40bc6d5423 100644 --- a/windows/deployment/update/device-health-using.md +++ b/windows/deployment/update/device-health-using.md @@ -17,6 +17,9 @@ ms.topic: article # Using Device Health +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + This section describes how to use Device Health to monitor devices deployed on your network and troubleshoot the causes if they crash. diff --git a/windows/deployment/upgrade/upgrade-readiness-additional-insights.md b/windows/deployment/upgrade/upgrade-readiness-additional-insights.md index c6c73aa23e..f1a72fa482 100644 --- a/windows/deployment/upgrade/upgrade-readiness-additional-insights.md +++ b/windows/deployment/upgrade/upgrade-readiness-additional-insights.md @@ -2,17 +2,20 @@ title: Upgrade Readiness - Additional insights ms.reviewer: manager: laurawi -ms.author: greglin +ms.author: jaimeo description: Explains additional features of Upgrade Readiness. ms.prod: w10 audience: itpro -author: greg-lindsay +author: jaimeo ms.topic: article ms.collection: M365-analytics --- # Upgrade Readiness - Additional insights +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + This topic provides information on additional features that are available in Upgrade Readiness to provide insights into your environment. These include: - [Site discovery](#site-discovery): An inventory of web sites that are accessed by client computers running Windows 7, Windows 8.1, or Windows 10 using Internet Explorer. diff --git a/windows/deployment/upgrade/upgrade-readiness-architecture.md b/windows/deployment/upgrade/upgrade-readiness-architecture.md index e5d5a0d480..1cfc2e4bc8 100644 --- a/windows/deployment/upgrade/upgrade-readiness-architecture.md +++ b/windows/deployment/upgrade/upgrade-readiness-architecture.md @@ -1,35 +1,39 @@ ---- -title: Upgrade Readiness architecture (Windows 10) -ms.reviewer: -manager: laurawi -ms.author: greglin -description: Describes Upgrade Readiness architecture. -ms.prod: w10 -audience: itpro author: greg-lindsay -ms.topic: article -ms.collection: M365-analytics ---- - -# Upgrade Readiness architecture - -Microsoft analyzes system, application, and driver diagnostic data to help you determine when computers are upgrade-ready, allowing you to simplify and accelerate Windows upgrades in your organization. The diagram below illustrates how Upgrade Readiness components work together in a typical installation. - - - -![Upgrade Readiness architecture](../images/ur-arch-diagram.png) - -After you enable Windows diagnostic data on user computers and install the compatibility update KB (1), user computers send computer, application and driver diagnostic data to a secure Microsoft data center through the Microsoft Data Management Service (2). After you configure Upgrade Readiness, diagnostic data is analyzed by the Upgrade Readiness Service (3) and pushed to your workspace (4). You can then use the Upgrade Readiness solution (5) to plan and manage Windows upgrades. - -For more information about what diagnostic data Microsoft collects and how that data is used and protected by Microsoft, see: - -[Configure Windows diagnostic data in your organization](/windows/configuration/configure-windows-diagnostic-data-in-your-organization)
-[Manage connections from Windows operating system components to Microsoft services](/windows/configuration/manage-connections-from-windows-operating-system-components-to-microsoft-services)
-[Windows 7, Windows 8, and Windows 8.1 appraiser diagnostic data events and fields](https://go.microsoft.com/fwlink/?LinkID=822965)
- -## **Related topics** - -[Upgrade Readiness requirements](upgrade-readiness-requirements.md)
-[Upgrade Readiness release notes](upgrade-readiness-requirements.md#important-information-about-this-release)
-[Get started with Upgrade Readiness](upgrade-readiness-get-started.md)
+--- +title: Upgrade Readiness architecture (Windows 10) +ms.reviewer: +manager: laurawi +ms.author: jaimeo +description: Describes Upgrade Readiness architecture. +ms.prod: w10 +audience: itpro +author: jaimeo +ms.topic: article +ms.collection: M365-analytics +--- + +# Upgrade Readiness architecture + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +Microsoft analyzes system, application, and driver diagnostic data to help you determine when computers are upgrade-ready, allowing you to simplify and accelerate Windows upgrades in your organization. The diagram below illustrates how Upgrade Readiness components work together in a typical installation. + + + +![Upgrade Readiness architecture](../images/ur-arch-diagram.png) + +After you enable Windows diagnostic data on user computers and install the compatibility update KB (1), user computers send computer, application and driver diagnostic data to a secure Microsoft data center through the Microsoft Data Management Service (2). After you configure Upgrade Readiness, diagnostic data is analyzed by the Upgrade Readiness Service (3) and pushed to your workspace (4). You can then use the Upgrade Readiness solution (5) to plan and manage Windows upgrades. + +For more information about what diagnostic data Microsoft collects and how that data is used and protected by Microsoft, see: + +[Configure Windows diagnostic data in your organization](/windows/configuration/configure-windows-diagnostic-data-in-your-organization)
+[Manage connections from Windows operating system components to Microsoft services](/windows/configuration/manage-connections-from-windows-operating-system-components-to-microsoft-services)
+[Windows 7, Windows 8, and Windows 8.1 appraiser diagnostic data events and fields](https://go.microsoft.com/fwlink/?LinkID=822965)
+ +## **Related topics** + +[Upgrade Readiness requirements](upgrade-readiness-requirements.md)
+[Upgrade Readiness release notes](upgrade-readiness-requirements.md#important-information-about-this-release)
+[Get started with Upgrade Readiness](upgrade-readiness-get-started.md)
diff --git a/windows/deployment/upgrade/upgrade-readiness-data-sharing.md b/windows/deployment/upgrade/upgrade-readiness-data-sharing.md index 0bbda9f3df..ec3030e57f 100644 --- a/windows/deployment/upgrade/upgrade-readiness-data-sharing.md +++ b/windows/deployment/upgrade/upgrade-readiness-data-sharing.md @@ -1,57 +1,61 @@ ---- -title: Upgrade Readiness data sharing -ms.reviewer: -manager: laurawi -ms.author: greglin -description: Connectivity scenarios for data sharing with Upgrade Readiness -ms.prod: w10 -ms.mktglfcycl: deploy -ms.sitesec: library -ms.pagetype: deploy -audience: itpro author: greg-lindsay -ms.topic: article -ms.collection: M365-analytics ---- - -# Upgrade Readiness data sharing - -To enable data sharing with the Upgrade Readiness solution, double-check the endpoints list in [Enrolling devices in Windows Analytics](../update/windows-analytics-get-started.md#enable-data-sharing) to be sure they are whitelisted. - -## Connectivity to the Internet - -There are several different methods your organization can use to connect to the Internet, and these methods can affect how authentication is performed by the deployment script. - -### Direct connection to the Internet - -This scenario is very simple since there is no proxy involved. If you are using a network firewall which is blocking outgoing traffic, please keep in mind that even though we provide DNS names for the endpoints needed to communicate to the Microsoft diagnostic data backend, We therefore do not recommend to attempt to whitelist endpoints on your firewall based on IP-addresses. - -In order to use the direct connection scenario, set the parameter **ClientProxy=Direct** in **runconfig.bat**. - -### Connection through the WinHTTP proxy - -This is the first and most simple proxy scenario. The WinHTTP stack was designed for use in services and does not support proxy autodetection, PAC scripts or authentication. - -In order to set the WinHTTP proxy system-wide on your computers, you need to -- Use the command netsh winhttp set proxy \:\ -- Set ClientProxy=System in runconfig.bat - -The WinHTTP scenario is most appropriate for customers who use a single proxy. If you have more advanced proxy requirements, refer to Scenario 3. - -If you want to learn more about proxy considerations on Windows, see [Understanding Web Proxy Configuration](https://blogs.msdn.microsoft.com/ieinternals/2013/10/11/understanding-web-proxy-configuration/). - -### Logged-in user’s Internet connection - -In order to accommodate complex proxy scenarios, we also support using the currently logged-in user’s internet connection. This scenario supports PAC scripts, proxy autodetection and authentication. Essentially, if the logged in user can reach the Windows diagnostic data endpoints, the diagnostic data client can send data. If runconfig.bat runs while no user is logged in, diagnostic data events get written into a buffer which gets flushed when a user logs in. - -In order to enable this scenario, you need: -- A current quality update Rollup for Windows 7, 8.1 or Windows 10 Version 1511. Updates shipped after October 2016 have the needed code -- Set the reg key HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\DataCollection\DisableEnterpriseAuthProxy to 0. If the value does not exist, create a new DWORD, name it DisableEnterpriseAuthProxy and set the value to 0. The deployment script will check this is configured correctly. -- Set ClientProxy=User in bat. - -> [!IMPORTANT] -> Using **Logged-in user's internet connection** with **DisableEnterpriseAuthProxy = 0** scenario is incompatible with ATP where the required value of that attribute is 1.(Read more here)[] - - - - - +--- +title: Upgrade Readiness data sharing +ms.reviewer: +manager: laurawi +ms.author: jaimeo +description: Connectivity scenarios for data sharing with Upgrade Readiness +ms.prod: w10 +ms.mktglfcycl: deploy +ms.sitesec: library +ms.pagetype: deploy +audience: itpro +author: jaimeo +ms.topic: article +ms.collection: M365-analytics +--- + +# Upgrade Readiness data sharing + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +To enable data sharing with the Upgrade Readiness solution, double-check the endpoints list in [Enrolling devices in Windows Analytics](../update/windows-analytics-get-started.md#enable-data-sharing) to be sure they are whitelisted. + +## Connectivity to the Internet + +There are several different methods your organization can use to connect to the Internet, and these methods can affect how authentication is performed by the deployment script. + +### Direct connection to the Internet + +This scenario is very simple since there is no proxy involved. If you are using a network firewall which is blocking outgoing traffic, please keep in mind that even though we provide DNS names for the endpoints needed to communicate to the Microsoft diagnostic data backend, We therefore do not recommend to attempt to whitelist endpoints on your firewall based on IP-addresses. + +In order to use the direct connection scenario, set the parameter **ClientProxy=Direct** in **runconfig.bat**. + +### Connection through the WinHTTP proxy + +This is the first and most simple proxy scenario. The WinHTTP stack was designed for use in services and does not support proxy autodetection, PAC scripts or authentication. + +In order to set the WinHTTP proxy system-wide on your computers, you need to +- Use the command netsh winhttp set proxy \:\ +- Set ClientProxy=System in runconfig.bat + +The WinHTTP scenario is most appropriate for customers who use a single proxy. If you have more advanced proxy requirements, refer to Scenario 3. + +If you want to learn more about proxy considerations on Windows, see [Understanding Web Proxy Configuration](https://blogs.msdn.microsoft.com/ieinternals/2013/10/11/understanding-web-proxy-configuration/). + +### Logged-in user’s Internet connection + +In order to accommodate complex proxy scenarios, we also support using the currently logged-in user’s internet connection. This scenario supports PAC scripts, proxy autodetection and authentication. Essentially, if the logged in user can reach the Windows diagnostic data endpoints, the diagnostic data client can send data. If runconfig.bat runs while no user is logged in, diagnostic data events get written into a buffer which gets flushed when a user logs in. + +In order to enable this scenario, you need: +- A current quality update Rollup for Windows 7, 8.1 or Windows 10 Version 1511. Updates shipped after October 2016 have the needed code +- Set the reg key HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows\DataCollection\DisableEnterpriseAuthProxy to 0. If the value does not exist, create a new DWORD, name it DisableEnterpriseAuthProxy and set the value to 0. The deployment script will check this is configured correctly. +- Set ClientProxy=User in bat. + +> [!IMPORTANT] +> Using **Logged-in user's internet connection** with **DisableEnterpriseAuthProxy = 0** scenario is incompatible with ATP where the required value of that attribute is 1.(Read more here)[] + + + + + diff --git a/windows/deployment/upgrade/upgrade-readiness-deploy-windows.md b/windows/deployment/upgrade/upgrade-readiness-deploy-windows.md index b097017757..e11b66977e 100644 --- a/windows/deployment/upgrade/upgrade-readiness-deploy-windows.md +++ b/windows/deployment/upgrade/upgrade-readiness-deploy-windows.md @@ -1,102 +1,106 @@ ---- -title: Upgrade Readiness - Get a list of computers that are upgrade ready (Windows 10) -ms.reviewer: -manager: laurawi -ms.author: greglin -description: Describes how to get a list of computers that are ready to be upgraded in Upgrade Readiness. -ms.prod: w10 -audience: itpro author: greg-lindsay -ms.topic: article -ms.collection: M365-analytics ---- - -# Upgrade Readiness - Step 3: Deploy Windows - -All of your work up to now involved reviewing and resolving application and driver issues. Along the way, as you’ve resolved issues and decided which applications and drivers are ready to upgrade, you’ve been building a list of computers that are upgrade ready. -The blades in the **Deploy** section are: - -- [Deploy eligible computers](#deploy-eligible-computers) -- [Deploy computers by group](#computer-groups) - ->Computers that are listed in this step are assigned an **UpgradeDecision** value, and the total count of computers in each upgrade decision category is displayed. Additionally, computers are assigned an **UpgradeAssessment** value. This value is displayed by drilling down into a specific upgrade decision category. For information about upgrade assessment values, see [Upgrade assessment](#upgrade-assessment). - -## Deploy eligible computers - -In this blade, computers grouped by upgrade decision are listed. The upgrade decision on the machines is a calculated value based on the upgrade decision status for the apps and drivers installed on the computer. This value cannot be modified directly. The upgrade decision is calculated in the following ways: -- **Review in progress**: At least one app or driver installed on the computer is marked **Review in progress**. -- **Ready to upgrade**: All apps and drivers installed on the computer are marked as **Ready to Upgrade**. -- **Won’t upgrade**: At least one app or driver installed on the computer is marked as **Won’t upgrade**, or a system requirement is not met. - - - -![Deploy eligible computers](../images/ua-cg-16.png) - -Select **Export computers** for more details, including computer name, manufacturer and model, and Windows edition currently running on the computer. Sort or further query the data and then select **Export** to generate and save a comma-separated value (csv) list of upgrade-ready computers. - ->**Important**
When viewing inventory items in table view, the maximum number of rows that can be viewed and exported is limited to 5,000. If you need to view or export more than 5,000 items, reduce the scope of the query so you can export fewer items at a time. - -## Computer groups - -Computer groups allow you to segment your environment by creating device groups based on log search results, or by importing groups from Active Directory, WSUS or System Center Configuration Manager. Computer groups are an OMS feature. For more information, see [Computer groups in OMS](https://blogs.technet.microsoft.com/msoms/2016/04/04/computer-groups-in-oms/). - -Query based computer groups are recommended in the initial release of this feature. A feature known as **Configuration Manager Upgrade Readiness Connector** is anticipated in a future release that will enable synchronization of **ConfigMgr Collections** with computer groups in OMS. - -### Getting started with Computer Groups - -When you sign in to OMS, you will see a new blade entitled **Computer Groups**. See the following example: - -![Computer groups](../images/ua-cg-01.png) - -To create a computer group, open **Log Search** and create a query based on **Type=UAComputer**, for example: - -``` -Type=UAComputer Manufacturer=DELL -``` - -![Computer groups](../images/ua-cg-02.png) - -When you are satisfied that the query is returning the intended results, add the following text to your search: - -``` -| measure count() by Computer -``` - -This will ensure every computer only shows up once. Then, save your group by clicking **Save** and **Yes**. See the following example: - -![Computer groups](../images/ua-cg-03.png) - -Your new computer group will now be available in Upgrade Readiness. See the following example: - -![Computer groups](../images/ua-cg-04.png) - -### Using Computer Groups - -When you drill into a computer group, you will see that computers are categorized by **UpgradeDecision**. For computers with the status **Review in progress** or **Won’t upgrade** you can drill down to view issues that cause a computer to be in each category, or you can simply display a list of the computers in the category. For computers that are designated **Ready to upgrade**, you can go directly to the list of computers that are ready. - -![Computer groups](../images/ua-cg-05.png) - -Viewing a list of computers in a certain status is self-explanatory, Let’s look at what happens when you click the details link on **Review in progress**: - -![Computer groups](../images/ua-cg-06.png) - -Next, select if you want to see application issues (**UAApp**) or driver issues (**UADriver**). See the following example of selecting **UAApp**: - -![Computer groups](../images/ua-cg-07.png) - -A list of apps that require review so that Dell Computers are ready for upgrade to Windows 10 is displayed. - -### Upgrade assessment - -Upgrade assessment and guidance details are explained in the following table. - -| Upgrade assessment | Action required before or after upgrade pilot? | Issue | What it means | Guidance | -|-----------------------|------------------------------------------------|----------|-----------------|---------------| -| No known issues | No | None | Computers will upgrade seamlessly.
| OK to use as-is in pilot. | -| OK to pilot, fixed during upgrade | No, for awareness only | Application or driver will not migrate to new OS | The currently installed version of an application or driver won’t migrate to the new operating system; however, a compatible version is installed with the new operating system. | OK to use as-is in pilot. | -| OK to pilot with new driver from Windows Update | Yes | Driver will not migrate to new OS | The currently installed version of a driver won’t migrate to the new operating system; however, a newer, compatible version is available from Windows Update. | Although a compatible version of the driver is installed during upgrade, a newer version is available from Windows Update.

If the computer automatically receives updates from Windows Update, no action is required. Otherwise, replace the new in-box driver with the Windows Update version after upgrading.

| - -Select **Export computers** to view pilot-ready computers organized by operating system. After you select the computers you want to use in a pilot, click Export to generate and save a comma-separated value (csv) file. - ->**Important**> When viewing inventory items in table view, the maximum number of rows that can be viewed and exported is limited to 5,000. If you need to view or export more than 5,000 items, reduce the scope of the query so you can export fewer items at a time. +--- +title: Upgrade Readiness - Get a list of computers that are upgrade ready (Windows 10) +ms.reviewer: +manager: laurawi +ms.author: jaimeo +description: Describes how to get a list of computers that are ready to be upgraded in Upgrade Readiness. +ms.prod: w10 +audience: itpro +author: jaimeo +ms.topic: article +ms.collection: M365-analytics +--- + +# Upgrade Readiness - Step 3: Deploy Windows + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +All of your work up to now involved reviewing and resolving application and driver issues. Along the way, as you’ve resolved issues and decided which applications and drivers are ready to upgrade, you’ve been building a list of computers that are upgrade ready. +The blades in the **Deploy** section are: + +- [Deploy eligible computers](#deploy-eligible-computers) +- [Deploy computers by group](#computer-groups) + +>Computers that are listed in this step are assigned an **UpgradeDecision** value, and the total count of computers in each upgrade decision category is displayed. Additionally, computers are assigned an **UpgradeAssessment** value. This value is displayed by drilling down into a specific upgrade decision category. For information about upgrade assessment values, see [Upgrade assessment](#upgrade-assessment). + +## Deploy eligible computers + +In this blade, computers grouped by upgrade decision are listed. The upgrade decision on the machines is a calculated value based on the upgrade decision status for the apps and drivers installed on the computer. This value cannot be modified directly. The upgrade decision is calculated in the following ways: +- **Review in progress**: At least one app or driver installed on the computer is marked **Review in progress**. +- **Ready to upgrade**: All apps and drivers installed on the computer are marked as **Ready to Upgrade**. +- **Won’t upgrade**: At least one app or driver installed on the computer is marked as **Won’t upgrade**, or a system requirement is not met. + + + +![Deploy eligible computers](../images/ua-cg-16.png) + +Select **Export computers** for more details, including computer name, manufacturer and model, and Windows edition currently running on the computer. Sort or further query the data and then select **Export** to generate and save a comma-separated value (csv) list of upgrade-ready computers. + +>**Important**
When viewing inventory items in table view, the maximum number of rows that can be viewed and exported is limited to 5,000. If you need to view or export more than 5,000 items, reduce the scope of the query so you can export fewer items at a time. + +## Computer groups + +Computer groups allow you to segment your environment by creating device groups based on log search results, or by importing groups from Active Directory, WSUS or System Center Configuration Manager. Computer groups are an OMS feature. For more information, see [Computer groups in OMS](https://blogs.technet.microsoft.com/msoms/2016/04/04/computer-groups-in-oms/). + +Query based computer groups are recommended in the initial release of this feature. A feature known as **Configuration Manager Upgrade Readiness Connector** is anticipated in a future release that will enable synchronization of **ConfigMgr Collections** with computer groups in OMS. + +### Getting started with Computer Groups + +When you sign in to OMS, you will see a new blade entitled **Computer Groups**. See the following example: + +![Computer groups](../images/ua-cg-01.png) + +To create a computer group, open **Log Search** and create a query based on **Type=UAComputer**, for example: + +``` +Type=UAComputer Manufacturer=DELL +``` + +![Computer groups](../images/ua-cg-02.png) + +When you are satisfied that the query is returning the intended results, add the following text to your search: + +``` +| measure count() by Computer +``` + +This will ensure every computer only shows up once. Then, save your group by clicking **Save** and **Yes**. See the following example: + +![Computer groups](../images/ua-cg-03.png) + +Your new computer group will now be available in Upgrade Readiness. See the following example: + +![Computer groups](../images/ua-cg-04.png) + +### Using Computer Groups + +When you drill into a computer group, you will see that computers are categorized by **UpgradeDecision**. For computers with the status **Review in progress** or **Won’t upgrade** you can drill down to view issues that cause a computer to be in each category, or you can simply display a list of the computers in the category. For computers that are designated **Ready to upgrade**, you can go directly to the list of computers that are ready. + +![Computer groups](../images/ua-cg-05.png) + +Viewing a list of computers in a certain status is self-explanatory, Let’s look at what happens when you click the details link on **Review in progress**: + +![Computer groups](../images/ua-cg-06.png) + +Next, select if you want to see application issues (**UAApp**) or driver issues (**UADriver**). See the following example of selecting **UAApp**: + +![Computer groups](../images/ua-cg-07.png) + +A list of apps that require review so that Dell Computers are ready for upgrade to Windows 10 is displayed. + +### Upgrade assessment + +Upgrade assessment and guidance details are explained in the following table. + +| Upgrade assessment | Action required before or after upgrade pilot? | Issue | What it means | Guidance | +|-----------------------|------------------------------------------------|----------|-----------------|---------------| +| No known issues | No | None | Computers will upgrade seamlessly.
| OK to use as-is in pilot. | +| OK to pilot, fixed during upgrade | No, for awareness only | Application or driver will not migrate to new OS | The currently installed version of an application or driver won’t migrate to the new operating system; however, a compatible version is installed with the new operating system. | OK to use as-is in pilot. | +| OK to pilot with new driver from Windows Update | Yes | Driver will not migrate to new OS | The currently installed version of a driver won’t migrate to the new operating system; however, a newer, compatible version is available from Windows Update. | Although a compatible version of the driver is installed during upgrade, a newer version is available from Windows Update.

If the computer automatically receives updates from Windows Update, no action is required. Otherwise, replace the new in-box driver with the Windows Update version after upgrading.

| + +Select **Export computers** to view pilot-ready computers organized by operating system. After you select the computers you want to use in a pilot, click Export to generate and save a comma-separated value (csv) file. + +>**Important**> When viewing inventory items in table view, the maximum number of rows that can be viewed and exported is limited to 5,000. If you need to view or export more than 5,000 items, reduce the scope of the query so you can export fewer items at a time. diff --git a/windows/deployment/upgrade/upgrade-readiness-deployment-script.md b/windows/deployment/upgrade/upgrade-readiness-deployment-script.md index 8ad77cca4e..f96cbdb0e3 100644 --- a/windows/deployment/upgrade/upgrade-readiness-deployment-script.md +++ b/windows/deployment/upgrade/upgrade-readiness-deployment-script.md @@ -2,20 +2,23 @@ title: Upgrade Readiness deployment script (Windows 10) ms.reviewer: manager: laurawi -ms.author: greglin +ms.author: jaimeo description: Deployment script for Upgrade Readiness. ms.prod: w10 ms.mktglfcycl: deploy ms.sitesec: library ms.pagetype: deploy audience: itpro -author: greg-lindsay +author: jaimeo ms.topic: article ms.collection: M365-analytics --- # Upgrade Readiness deployment script +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + To automate the steps provided in [Get started with Upgrade Readiness](upgrade-readiness-get-started.md), and to troubleshoot data sharing issues, you can run the [Upgrade Readiness deployment script](https://go.microsoft.com/fwlink/?LinkID=822966&clcid=0x409), developed by Microsoft. >[!IMPORTANT] diff --git a/windows/deployment/upgrade/upgrade-readiness-identify-apps.md b/windows/deployment/upgrade/upgrade-readiness-identify-apps.md index 4c4477de3c..3cddd6a4a7 100644 --- a/windows/deployment/upgrade/upgrade-readiness-identify-apps.md +++ b/windows/deployment/upgrade/upgrade-readiness-identify-apps.md @@ -1,41 +1,45 @@ ---- -title: Upgrade Readiness - Identify important apps (Windows 10) -ms.reviewer: -manager: laurawi -ms.author: greglin -description: Describes how to prepare your environment so that you can use Upgrade Readiness to manage Windows upgrades. -ms.prod: w10 -audience: itpro author: greg-lindsay -ms.topic: article -ms.collection: M365-analytics ---- - -# Upgrade Readiness - Step 1: Identify important apps - -This is the first step of the Upgrade Readiness workflow. In this step, applications are listed and grouped by importance level. Setting the importance level enables you to prioritize applications for upgrade. - - - -![Prioritize applications](../images/upgrade-analytics-prioritize.png) - -Select **Assign importance** to change an application’s importance level. By default, applications are marked **Not reviewed** or **Low install count** until you assign a different importance level to them. - -To change an application’s importance level: - -1. Select **Not reviewed** or **Low install count** on the **Prioritize applications** blade to view the list of applications with that importance level. -2. Select the applications you want to change to a specific importance level and then select the appropriate option from the **Select importance level** list. -3. Click **Save** when finished. - -Importance levels include: - -| Importance level | When to use it | Recommendation | -|--------------------|------------------|------------------| -| Low install count | We give you a head start by identifying applications that are installed on 2% or less of your total computer inventory. \[Number of computers application is installed on/total number of computers in your inventory.\]

Low install count applications are automatically marked as **Ready to upgrade** in the **UpgradeDecision** column unless they have issues that need attention.
| Be sure to review low install count applications for any business critical or important applications that are not yet upgrade-ready, despite their low installation rates. For example, payroll apps or tax accounting apps tend to be installed on a relatively small number of machines but are still considered business critical applications.

| -| Not reviewed | Applications that are installed on more than 2% of your total computer inventory are marked not reviewed until you set their importance level.

| Once you’ve started to investigate an application to determine its importance level and upgrade readiness, change its status to **Review in progress** in both the **Importance** and **UpgradeDecision** columns. | -| Business critical | By default, no applications are marked as business critical because only you can make that determination. If you know that an application is critical to your organization’s functioning, mark it **Business critical**.

| You may also want to change the application’s status to **Review in progress** in the **UpgradeDecision** column to let other team members know that you’re working on getting this business critical application upgrade-ready. Once you’ve fixed any issues and validated that the application will migrate successfully, change the upgrade decision to **Ready to upgrade**.
| -| Important | By default, no applications are marked as important because only you can make that determination. If the application is important but not critical to your organization’s functioning, mark it **Important**. | You may also want to change the application’s status to **Review in progress** in the **UpgradeDecision** column to let other team members know that you’re working on getting this important application upgrade-ready. Once you’ve fixed any issues and validated that the application will migrate successfully, change the upgrade decision to **Ready to upgrade**.
| -| Ignore | By default, no applications are marked as ignore because only you can make that determination. If the application is not important to your organization’s functioning, such as user-installed applications and games, you may not want to spend time and money validating that these applications will migrate successfully. Mark these applications **Ignore**.
| Set the application’s importance level to **Ignore** to let other team members know that it can be left as-is with no further investigation or testing. If you set the importance level to ignore, and this is an app that you are not planning on testing or validating, consider changing the upgrade decision to **Ready to upgrade**. By marking these apps ready to upgrade, you are indicating that you are comfortable upgrading with the app remaining in its current state.

| -| Review in progress | Once you’ve started to investigate an application to determine its importance level and upgrade readiness, change its status to **Review in progress** in both the **Importance** and **UpgradeDecision** columns.
| As you learn more about the application’s importance to your organization’s functioning, change the importance level to **Business critical**, **Important**, or **Ignore**.

Until you’ve determined that priority applications will migrate successfully, leave the upgrade decision status as **Review in progress**.
| - +--- +title: Upgrade Readiness - Identify important apps (Windows 10) +ms.reviewer: +manager: laurawi +ms.author: jaimeo +description: Describes how to prepare your environment so that you can use Upgrade Readiness to manage Windows upgrades. +ms.prod: w10 +audience: itpro +author: jaimeo +ms.topic: article +ms.collection: M365-analytics +--- + +# Upgrade Readiness - Step 1: Identify important apps + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +This is the first step of the Upgrade Readiness workflow. In this step, applications are listed and grouped by importance level. Setting the importance level enables you to prioritize applications for upgrade. + + + +![Prioritize applications](../images/upgrade-analytics-prioritize.png) + +Select **Assign importance** to change an application’s importance level. By default, applications are marked **Not reviewed** or **Low install count** until you assign a different importance level to them. + +To change an application’s importance level: + +1. Select **Not reviewed** or **Low install count** on the **Prioritize applications** blade to view the list of applications with that importance level. +2. Select the applications you want to change to a specific importance level and then select the appropriate option from the **Select importance level** list. +3. Click **Save** when finished. + +Importance levels include: + +| Importance level | When to use it | Recommendation | +|--------------------|------------------|------------------| +| Low install count | We give you a head start by identifying applications that are installed on 2% or less of your total computer inventory. \[Number of computers application is installed on/total number of computers in your inventory.\]

Low install count applications are automatically marked as **Ready to upgrade** in the **UpgradeDecision** column unless they have issues that need attention.
| Be sure to review low install count applications for any business critical or important applications that are not yet upgrade-ready, despite their low installation rates. For example, payroll apps or tax accounting apps tend to be installed on a relatively small number of machines but are still considered business critical applications.

| +| Not reviewed | Applications that are installed on more than 2% of your total computer inventory are marked not reviewed until you set their importance level.

| Once you’ve started to investigate an application to determine its importance level and upgrade readiness, change its status to **Review in progress** in both the **Importance** and **UpgradeDecision** columns. | +| Business critical | By default, no applications are marked as business critical because only you can make that determination. If you know that an application is critical to your organization’s functioning, mark it **Business critical**.

| You may also want to change the application’s status to **Review in progress** in the **UpgradeDecision** column to let other team members know that you’re working on getting this business critical application upgrade-ready. Once you’ve fixed any issues and validated that the application will migrate successfully, change the upgrade decision to **Ready to upgrade**.
| +| Important | By default, no applications are marked as important because only you can make that determination. If the application is important but not critical to your organization’s functioning, mark it **Important**. | You may also want to change the application’s status to **Review in progress** in the **UpgradeDecision** column to let other team members know that you’re working on getting this important application upgrade-ready. Once you’ve fixed any issues and validated that the application will migrate successfully, change the upgrade decision to **Ready to upgrade**.
| +| Ignore | By default, no applications are marked as ignore because only you can make that determination. If the application is not important to your organization’s functioning, such as user-installed applications and games, you may not want to spend time and money validating that these applications will migrate successfully. Mark these applications **Ignore**.
| Set the application’s importance level to **Ignore** to let other team members know that it can be left as-is with no further investigation or testing. If you set the importance level to ignore, and this is an app that you are not planning on testing or validating, consider changing the upgrade decision to **Ready to upgrade**. By marking these apps ready to upgrade, you are indicating that you are comfortable upgrading with the app remaining in its current state.

| +| Review in progress | Once you’ve started to investigate an application to determine its importance level and upgrade readiness, change its status to **Review in progress** in both the **Importance** and **UpgradeDecision** columns.
| As you learn more about the application’s importance to your organization’s functioning, change the importance level to **Business critical**, **Important**, or **Ignore**.

Until you’ve determined that priority applications will migrate successfully, leave the upgrade decision status as **Review in progress**.
| + diff --git a/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md b/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md index 1aee2eb281..dae35a58e1 100644 --- a/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md +++ b/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md @@ -1,51 +1,55 @@ ---- -title: Monitor deployment with Upgrade Readiness -ms.reviewer: -manager: laurawi -description: Describes how to use Upgrade Readiness to monitor the deployment after Windows upgrades. -keywords: windows analytics, oms, operations management suite, prerequisites, requirements, upgrades, log analytics, -ms.localizationpriority: medium -ms.prod: w10 -audience: itpro author: greg-lindsay -ms.author: greglin -ms.topic: article -ms.collection: M365-analytics ---- - -# Upgrade Readiness - Step 4: Monitor - -Now that you have started deploying an update with Upgrade Readiness, you can use it to monitor important elements. - -![Upgrade Readiness dialog showing "STEP 4: Monitor" and blades for "Update progress," "Driver issues," and "User feedback"](../images/UR-monitor-main.png) - - -## Update progress - -The **Update progress** blade allows you to monitor the progress and status of your deployment. Any device that has attepted to upgrade in the last 30 days displays the **DeploymentStatus** attribute. You'll be able to see the number of computers that have successfully upgraded, failed to upgrade, are stalled, etc. - - -Selecting this blade allows you to view device-level details about the deployment. For example, select **Failed** to view the original operating system version, the target operating system version, and the reason the update failed for each of the devices that failed to upgrade. In the case of the device illustrated in the following image, an attempt was made to upgrade from Windows 10, version 1703 to 1709, but the operation timed out. - -!["Update progress" blade showing detailed information after selecting the "failed" item](../images/UR-update-progress-failed-detail.png) - - -## Driver issues - -The **Driver issues** blade allows you to see Device Manager errors for your upgraded devices. We include data for all compatibility-related device errors, such as "driver not found" and "driver not started." The blade summarizes errors by error type, but you can select a particular error type to see device-level details about which device(s) are failing and where to obtain a driver. - - -For example, by selecting error code **28 - driver not installed**, you would see that the device in the following image is missing the driver for a network controller. Upgrade Readiness also notifies that a suitable driver is available online through Windows Update. If this device is configured to automatically receive updates from Windows Update, this issue would likely resolve itself following the device's next Windows Update scan. If this device does not automatically receive updates from Windows Update, you would need to deliver the driver manually. - -!["Driver issue" blade showing detailed information after selecting a specific driver error](../images/UR-driver-issue-detail.png) - -## User feedback - -The **User Feedback** blade focuses on gathering subjective feedback from your end users. If a user submits feedback through the Feedback Hub app on a device in your workspace, we will make that feedback visible to you in this blade. The Feedback Hub app is built into Windows 10 and can be accessed by typing "Feedback Hub" in the Cortana search bar. - - -We recommend that you encourage your end users to submit any feedback they have through Feedback Hub. Not only will this feedback be sent directly to Microsoft for review, but you'll also be able to see it by using Upgrade Readiness. You should be aware that **feedback submitted through Feedback Hub will be publicly visible**, so it's best to avoid submitting feedback about internal line-of-business applications. - -When viewing user feedback in Upgrade Readiness, you'll be able to see the raw "Title" and "Feedback" text from the user's submission in Feedback Hub, as well as the number of upvotes the submission has received. (Since feedback is publicly visible, the number of upvotes is a global value and not specific to your company.) If a Microsoft engineer has responded to the submission in Feedback Hub, we'll pull in the Microsoft response for you to see as well. - -![Example user feedback item](../images/UR-example-feedback.png) - +--- +title: Monitor deployment with Upgrade Readiness +ms.reviewer: +manager: laurawi +description: Describes how to use Upgrade Readiness to monitor the deployment after Windows upgrades. +keywords: windows analytics, oms, operations management suite, prerequisites, requirements, upgrades, log analytics, +ms.localizationpriority: medium +ms.prod: w10 +audience: itpro +author: jaimeo +ms.author: jaimeo +ms.topic: article +ms.collection: M365-analytics +--- + +# Upgrade Readiness - Step 4: Monitor + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +Now that you have started deploying an update with Upgrade Readiness, you can use it to monitor important elements. + +![Upgrade Readiness dialog showing "STEP 4: Monitor" and blades for "Update progress," "Driver issues," and "User feedback"](../images/UR-monitor-main.png) + + +## Update progress + +The **Update progress** blade allows you to monitor the progress and status of your deployment. Any device that has attepted to upgrade in the last 30 days displays the **DeploymentStatus** attribute. You'll be able to see the number of computers that have successfully upgraded, failed to upgrade, are stalled, etc. + + +Selecting this blade allows you to view device-level details about the deployment. For example, select **Failed** to view the original operating system version, the target operating system version, and the reason the update failed for each of the devices that failed to upgrade. In the case of the device illustrated in the following image, an attempt was made to upgrade from Windows 10, version 1703 to 1709, but the operation timed out. + +!["Update progress" blade showing detailed information after selecting the "failed" item](../images/UR-update-progress-failed-detail.png) + + +## Driver issues + +The **Driver issues** blade allows you to see Device Manager errors for your upgraded devices. We include data for all compatibility-related device errors, such as "driver not found" and "driver not started." The blade summarizes errors by error type, but you can select a particular error type to see device-level details about which device(s) are failing and where to obtain a driver. + + +For example, by selecting error code **28 - driver not installed**, you would see that the device in the following image is missing the driver for a network controller. Upgrade Readiness also notifies that a suitable driver is available online through Windows Update. If this device is configured to automatically receive updates from Windows Update, this issue would likely resolve itself following the device's next Windows Update scan. If this device does not automatically receive updates from Windows Update, you would need to deliver the driver manually. + +!["Driver issue" blade showing detailed information after selecting a specific driver error](../images/UR-driver-issue-detail.png) + +## User feedback + +The **User Feedback** blade focuses on gathering subjective feedback from your end users. If a user submits feedback through the Feedback Hub app on a device in your workspace, we will make that feedback visible to you in this blade. The Feedback Hub app is built into Windows 10 and can be accessed by typing "Feedback Hub" in the Cortana search bar. + + +We recommend that you encourage your end users to submit any feedback they have through Feedback Hub. Not only will this feedback be sent directly to Microsoft for review, but you'll also be able to see it by using Upgrade Readiness. You should be aware that **feedback submitted through Feedback Hub will be publicly visible**, so it's best to avoid submitting feedback about internal line-of-business applications. + +When viewing user feedback in Upgrade Readiness, you'll be able to see the raw "Title" and "Feedback" text from the user's submission in Feedback Hub, as well as the number of upvotes the submission has received. (Since feedback is publicly visible, the number of upvotes is a global value and not specific to your company.) If a Microsoft engineer has responded to the submission in Feedback Hub, we'll pull in the Microsoft response for you to see as well. + +![Example user feedback item](../images/UR-example-feedback.png) + diff --git a/windows/deployment/upgrade/upgrade-readiness-requirements.md b/windows/deployment/upgrade/upgrade-readiness-requirements.md index 582f5bb732..a6a8d7325a 100644 --- a/windows/deployment/upgrade/upgrade-readiness-requirements.md +++ b/windows/deployment/upgrade/upgrade-readiness-requirements.md @@ -1,76 +1,80 @@ ---- -title: Upgrade Readiness requirements (Windows 10) -ms.reviewer: -manager: laurawi -description: Provides requirements for Upgrade Readiness. -keywords: windows analytics, oms, operations management suite, prerequisites, requirements, upgrades, log analytics, -ms.prod: w10 -audience: itpro author: greg-lindsay -ms.author: greglin -ms.localizationpriority: medium -ms.topic: article -ms.collection: M365-analytics ---- - -# Upgrade Readiness requirements - -This article introduces concepts and steps needed to get up and running with Upgrade Readiness. We recommend that you review this list of requirements before getting started as you may need to collect information, such as account credentials, and get approval from internal IT groups, such as your network security group, before you can start using Upgrade Readiness. - -## Supported upgrade paths - -### Windows 7 and Windows 8.1 - -To perform an in-place upgrade, user computers must be running the latest version of either Windows 7 SP1 or Windows 8.1. After you enable Windows diagnostic data, Upgrade Readiness performs a full inventory of computers so that you can see which version of Windows is installed on each computer. - -The compatibility update that sends diagnostic data from user computers to Microsoft data centers works with Windows 7 SP1 and Windows 8.1 only. Upgrade Readiness cannot evaluate Windows XP or Windows Vista for upgrade eligibility. - - - -If you need to update user computers to Windows 7 SP1 or Windows 8.1, use Windows Update or download and deploy the applicable package from the Microsoft Download Center. - -> [!NOTE] -> Upgrade Readiness is designed to best support in-place upgrades. In-place upgrades do not support migrations from BIOS to UEFI or from 32-bit to 64-bit architecture. If you need to migrate computers in these scenarios, use the wipe-and-reload method. Upgrade Readiness insights are still valuable in this scenario, however, you can ignore in-place upgrade specific guidance. - -See [Windows 10 Specifications](https://www.microsoft.com/windows/windows-10-specifications) for additional information about computer system requirements. - -### Windows 10 - -Keeping Windows 10 up to date involves deploying a feature update, and Upgrade Readiness tools help you prepare and plan for these Windows updates. -The latest cumulative updates must be installed on Windows 10 computers to make sure that the required compatibility updates are installed. You can find the latest cumulative update on the [Microsoft Update Catalog](https://catalog.update.microsoft.com). - -While Upgrade Readiness can be used to assist with updating devices from Windows 10 Long-Term Servicing Channel (LTSC) to Windows 10 Semi-Annual Channel, Upgrade Readiness does not support updates to Windows 10 LTSC. The Long-Term Servicing Channel of Windows 10 is not intended for general deployment, and does not receive feature updates, therefore it is not a supported target with Upgrade Readiness. See [Windows as a service overview](../update/waas-overview.md#long-term-servicing-channel) to understand more about LTSC. - -## Operations Management Suite or Azure Log Analytics - -Upgrade Readiness is offered as a solution in Azure Portal and Azure Log Analytics, a collection of cloud-based services for managing on premises and cloud computing environments. For more information about Azure Portal, see [Windows Analytics in the Azure Portal](../update/windows-analytics-azure-portal.md) or the Azure [Log Analytics overview](https://azure.microsoft.com/services/log-analytics/). - -If you’re already using Azure Portal or Azure Log Analytics, you’ll find Upgrade Readiness in the Solutions Gallery. Click the **Upgrade Readiness** tile in the gallery and then click **Add** on the solution’s details page. Upgrade Readiness is now visible in your workspace. - -If you are not using Azure Portal or Azure Log Analytics, go to [Log Analytics](https://azure.microsoft.com/services/log-analytics/) on Microsoft.com and select **Start free** to start the setup process. During the process, you’ll create a workspace and add the Upgrade Readiness solution to it. - ->[!IMPORTANT] ->You can use either a Microsoft Account or a Work or School account to create a workspace. If your company is already using Azure Active Directory, use a Work or School account when you sign in to Azure Portal. Using a Work or School account allows you to use identities from your Azure AD to manage permissions in Azure Portal. You also need an Azure subscription to link to your Azure Portal workspace. The account you used to create the workspace must have administrator permissions on the Azure subscription in order to link the workspace to the Azure account. Once the link has been established, you can revoke the administrator permissions. - -## System Center Configuration Manager integration - -Upgrade Readiness can be integrated with your installation of Configuration Manager. For more information, see [Integrate Upgrade Readiness with System Center Configuration Manager](https://docs.microsoft.com/sccm/core/clients/manage/upgrade/upgrade-analytics). - - - -## Important information about this release - -Before you get started configuring Upgrade Anatlyics, review the following tips and limitations about this release. - -**Upgrade Readiness does not support on-premises Windows deployments.** Upgrade Readiness is built as a cloud service, which allows Upgrade Readiness to provide you with insights based on the data from user computers and other Microsoft compatibility services. Cloud services are easy to get up and running and are cost-effective because there is no requirement to physically implement and maintain services on-premises. - -**In-region data storage requirements.** Windows diagnostic data from user computers is encrypted, sent to, and processed at Microsoft-managed secure data centers located in the US. Our analysis of the upgrade readiness-related data is then provided to you through the Upgrade Readiness solution in Azure Portal. Upgrade Readiness is supported in all Azure regions; however, selecting an international Azure region does not prevent diagnostic data from being sent to and processed in Microsoft's secure data centers in the US. - -### Tips - -- When viewing inventory items in table view, the maximum number of rows that can be viewed and exported is limited to 5,000. If you need to view or export more than 5,000 items, reduce the scope of the query so you can export a list with fewer items. - -- Sorting data by clicking a column heading may not sort your complete list of items. For information about how to sort data in Azure Portal, see [Sorting DocumentDB data using Order By](https://azure.microsoft.com/documentation/articles/documentdb-orderby). - -## Get started - -See [Get started with Upgrade Readiness](upgrade-readiness-get-started.md) for detailed, step-by-step instructions for configuring Upgrade Readiness and getting started on your Windows upgrade project. +--- +title: Upgrade Readiness requirements (Windows 10) +ms.reviewer: +manager: laurawi +description: Provides requirements for Upgrade Readiness. +keywords: windows analytics, oms, operations management suite, prerequisites, requirements, upgrades, log analytics, +ms.prod: w10 +audience: itpro +author: jaimeo +ms.author: jaimeo +ms.localizationpriority: medium +ms.topic: article +ms.collection: M365-analytics +--- + +# Upgrade Readiness requirements + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +This article introduces concepts and steps needed to get up and running with Upgrade Readiness. We recommend that you review this list of requirements before getting started as you may need to collect information, such as account credentials, and get approval from internal IT groups, such as your network security group, before you can start using Upgrade Readiness. + +## Supported upgrade paths + +### Windows 7 and Windows 8.1 + +To perform an in-place upgrade, user computers must be running the latest version of either Windows 7 SP1 or Windows 8.1. After you enable Windows diagnostic data, Upgrade Readiness performs a full inventory of computers so that you can see which version of Windows is installed on each computer. + +The compatibility update that sends diagnostic data from user computers to Microsoft data centers works with Windows 7 SP1 and Windows 8.1 only. Upgrade Readiness cannot evaluate Windows XP or Windows Vista for upgrade eligibility. + + + +If you need to update user computers to Windows 7 SP1 or Windows 8.1, use Windows Update or download and deploy the applicable package from the Microsoft Download Center. + +> [!NOTE] +> Upgrade Readiness is designed to best support in-place upgrades. In-place upgrades do not support migrations from BIOS to UEFI or from 32-bit to 64-bit architecture. If you need to migrate computers in these scenarios, use the wipe-and-reload method. Upgrade Readiness insights are still valuable in this scenario, however, you can ignore in-place upgrade specific guidance. + +See [Windows 10 Specifications](https://www.microsoft.com/windows/windows-10-specifications) for additional information about computer system requirements. + +### Windows 10 + +Keeping Windows 10 up to date involves deploying a feature update, and Upgrade Readiness tools help you prepare and plan for these Windows updates. +The latest cumulative updates must be installed on Windows 10 computers to make sure that the required compatibility updates are installed. You can find the latest cumulative update on the [Microsoft Update Catalog](https://catalog.update.microsoft.com). + +While Upgrade Readiness can be used to assist with updating devices from Windows 10 Long-Term Servicing Channel (LTSC) to Windows 10 Semi-Annual Channel, Upgrade Readiness does not support updates to Windows 10 LTSC. The Long-Term Servicing Channel of Windows 10 is not intended for general deployment, and does not receive feature updates, therefore it is not a supported target with Upgrade Readiness. See [Windows as a service overview](../update/waas-overview.md#long-term-servicing-channel) to understand more about LTSC. + +## Operations Management Suite or Azure Log Analytics + +Upgrade Readiness is offered as a solution in Azure Portal and Azure Log Analytics, a collection of cloud-based services for managing on premises and cloud computing environments. For more information about Azure Portal, see [Windows Analytics in the Azure Portal](../update/windows-analytics-azure-portal.md) or the Azure [Log Analytics overview](https://azure.microsoft.com/services/log-analytics/). + +If you’re already using Azure Portal or Azure Log Analytics, you’ll find Upgrade Readiness in the Solutions Gallery. Click the **Upgrade Readiness** tile in the gallery and then click **Add** on the solution’s details page. Upgrade Readiness is now visible in your workspace. + +If you are not using Azure Portal or Azure Log Analytics, go to [Log Analytics](https://azure.microsoft.com/services/log-analytics/) on Microsoft.com and select **Start free** to start the setup process. During the process, you’ll create a workspace and add the Upgrade Readiness solution to it. + +>[!IMPORTANT] +>You can use either a Microsoft Account or a Work or School account to create a workspace. If your company is already using Azure Active Directory, use a Work or School account when you sign in to Azure Portal. Using a Work or School account allows you to use identities from your Azure AD to manage permissions in Azure Portal. You also need an Azure subscription to link to your Azure Portal workspace. The account you used to create the workspace must have administrator permissions on the Azure subscription in order to link the workspace to the Azure account. Once the link has been established, you can revoke the administrator permissions. + +## System Center Configuration Manager integration + +Upgrade Readiness can be integrated with your installation of Configuration Manager. For more information, see [Integrate Upgrade Readiness with System Center Configuration Manager](https://docs.microsoft.com/sccm/core/clients/manage/upgrade/upgrade-analytics). + + + +## Important information about this release + +Before you get started configuring Upgrade Anatlyics, review the following tips and limitations about this release. + +**Upgrade Readiness does not support on-premises Windows deployments.** Upgrade Readiness is built as a cloud service, which allows Upgrade Readiness to provide you with insights based on the data from user computers and other Microsoft compatibility services. Cloud services are easy to get up and running and are cost-effective because there is no requirement to physically implement and maintain services on-premises. + +**In-region data storage requirements.** Windows diagnostic data from user computers is encrypted, sent to, and processed at Microsoft-managed secure data centers located in the US. Our analysis of the upgrade readiness-related data is then provided to you through the Upgrade Readiness solution in Azure Portal. Upgrade Readiness is supported in all Azure regions; however, selecting an international Azure region does not prevent diagnostic data from being sent to and processed in Microsoft's secure data centers in the US. + +### Tips + +- When viewing inventory items in table view, the maximum number of rows that can be viewed and exported is limited to 5,000. If you need to view or export more than 5,000 items, reduce the scope of the query so you can export a list with fewer items. + +- Sorting data by clicking a column heading may not sort your complete list of items. For information about how to sort data in Azure Portal, see [Sorting DocumentDB data using Order By](https://azure.microsoft.com/documentation/articles/documentdb-orderby). + +## Get started + +See [Get started with Upgrade Readiness](upgrade-readiness-get-started.md) for detailed, step-by-step instructions for configuring Upgrade Readiness and getting started on your Windows upgrade project. diff --git a/windows/deployment/upgrade/upgrade-readiness-resolve-issues.md b/windows/deployment/upgrade/upgrade-readiness-resolve-issues.md index 6d2a66ecdc..e9dab24950 100644 --- a/windows/deployment/upgrade/upgrade-readiness-resolve-issues.md +++ b/windows/deployment/upgrade/upgrade-readiness-resolve-issues.md @@ -1,216 +1,220 @@ ---- -title: Upgrade Readiness - Resolve application and driver issues (Windows 10) -ms.reviewer: -manager: laurawi -description: Describes how to resolve application and driver issues that can occur during an upgrade with Upgrade Readiness. -keywords: windows analytics, oms, operations management suite, prerequisites, requirements, upgrades, log analytics, -ms.prod: w10 -audience: itpro author: greg-lindsay -ms.author: greglin -ms.localizationpriority: medium -ms.topic: article -ms.collection: M365-analytics ---- - -# Upgrade Readiness - Step 2: Resolve app and driver issues - -This section of the Upgrade Readiness workflow reports application and driver inventory and shows you which applications have known issues, which applications have no known issues, and which drivers have issues. We identify applications and drivers that need attention and suggest fixes when we know about them. - -## In this section - -The blades in the **Step 2: Resolve issues** section are: - -- [Review applications with known issues](#review-applications-with-known-issues) -- [Review known driver issues](#review-drivers-with-known-issues) -- [Review low-risk apps and drivers](#review-low-risk-apps-and-drivers) -- [Prioritize app and driver testing](#prioritize-app-and-driver-testing) - ->You can change an application’s upgrade decision and a driver’s upgrade decision from the blades in this section. To change an application’s or a driver’s importance level, select **User changes**. Select the item you want to change and then select the appropriate option from the **Select upgrade decision** list. - -Upgrade decisions include: - - -| Upgrade decision | When to use it | Guidance | -|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Not reviewed | All drivers are marked as Not reviewed by default.

Any app that has not been marked **Low install count** will also have an upgrade decision of **Not reviewed** by default.
| Apps you have not yet reviewed or are waiting to review later should be marked as **Not reviewed**. When you start to investigate an application or a driver to determine upgrade readiness, change their upgrade decision to **Review in progress**.

| -| Review in progress | When you start to investigate an application or a driver to determine upgrade readiness, change its upgrade decision to **Review in progress**.

Until you’ve determined that applications and drivers will migrate successfully or you’ve resolved blocking issues, leave the upgrade decision status as **Review in progress**.

| Once you’ve fixed any issues and validated that the application or driver will migrate successfully, change the upgrade decision to **Ready to upgrade**.
| -| Ready to upgrade | Mark applications and drivers **Ready to upgrade** once you’ve resolved all blocking issues and you’re confident that they will upgrade successfully, or if you’ve decided to upgrade them as-is. | Applications with no known issues and with low installation rates are marked **Ready to upgrade** by default.

In Step 1, you might have marked some of your apps as **Ignore**. These should be marked as **Ready to upgrade**. Apps with low installation rates are marked as **Ready to upgrade** by default. Be sure to review any low install count applications for any business critical or important applications that are not yet upgrade-ready, despite their low installation rates.
| -| Won’t upgrade | By default, no applications or drivers are marked **Won’t upgrade** because only you can make that determination.

Use **Won’t upgrade** for applications and drivers that you do not work on your target operating system, or that you are unable to upgrade.
| If, during your investigation into an application or driver, you determine that they should not or cannot be upgraded, mark them **Won’t upgrade**.

| - -As you review applications with known issues, you can also see ISV support statements or applications using [Ready for Windows](https://www.readyforwindows.com/). - -## Review applications with known issues - -Applications with issues known to Microsoft are listed, grouped by upgrade assessment into **Attention needed** or **Fix available**. - - - -![Review applications with known issues](../images/upgrade-analytics-apps-known-issues.png) - -To change an application's upgrade decision: - -1. Select **Decide upgrade readiness** to view applications with issues. -2. In the table view, select an **UpgradeDecision** value. -3. Select **Decide upgrade readiness** to change the upgrade decision for each application. -4. Select the applications you want to change to a specific upgrade decision and then select the appropriate option from the **Select upgrade decision** list. -5. Click **Save** when finished. - -IMPORTANT: Ensure that you have the most recent versions of the compatibility update and related KBs installed to get the most up-to-date compatibility information. - -For applications assessed as **Attention needed**, review the table below for details about known issues and for guidance about how to resolve them, when possible. - -| Upgrade Assessment | Action required prior to upgrade? | Issue | What it means | Guidance | -|--------------------|-----------------------------------|-----------|-----------------|------------| -| Attention needed | No | Application is removed during upgrade | Compatibility issues were detected and the application will not migrate to the new operating system.
| No action is required for the upgrade to proceed. | -| Attention needed | Yes | Blocking upgrade | Blocking issues were detected and Upgrade Readiness is not able to remove the application during upgrade.

The application may work on the new operating system.
| Remove the application before upgrading, and reinstall and test on new operating system. | -| Attention needed | No | Evaluate application on new OS | The application will migrate, but issues were detected that may impact its performance on the new operating system. | No action is required for the upgrade to proceed, but be sure to test the application on the new operating system.
| -| Attention needed | No | Does not work with new OS, but won’t block upgrade | The application is not compatible with the new operating system, but won’t block the upgrade. | No action is required for the upgrade to proceed, however, you’ll have to install a compatible version of the application on the new operating system.
| -| Attention needed | Yes | Does not work with new OS, and will block upgrade | The application is not compatible with the new operating system and will block the upgrade. | Remove the application before upgrading.

A compatible version of the application may be available.
| -| Attention needed | Yes | May block upgrade, test application | Issues were detected that may interfere with the upgrade, but need to be investigated further.
| Test the application’s behavior during upgrade. If it blocks the upgrade, remove it before upgrading and reinstall and test it on the new operating system.
| -| Attention needed | Maybe | Multiple | Multiple issues are affecting the application. See detailed view for more information.| When you see Multiple in the query detailed view, click **Query** to see details about what issues were detected with the different versions of the application. | - -For applications assessed as **Fix available**, review the table below for details about known issues and ways to fix them that are known to Microsoft. - -| Upgrade Assessment | Action required prior to upgrade? | Issue | What it means | Guidance | -|--------------------|-----------------------------------|----------|-----------------|-------------| -| Fix available | Yes | Blocking upgrade, update application to newest version | The existing version of the application is not compatible with the new operating system and won’t migrate. A compatible version of the application is available. | Update the application before upgrading. | -| Fix available | No | Reinstall application after upgrading | The application is compatible with the new operating system, but must be reinstalled after upgrading. The application is removed during the upgrade process.
| No action is required for the upgrade to proceed. Reinstall application on the new operating system. | -| Fix available | Yes | Blocking upgrade, but can be reinstalled after upgrading | The application is compatible with the new operating system, but won’t migrate. | Remove the application before upgrading and reinstall on the new operating system.
| -| Fix available | Yes | Disk encryption blocking upgrade | The application’s encryption features are blocking the upgrade. | Disable the encryption feature before upgrading and enable it again after upgrading.
| - -### ISV support for applications with Ready for Windows - -[Ready for Windows](https://www.readyforwindows.com/) lists software solutions that are supported and in use for Windows 10. This site leverages data about application adoption from commercial Windows 10 installations and helps IT managers upgrade to Windows 10 with confidence. For more information, see [Ready for Windows Frequently Asked Questions](https://developer.microsoft.com/windows/ready-for-windows/#/faq/). - -Click **Review Applications With Known Issues** to see the status of applications for Ready for Windows and corresponding guidance. For example: - -![Upgrade analytics Ready for Windows status](../images/upgrade-analytics-ready-for-windows-status.png) - -If there are known issues with an application, the specific guidance for that known issue takes precedence over the Ready for Windows guidance. - -![Upgrade analytics Ready for Windows status guidance precedence](../images/upgrade-analytics-ready-for-windows-status-guidance-precedence.png) - -If you query with RollupLevel="NamePublisher", each version of the application can have a different status for Ready for Windows. In this case, different values appear for Ready for Windows. - -![Name publisher rollup](../images/upgrade-analytics-namepub-rollup.png) - -> [!TIP] -> Within the Upgrade Readiness data model, an object of Type **UAApp** refers to a particular application installed on a specific computer. -> -> To support dynamic aggregation and summation of data the Upgrade Readiness solution "rolls up" (aggregates) data in preprocessing. Rolling up to the **Granular** level enables display of the **App** level. In Upgrade Readiness terminology, an **App** is a unique combination of: app name, app vendor, app version, and app language. Thus, at the Granular level, you can see attributes such as **total install count**, which is the number of machines with a specific **App** installed. -> -> Upgrade Readiness also has a roll up level of **NamePublisher**, This level enables you to ignore different app versions within your organization for a particular app. In other words, **NamePublisher** displays statistics about a given app, aggregated across all versions. - -The following table lists possible values for **ReadyForWindows** and what they mean. For more information, see [What does the Adoption Status mean?](https://developer.microsoft.com/en-us/windows/ready-for-windows#/faq/?scrollTo=faqStatuses) - -| Ready for Windows Status | Query rollup level | What this means | Guidance | -|-------------------|--------------------------|-----------------|----------| -|Supported version available | Granular | The software provider has declared support for one or more versions of this application on Windows 10. | The ISV has declared support for a version of this application on Windows 10. | -| Highly adopted | Granular | This version of this application has been highly adopted within the Windows 10 Enterprise ecosystem. | This application has been installed on at least 100,000 commercial Windows 10 devices. | -| Adopted | Granular | This version of this application has been adopted within the Windows 10 Enterprise ecosystem. | This application has been installed on at least 10,000 commercial Windows 10 devices. | -| Insufficient Data | Granular | Too few commercial Windows 10 devices are sharing information about this version of this application for Microsoft to categorize its adoption. | N/A | -| Contact developer | Granular | There may be compatibility issues with this version of the application, so Microsoft recommends contacting the software provider to learn more. | Check [Ready for Windows](https://www.readyforwindows.com/) for additional information.| -|Supported version available | NamePublisher | The software provider has declared support for this application on Windows 10. | The ISV has declared support for a version of this application on Windows 10.| -|Adoption status available | NamePublisher | A Ready for Windows adoption status is available for one or more versions of this application. Please check Ready for Windows to learn more. |Check [Ready for Windows](https://www.readyforwindows.com/) for adoption information for this application.| -| Unknown | Any | There is no Ready for Windows information available for this version of this application. Information may be available for other versions of the application at [Ready for Windows](https://www.readyforwindows.com/). | N/A | - -## Review drivers with known issues - -Drivers that won’t migrate to the new operating system are listed, grouped by availability. - -![Review drivers with known issues](../images/upgrade-analytics-drivers-known.png) - -Availability categories are explained in the table below. - -| Driver availability | Action required before or after upgrade? | What it means | Guidance | -|-----------------------|------------------------------------------|----------------|--------------| -| Available in-box | No, for awareness only | The currently installed version of an application or driver won’t migrate to the new operating system; however, a compatible version is installed with the new operating system.
| No action is required for the upgrade to proceed. | -| Import from Windows Update | Yes | The currently installed version of a driver won’t migrate to the new operating system; however, a compatible version is available from Windows Update.
| If the computer automatically receives updates from Windows Update, no action is required. Otherwise, import a new driver from Windows Update after upgrading.
| -| Available in-box and from Windows Update | Yes | The currently installed version of a driver won’t migrate to the new operating system.

Although a new driver is installed during upgrade, a newer version is available from Windows Update.
| If the computer automatically receives updates from Windows Update, no action is required. Otherwise, import a new driver from Windows Update after upgrading.
| -| Check with vendor | Yes | The driver won’t migrate to the new operating system and we are unable to locate a compatible version.
| Check with the independent hardware vendor (IHV) who manufactures the driver for a solution. | - -To change a driver’s upgrade decision: - -1. Select **Decide upgrade readiness** and then select the group of drivers you want to review. Select **Table** to view the list in a table. - -2. Select **User changes** to enable user input. - -3. Select the drivers you want to change to a specific upgrade decision and then select the appropriate option from the **Select upgrade decision** list. - -4. Click **Save** when finished. - -## Review low-risk apps and drivers - -Applications and drivers that are meet certain criteria to be considered low risk are displayed on this blade. - -![Blade showing low-risk apps](../images/ua-step2-low-risk.png) - -The first row reports the number of your apps that have an official statement of support on Windows 10 from the software vendor, so you can be confident that they will work on your target operating system. - -The second row (**Apps that are "Highly adopted"**) shows apps that have a ReadyForWindows status of "Highly adopted". This means that they have been installed on at least 100,000 commercial Windows 10 devices, and that Microsoft has not detected significant issues with the app in diagnostic data. Since these apps are prevalent in the ecosystem at large, you can be confident that they will work in your environment as well. - -Each row of the blade uses a different criterion to filter your apps or drivers. You can view a list of applications that meet the criterion by clicking into a row of the blade. For example, if you click the row that says "Apps that are 'Highly adopted'", the result is a list of apps that have a ReadyForWindows status of "Highly adopted". From here, you can bulk-select the results, select **Ready to upgrade**, and then click **Save**. This will mark all apps meeting the "Highly adopted" criterion as "Ready to upgrade"--no further validation is required. Any applications that you have marked as *Mission critical* or *Business critical* are filtered out, as well as any app that has an issue known to Microsoft. This allows you to work with apps in bulk without having to worry about missing a critical app. - -You can customize the criteria further by using the Log Search query language. For example, if a ReadyForWindows status of "Adopted" is not sufficient by itself for you to be confident in an app's compatibility, you can add additional filters. To do this, click the row labeled **Apps that are 'Adopted'**. Then, modify the resulting query to fit your company's risk tolerance. If, for example, you prefer that an app must be "Adopted" and have fewer than 1,000 installations, then add *TotalInstalls < 1000* to the end of the Log Search query. Similarly, you can append additional criteria by using other attributes such as monthly active users or app importance. - ->[!NOTE] ->Apps that you have designated as *Mission critical* or *Business critical* are automatically **excluded** from the counts on this blade. If an app is critical, you should always validate it manually it prior to upgrading. - - At the bottom of the blade, the **OTHER APPS AND DRIVERS IN NEED OF REVIEW** section allows you to quickly access apps you have designated as **Mission critical** or **Business critical**, your remaining apps that still need to be reviewed, and your remaining drivers that need to be reviewed. - - - -## Prioritize app and driver testing - -Planning and executing an OS upgrade project can be overwhelming. When you are tasked with evaluating thousands of applications and drivers to ensure a successful upgrade, it can be difficult to decide where to start. The Upgrade Readiness solution provides valuable assistance for you, helping to determine the most important apps and drivers to unblock and enabling you yo create a proposed action plan. - -### Proposed action plan - -The Upgrade Readiness proposed action plan is an optimally ordered list of apps and drivers that are in need of review. By testing apps and drivers in the order suggested by the proposed action plan, you are able to increase your number of “Ready to upgrade” computers in an efficient manner. The action plan can be a very powerful tool during upgrade planning – but it’s most helpful when it’s used correctly. This topic explains the proposed action plan, describes how to use it, and calls out a few misconceptions and invalid use cases that you should avoid. - -The proposed action plan represents the order thath Microsoft recommends you rationalize the upgrade-readiness of your apps and drivers. By validating apps and drivers in the order proposed, you can ensure that you are testing efficiently. - -Each item in the proposed action plan represents either an application or a driver that you have not yet marked “Ready to upgrade.” - ->Since “Low install count” apps are automatically marked “Ready to upgrade”, you will not see any of these apps in the proposed action plan. - -Each item in the plan has the following attributes: - -| Attribute | Description | Example value | -|-----------------------|------------------------------------------|----------------| -| ItemRank | The location of this item in the context of the proposed action plan. For example, the item with ItemRank 7 is the 7th item in the Plan. It is crucial that the Plan is viewed in order by increasing ItemRank. Sorting the Plan in any other way invalidates the insights that the Plan provides. | 7 | -| ItemType | Whether this item is an app or driver -- possible values are: "App" and "Driver." | App | -| ItemName | The name of the app or driver that is in need of review. | Microsoft Visual C++ 2005 Redistributable (x64) | -| ItemVendor | The vendor of the app or driver. | Microsoft Corporation | -| ItemVersion | The version of the app or driver. | 12.1.0.1 | -| ItemLanguage | If this item is an application, then this field will be the language of the app. If the item is a driver, then this will say "N/A." | English | -| ItemHardwareId | If this item is a driver, then this field will be the hardware id of the driver. If the item is an app, then this will say "N/A." | N/A | -| Upgrade Decision | The upgrade decision you have provided for this app or driver. If you have not defined an upgrade decision, then you will see the default value of “Not reviewed.” | Review in progress | -| ComputersUnblocked | Assuming you have already marked all previous items in the proposed action plan “Ready to upgrade”, this represents the number of additional computers that will become “Ready to upgrade” by testing this app or driver and giving it an upgrade decision of “Ready to upgrade”. For example, if ComputersUnblocked is 200, then resolving any issues associated with the app/driver in question will make 200 new computers “Ready to upgrade.” | 200 | -| CumulativeUnblocked | The total number of computers that will become “Ready to upgrade” if you validate and mark this and all prior items in the proposed action plan “Ready to upgrade”. For example, if ItemRank is 7, and CumulativeUnblocked is 950, then fixing items 1 thru 7 in the proposed action plan will cause 950 of your computers to become “Ready to upgrade.” | 950 | -| CumulativeUnblockedPct | The percentage of your machines that will become “Ready to upgrade” if you make this and all prior items in the proposed action plan “Ready to upgrade.” | 0.24 | - -See the following example action plan items (click the image for a full-size view): - -![Proposed action plan](../images/UR-lift-report.jpg) - -
-In this example, the 3rd item is an application: Microsoft Bing Sports, a modern app, version 4.20.951.0, published by Microsoft. By validating this app and making its UpgradeDecision “Ready to upgrade”, you can potentially make 1014 computers “Ready to upgrade” – but only after you have already validated items 1 and 2 in the list. By marking items 1, 2, and 3 “Ready to upgrade”, 14779 of your computers will become upgrade-ready. This represents 10.96% of the machines in this workspace. - -#### Using the proposed action plan - -There are several valid use cases for the proposed action plan. But it’s always important to remember that the information presented in the Plan is only accurate when sorted by increasing Item Rank! Here are three potential cases in which you could use the proposed action plan: - -1. Quickly determine how many apps and drivers you’ll need to validate in order to make x% of your computers upgrade-ready. To determine this, simply find the first item in the Plan with a CumulativeUnblockedPct greater than or equal to your desired percentage of upgrade-ready computers. The corresponding ItemRank represents the smallest number of apps and drivers that you can validate in order to reach your upgrade readiness goal. The prior items in the proposed action plan itself represent the most efficient route to reaching your goal. - -2. Use the proposed action plan to prepare a small portion of your machines for a pilot of your target Operating System. Let’s say you want to test a new Operating System by upgrading a few hundred computers. You can use the proposed action plan to determine how many apps and drivers you will need to validate before you can be confident that your pilot will be successful. - -3. If your project deadline is approaching and you only have time to validate a few more apps and drivers, you can use the proposed action plan to determine which apps and drivers you should focus on to maximize the number of computers that you can confidently upgrade. - -#### Misconceptions and things to avoid - -The most common misconceptions about the proposed action plan involve the assumption that each item in the plan is independent of those around it. The apps and drivers in the plan must be considered in the correct order to draw valid conclusions. For example, if you choose to validate items 1, 3, 4, and 5 and mark each of them “Ready to upgrade,” the proposed action plan cannot tell you how many computers will become upgrade-ready as a result of your testing. Even the non-cumulative “ComputersUnblocked” count is dependent upon all prior issues having already been resolved. - -If an item with ItemRank = 7 has a ComputersUnblocked value of 50, do not assume that 50 of your computers will become upgrade-ready if you test this item. However, if you validate items 1 through 6 in the plan, you can make an additional 50 computers upgrade-ready by validating the 7th item in the plan. +--- +title: Upgrade Readiness - Resolve application and driver issues (Windows 10) +ms.reviewer: +manager: laurawi +description: Describes how to resolve application and driver issues that can occur during an upgrade with Upgrade Readiness. +keywords: windows analytics, oms, operations management suite, prerequisites, requirements, upgrades, log analytics, +ms.prod: w10 +audience: itpro +author: jaimeo +ms.author: jaimeo +ms.localizationpriority: medium +ms.topic: article +ms.collection: M365-analytics +--- + +# Upgrade Readiness - Step 2: Resolve app and driver issues + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +This section of the Upgrade Readiness workflow reports application and driver inventory and shows you which applications have known issues, which applications have no known issues, and which drivers have issues. We identify applications and drivers that need attention and suggest fixes when we know about them. + +## In this section + +The blades in the **Step 2: Resolve issues** section are: + +- [Review applications with known issues](#review-applications-with-known-issues) +- [Review known driver issues](#review-drivers-with-known-issues) +- [Review low-risk apps and drivers](#review-low-risk-apps-and-drivers) +- [Prioritize app and driver testing](#prioritize-app-and-driver-testing) + +>You can change an application’s upgrade decision and a driver’s upgrade decision from the blades in this section. To change an application’s or a driver’s importance level, select **User changes**. Select the item you want to change and then select the appropriate option from the **Select upgrade decision** list. + +Upgrade decisions include: + + +| Upgrade decision | When to use it | Guidance | +|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Not reviewed | All drivers are marked as Not reviewed by default.

Any app that has not been marked **Low install count** will also have an upgrade decision of **Not reviewed** by default.
| Apps you have not yet reviewed or are waiting to review later should be marked as **Not reviewed**. When you start to investigate an application or a driver to determine upgrade readiness, change their upgrade decision to **Review in progress**.

| +| Review in progress | When you start to investigate an application or a driver to determine upgrade readiness, change its upgrade decision to **Review in progress**.

Until you’ve determined that applications and drivers will migrate successfully or you’ve resolved blocking issues, leave the upgrade decision status as **Review in progress**.

| Once you’ve fixed any issues and validated that the application or driver will migrate successfully, change the upgrade decision to **Ready to upgrade**.
| +| Ready to upgrade | Mark applications and drivers **Ready to upgrade** once you’ve resolved all blocking issues and you’re confident that they will upgrade successfully, or if you’ve decided to upgrade them as-is. | Applications with no known issues and with low installation rates are marked **Ready to upgrade** by default.

In Step 1, you might have marked some of your apps as **Ignore**. These should be marked as **Ready to upgrade**. Apps with low installation rates are marked as **Ready to upgrade** by default. Be sure to review any low install count applications for any business critical or important applications that are not yet upgrade-ready, despite their low installation rates.
| +| Won’t upgrade | By default, no applications or drivers are marked **Won’t upgrade** because only you can make that determination.

Use **Won’t upgrade** for applications and drivers that you do not work on your target operating system, or that you are unable to upgrade.
| If, during your investigation into an application or driver, you determine that they should not or cannot be upgraded, mark them **Won’t upgrade**.

| + +As you review applications with known issues, you can also see ISV support statements or applications using [Ready for Windows](https://www.readyforwindows.com/). + +## Review applications with known issues + +Applications with issues known to Microsoft are listed, grouped by upgrade assessment into **Attention needed** or **Fix available**. + + + +![Review applications with known issues](../images/upgrade-analytics-apps-known-issues.png) + +To change an application's upgrade decision: + +1. Select **Decide upgrade readiness** to view applications with issues. +2. In the table view, select an **UpgradeDecision** value. +3. Select **Decide upgrade readiness** to change the upgrade decision for each application. +4. Select the applications you want to change to a specific upgrade decision and then select the appropriate option from the **Select upgrade decision** list. +5. Click **Save** when finished. + +IMPORTANT: Ensure that you have the most recent versions of the compatibility update and related KBs installed to get the most up-to-date compatibility information. + +For applications assessed as **Attention needed**, review the table below for details about known issues and for guidance about how to resolve them, when possible. + +| Upgrade Assessment | Action required prior to upgrade? | Issue | What it means | Guidance | +|--------------------|-----------------------------------|-----------|-----------------|------------| +| Attention needed | No | Application is removed during upgrade | Compatibility issues were detected and the application will not migrate to the new operating system.
| No action is required for the upgrade to proceed. | +| Attention needed | Yes | Blocking upgrade | Blocking issues were detected and Upgrade Readiness is not able to remove the application during upgrade.

The application may work on the new operating system.
| Remove the application before upgrading, and reinstall and test on new operating system. | +| Attention needed | No | Evaluate application on new OS | The application will migrate, but issues were detected that may impact its performance on the new operating system. | No action is required for the upgrade to proceed, but be sure to test the application on the new operating system.
| +| Attention needed | No | Does not work with new OS, but won’t block upgrade | The application is not compatible with the new operating system, but won’t block the upgrade. | No action is required for the upgrade to proceed, however, you’ll have to install a compatible version of the application on the new operating system.
| +| Attention needed | Yes | Does not work with new OS, and will block upgrade | The application is not compatible with the new operating system and will block the upgrade. | Remove the application before upgrading.

A compatible version of the application may be available.
| +| Attention needed | Yes | May block upgrade, test application | Issues were detected that may interfere with the upgrade, but need to be investigated further.
| Test the application’s behavior during upgrade. If it blocks the upgrade, remove it before upgrading and reinstall and test it on the new operating system.
| +| Attention needed | Maybe | Multiple | Multiple issues are affecting the application. See detailed view for more information.| When you see Multiple in the query detailed view, click **Query** to see details about what issues were detected with the different versions of the application. | + +For applications assessed as **Fix available**, review the table below for details about known issues and ways to fix them that are known to Microsoft. + +| Upgrade Assessment | Action required prior to upgrade? | Issue | What it means | Guidance | +|--------------------|-----------------------------------|----------|-----------------|-------------| +| Fix available | Yes | Blocking upgrade, update application to newest version | The existing version of the application is not compatible with the new operating system and won’t migrate. A compatible version of the application is available. | Update the application before upgrading. | +| Fix available | No | Reinstall application after upgrading | The application is compatible with the new operating system, but must be reinstalled after upgrading. The application is removed during the upgrade process.
| No action is required for the upgrade to proceed. Reinstall application on the new operating system. | +| Fix available | Yes | Blocking upgrade, but can be reinstalled after upgrading | The application is compatible with the new operating system, but won’t migrate. | Remove the application before upgrading and reinstall on the new operating system.
| +| Fix available | Yes | Disk encryption blocking upgrade | The application’s encryption features are blocking the upgrade. | Disable the encryption feature before upgrading and enable it again after upgrading.
| + +### ISV support for applications with Ready for Windows + +[Ready for Windows](https://www.readyforwindows.com/) lists software solutions that are supported and in use for Windows 10. This site leverages data about application adoption from commercial Windows 10 installations and helps IT managers upgrade to Windows 10 with confidence. For more information, see [Ready for Windows Frequently Asked Questions](https://developer.microsoft.com/windows/ready-for-windows/#/faq/). + +Click **Review Applications With Known Issues** to see the status of applications for Ready for Windows and corresponding guidance. For example: + +![Upgrade analytics Ready for Windows status](../images/upgrade-analytics-ready-for-windows-status.png) + +If there are known issues with an application, the specific guidance for that known issue takes precedence over the Ready for Windows guidance. + +![Upgrade analytics Ready for Windows status guidance precedence](../images/upgrade-analytics-ready-for-windows-status-guidance-precedence.png) + +If you query with RollupLevel="NamePublisher", each version of the application can have a different status for Ready for Windows. In this case, different values appear for Ready for Windows. + +![Name publisher rollup](../images/upgrade-analytics-namepub-rollup.png) + +> [!TIP] +> Within the Upgrade Readiness data model, an object of Type **UAApp** refers to a particular application installed on a specific computer. +> +> To support dynamic aggregation and summation of data the Upgrade Readiness solution "rolls up" (aggregates) data in preprocessing. Rolling up to the **Granular** level enables display of the **App** level. In Upgrade Readiness terminology, an **App** is a unique combination of: app name, app vendor, app version, and app language. Thus, at the Granular level, you can see attributes such as **total install count**, which is the number of machines with a specific **App** installed. +> +> Upgrade Readiness also has a roll up level of **NamePublisher**, This level enables you to ignore different app versions within your organization for a particular app. In other words, **NamePublisher** displays statistics about a given app, aggregated across all versions. + +The following table lists possible values for **ReadyForWindows** and what they mean. For more information, see [What does the Adoption Status mean?](https://developer.microsoft.com/en-us/windows/ready-for-windows#/faq/?scrollTo=faqStatuses) + +| Ready for Windows Status | Query rollup level | What this means | Guidance | +|-------------------|--------------------------|-----------------|----------| +|Supported version available | Granular | The software provider has declared support for one or more versions of this application on Windows 10. | The ISV has declared support for a version of this application on Windows 10. | +| Highly adopted | Granular | This version of this application has been highly adopted within the Windows 10 Enterprise ecosystem. | This application has been installed on at least 100,000 commercial Windows 10 devices. | +| Adopted | Granular | This version of this application has been adopted within the Windows 10 Enterprise ecosystem. | This application has been installed on at least 10,000 commercial Windows 10 devices. | +| Insufficient Data | Granular | Too few commercial Windows 10 devices are sharing information about this version of this application for Microsoft to categorize its adoption. | N/A | +| Contact developer | Granular | There may be compatibility issues with this version of the application, so Microsoft recommends contacting the software provider to learn more. | Check [Ready for Windows](https://www.readyforwindows.com/) for additional information.| +|Supported version available | NamePublisher | The software provider has declared support for this application on Windows 10. | The ISV has declared support for a version of this application on Windows 10.| +|Adoption status available | NamePublisher | A Ready for Windows adoption status is available for one or more versions of this application. Please check Ready for Windows to learn more. |Check [Ready for Windows](https://www.readyforwindows.com/) for adoption information for this application.| +| Unknown | Any | There is no Ready for Windows information available for this version of this application. Information may be available for other versions of the application at [Ready for Windows](https://www.readyforwindows.com/). | N/A | + +## Review drivers with known issues + +Drivers that won’t migrate to the new operating system are listed, grouped by availability. + +![Review drivers with known issues](../images/upgrade-analytics-drivers-known.png) + +Availability categories are explained in the table below. + +| Driver availability | Action required before or after upgrade? | What it means | Guidance | +|-----------------------|------------------------------------------|----------------|--------------| +| Available in-box | No, for awareness only | The currently installed version of an application or driver won’t migrate to the new operating system; however, a compatible version is installed with the new operating system.
| No action is required for the upgrade to proceed. | +| Import from Windows Update | Yes | The currently installed version of a driver won’t migrate to the new operating system; however, a compatible version is available from Windows Update.
| If the computer automatically receives updates from Windows Update, no action is required. Otherwise, import a new driver from Windows Update after upgrading.
| +| Available in-box and from Windows Update | Yes | The currently installed version of a driver won’t migrate to the new operating system.

Although a new driver is installed during upgrade, a newer version is available from Windows Update.
| If the computer automatically receives updates from Windows Update, no action is required. Otherwise, import a new driver from Windows Update after upgrading.
| +| Check with vendor | Yes | The driver won’t migrate to the new operating system and we are unable to locate a compatible version.
| Check with the independent hardware vendor (IHV) who manufactures the driver for a solution. | + +To change a driver’s upgrade decision: + +1. Select **Decide upgrade readiness** and then select the group of drivers you want to review. Select **Table** to view the list in a table. + +2. Select **User changes** to enable user input. + +3. Select the drivers you want to change to a specific upgrade decision and then select the appropriate option from the **Select upgrade decision** list. + +4. Click **Save** when finished. + +## Review low-risk apps and drivers + +Applications and drivers that are meet certain criteria to be considered low risk are displayed on this blade. + +![Blade showing low-risk apps](../images/ua-step2-low-risk.png) + +The first row reports the number of your apps that have an official statement of support on Windows 10 from the software vendor, so you can be confident that they will work on your target operating system. + +The second row (**Apps that are "Highly adopted"**) shows apps that have a ReadyForWindows status of "Highly adopted". This means that they have been installed on at least 100,000 commercial Windows 10 devices, and that Microsoft has not detected significant issues with the app in diagnostic data. Since these apps are prevalent in the ecosystem at large, you can be confident that they will work in your environment as well. + +Each row of the blade uses a different criterion to filter your apps or drivers. You can view a list of applications that meet the criterion by clicking into a row of the blade. For example, if you click the row that says "Apps that are 'Highly adopted'", the result is a list of apps that have a ReadyForWindows status of "Highly adopted". From here, you can bulk-select the results, select **Ready to upgrade**, and then click **Save**. This will mark all apps meeting the "Highly adopted" criterion as "Ready to upgrade"--no further validation is required. Any applications that you have marked as *Mission critical* or *Business critical* are filtered out, as well as any app that has an issue known to Microsoft. This allows you to work with apps in bulk without having to worry about missing a critical app. + +You can customize the criteria further by using the Log Search query language. For example, if a ReadyForWindows status of "Adopted" is not sufficient by itself for you to be confident in an app's compatibility, you can add additional filters. To do this, click the row labeled **Apps that are 'Adopted'**. Then, modify the resulting query to fit your company's risk tolerance. If, for example, you prefer that an app must be "Adopted" and have fewer than 1,000 installations, then add *TotalInstalls < 1000* to the end of the Log Search query. Similarly, you can append additional criteria by using other attributes such as monthly active users or app importance. + +>[!NOTE] +>Apps that you have designated as *Mission critical* or *Business critical* are automatically **excluded** from the counts on this blade. If an app is critical, you should always validate it manually it prior to upgrading. + + At the bottom of the blade, the **OTHER APPS AND DRIVERS IN NEED OF REVIEW** section allows you to quickly access apps you have designated as **Mission critical** or **Business critical**, your remaining apps that still need to be reviewed, and your remaining drivers that need to be reviewed. + + + +## Prioritize app and driver testing + +Planning and executing an OS upgrade project can be overwhelming. When you are tasked with evaluating thousands of applications and drivers to ensure a successful upgrade, it can be difficult to decide where to start. The Upgrade Readiness solution provides valuable assistance for you, helping to determine the most important apps and drivers to unblock and enabling you yo create a proposed action plan. + +### Proposed action plan + +The Upgrade Readiness proposed action plan is an optimally ordered list of apps and drivers that are in need of review. By testing apps and drivers in the order suggested by the proposed action plan, you are able to increase your number of “Ready to upgrade” computers in an efficient manner. The action plan can be a very powerful tool during upgrade planning – but it’s most helpful when it’s used correctly. This topic explains the proposed action plan, describes how to use it, and calls out a few misconceptions and invalid use cases that you should avoid. + +The proposed action plan represents the order thath Microsoft recommends you rationalize the upgrade-readiness of your apps and drivers. By validating apps and drivers in the order proposed, you can ensure that you are testing efficiently. + +Each item in the proposed action plan represents either an application or a driver that you have not yet marked “Ready to upgrade.” + +>Since “Low install count” apps are automatically marked “Ready to upgrade”, you will not see any of these apps in the proposed action plan. + +Each item in the plan has the following attributes: + +| Attribute | Description | Example value | +|-----------------------|------------------------------------------|----------------| +| ItemRank | The location of this item in the context of the proposed action plan. For example, the item with ItemRank 7 is the 7th item in the Plan. It is crucial that the Plan is viewed in order by increasing ItemRank. Sorting the Plan in any other way invalidates the insights that the Plan provides. | 7 | +| ItemType | Whether this item is an app or driver -- possible values are: "App" and "Driver." | App | +| ItemName | The name of the app or driver that is in need of review. | Microsoft Visual C++ 2005 Redistributable (x64) | +| ItemVendor | The vendor of the app or driver. | Microsoft Corporation | +| ItemVersion | The version of the app or driver. | 12.1.0.1 | +| ItemLanguage | If this item is an application, then this field will be the language of the app. If the item is a driver, then this will say "N/A." | English | +| ItemHardwareId | If this item is a driver, then this field will be the hardware id of the driver. If the item is an app, then this will say "N/A." | N/A | +| Upgrade Decision | The upgrade decision you have provided for this app or driver. If you have not defined an upgrade decision, then you will see the default value of “Not reviewed.” | Review in progress | +| ComputersUnblocked | Assuming you have already marked all previous items in the proposed action plan “Ready to upgrade”, this represents the number of additional computers that will become “Ready to upgrade” by testing this app or driver and giving it an upgrade decision of “Ready to upgrade”. For example, if ComputersUnblocked is 200, then resolving any issues associated with the app/driver in question will make 200 new computers “Ready to upgrade.” | 200 | +| CumulativeUnblocked | The total number of computers that will become “Ready to upgrade” if you validate and mark this and all prior items in the proposed action plan “Ready to upgrade”. For example, if ItemRank is 7, and CumulativeUnblocked is 950, then fixing items 1 thru 7 in the proposed action plan will cause 950 of your computers to become “Ready to upgrade.” | 950 | +| CumulativeUnblockedPct | The percentage of your machines that will become “Ready to upgrade” if you make this and all prior items in the proposed action plan “Ready to upgrade.” | 0.24 | + +See the following example action plan items (click the image for a full-size view): + +![Proposed action plan](../images/UR-lift-report.jpg) + +
+In this example, the 3rd item is an application: Microsoft Bing Sports, a modern app, version 4.20.951.0, published by Microsoft. By validating this app and making its UpgradeDecision “Ready to upgrade”, you can potentially make 1014 computers “Ready to upgrade” – but only after you have already validated items 1 and 2 in the list. By marking items 1, 2, and 3 “Ready to upgrade”, 14779 of your computers will become upgrade-ready. This represents 10.96% of the machines in this workspace. + +#### Using the proposed action plan + +There are several valid use cases for the proposed action plan. But it’s always important to remember that the information presented in the Plan is only accurate when sorted by increasing Item Rank! Here are three potential cases in which you could use the proposed action plan: + +1. Quickly determine how many apps and drivers you’ll need to validate in order to make x% of your computers upgrade-ready. To determine this, simply find the first item in the Plan with a CumulativeUnblockedPct greater than or equal to your desired percentage of upgrade-ready computers. The corresponding ItemRank represents the smallest number of apps and drivers that you can validate in order to reach your upgrade readiness goal. The prior items in the proposed action plan itself represent the most efficient route to reaching your goal. + +2. Use the proposed action plan to prepare a small portion of your machines for a pilot of your target Operating System. Let’s say you want to test a new Operating System by upgrading a few hundred computers. You can use the proposed action plan to determine how many apps and drivers you will need to validate before you can be confident that your pilot will be successful. + +3. If your project deadline is approaching and you only have time to validate a few more apps and drivers, you can use the proposed action plan to determine which apps and drivers you should focus on to maximize the number of computers that you can confidently upgrade. + +#### Misconceptions and things to avoid + +The most common misconceptions about the proposed action plan involve the assumption that each item in the plan is independent of those around it. The apps and drivers in the plan must be considered in the correct order to draw valid conclusions. For example, if you choose to validate items 1, 3, 4, and 5 and mark each of them “Ready to upgrade,” the proposed action plan cannot tell you how many computers will become upgrade-ready as a result of your testing. Even the non-cumulative “ComputersUnblocked” count is dependent upon all prior issues having already been resolved. + +If an item with ItemRank = 7 has a ComputersUnblocked value of 50, do not assume that 50 of your computers will become upgrade-ready if you test this item. However, if you validate items 1 through 6 in the plan, you can make an additional 50 computers upgrade-ready by validating the 7th item in the plan. diff --git a/windows/deployment/upgrade/upgrade-readiness-target-new-OS.md b/windows/deployment/upgrade/upgrade-readiness-target-new-OS.md index b4cdb30a40..852b31c569 100644 --- a/windows/deployment/upgrade/upgrade-readiness-target-new-OS.md +++ b/windows/deployment/upgrade/upgrade-readiness-target-new-OS.md @@ -1,61 +1,65 @@ ---- -title: Upgrade Readiness - Targeting a new operating system version -ms.reviewer: -manager: laurawi -ms.author: greglin -description: Explains how to run Upgrade Readiness again to target a different operating system version or bulk-approve all apps from a given vendor -ms.prod: w10 -audience: itpro author: greg-lindsay -ms.topic: article -ms.collection: M365-analytics ---- - -# Targeting a new operating system version - -After you've used Upgrade Readiness to help deploy a given version of Windows 10, you might want to use it again to help deploy a newer version of Windows 10. When you change the target operating system version (as described in [Use Upgrade Readiness to manage Windows upgrades](use-upgrade-readiness-to-manage-windows-upgrades.md#target-version)), the app states (Importance, AppOwner, UpgradeDecision, TestPlan, and TestResult) are not reset. Follow this guidance to preserve or reset these states as needed: - -## TestResults - -If you want to preserve the TestResults from the previous operating system version testing, there is nothing you need to do. - -If you want to reset them, click any of the rows in the **Prioritize Application** blade (described in [Upgrade Readiness - Step 1: Identify important apps](upgrade-readiness-identify-apps.md)). This will take you to the **Log Search** user experience. Replace the query in that window with the following query: - -`search in (UAApp) IsRollup == true and RollupLevel == "Granular" and TestResult <> "Not started"` - -After a short period of time, you will see the "user input" perspective render, which will let you bulk-edit the results. Select the check box in the table header, click the **bulk edit** button, and then set the **TestResult** to *Not started*. Leave all other fields as they are. - -## UpgradeDecision - -If you want to preserve the UpgradeDecision from the previous operating system version testing, there is nothing you need to do. - -If you want to reset them, keep these important points in mind: - -- Make sure to *not* reset the **Ready to upgrade** decision for the "long tail" of apps that have importance of **Ignore** or **Low install count**. Doing this will make it extremely difficult to complete the Upgrade Readiness workflow. -- Decide which decisions to reset. For example, one option is just to reset the decisions marked **Ready to upgrade** (in order to retest those), while preserving states of apps marked **Won't upgrade**. Doing this means you won't lose track of this previous marking. Or you can reset everything. - -To do this, type the following query in **Log Search**: - -`search in (UAApp) IsRollup == true and RollupLevel == "Granular" and Importance <> "Ignore" and Importance <> "Low install count" and UpgradeDecision == "Ready to upgrade"` - ->[!NOTE] ->If you just want to reset all **UpgradeDecision** values, you can simply remove `'and UpgradeDecision == "Ready to upgrade"` from the query. - -After a short period of time, you will see the "user input" perspective render, which will let you bulk-edit the results. Select the check box in the table header, click the **bulk edit** button, and then set the **UpgradeDecision** to *Not reviewed*. Leave all other fields as they are. - - -## Bulk-approving apps from a given vendor - -You can bulk-approve all apps from a given vendor (for example, Microsoft) if there are no known compatibility issues. To do this, type the following query in **Log Search**: - -`search in (UAApp) IsRollup == true and RollupLevel == "Granular" and AppVendor has "Microsoft" and UpgradeAssessment=="No known issues" and UpgradeDecision<>"Ready to upgrade"` - -After a short period of time, you will see the "user input" perspective render, which will let you bulk-edit the results. Select the check box in the table header, click the **bulk edit" button**, and then set the **UpgradeDecision** to *Ready to upgrade*. Leave all other fields as they are. - -## Related topics - -[Windows Analytics overview](../update/windows-analytics-overview.md) - -[Manage Windows upgrades with Upgrade Readiness](manage-windows-upgrades-with-upgrade-readiness.md) - -[Get started with Upgrade Readiness](upgrade-readiness-get-started.md) - +--- +title: Upgrade Readiness - Targeting a new operating system version +ms.reviewer: +manager: laurawi +ms.author: jaimeo +description: Explains how to run Upgrade Readiness again to target a different operating system version or bulk-approve all apps from a given vendor +ms.prod: w10 +audience: itpro +author: jaimeo +ms.topic: article +ms.collection: M365-analytics +--- + +# Targeting a new operating system version + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +After you've used Upgrade Readiness to help deploy a given version of Windows 10, you might want to use it again to help deploy a newer version of Windows 10. When you change the target operating system version (as described in [Use Upgrade Readiness to manage Windows upgrades](use-upgrade-readiness-to-manage-windows-upgrades.md#target-version)), the app states (Importance, AppOwner, UpgradeDecision, TestPlan, and TestResult) are not reset. Follow this guidance to preserve or reset these states as needed: + +## TestResults + +If you want to preserve the TestResults from the previous operating system version testing, there is nothing you need to do. + +If you want to reset them, click any of the rows in the **Prioritize Application** blade (described in [Upgrade Readiness - Step 1: Identify important apps](upgrade-readiness-identify-apps.md)). This will take you to the **Log Search** user experience. Replace the query in that window with the following query: + +`search in (UAApp) IsRollup == true and RollupLevel == "Granular" and TestResult <> "Not started"` + +After a short period of time, you will see the "user input" perspective render, which will let you bulk-edit the results. Select the check box in the table header, click the **bulk edit** button, and then set the **TestResult** to *Not started*. Leave all other fields as they are. + +## UpgradeDecision + +If you want to preserve the UpgradeDecision from the previous operating system version testing, there is nothing you need to do. + +If you want to reset them, keep these important points in mind: + +- Make sure to *not* reset the **Ready to upgrade** decision for the "long tail" of apps that have importance of **Ignore** or **Low install count**. Doing this will make it extremely difficult to complete the Upgrade Readiness workflow. +- Decide which decisions to reset. For example, one option is just to reset the decisions marked **Ready to upgrade** (in order to retest those), while preserving states of apps marked **Won't upgrade**. Doing this means you won't lose track of this previous marking. Or you can reset everything. + +To do this, type the following query in **Log Search**: + +`search in (UAApp) IsRollup == true and RollupLevel == "Granular" and Importance <> "Ignore" and Importance <> "Low install count" and UpgradeDecision == "Ready to upgrade"` + +>[!NOTE] +>If you just want to reset all **UpgradeDecision** values, you can simply remove `'and UpgradeDecision == "Ready to upgrade"` from the query. + +After a short period of time, you will see the "user input" perspective render, which will let you bulk-edit the results. Select the check box in the table header, click the **bulk edit** button, and then set the **UpgradeDecision** to *Not reviewed*. Leave all other fields as they are. + + +## Bulk-approving apps from a given vendor + +You can bulk-approve all apps from a given vendor (for example, Microsoft) if there are no known compatibility issues. To do this, type the following query in **Log Search**: + +`search in (UAApp) IsRollup == true and RollupLevel == "Granular" and AppVendor has "Microsoft" and UpgradeAssessment=="No known issues" and UpgradeDecision<>"Ready to upgrade"` + +After a short period of time, you will see the "user input" perspective render, which will let you bulk-edit the results. Select the check box in the table header, click the **bulk edit" button**, and then set the **UpgradeDecision** to *Ready to upgrade*. Leave all other fields as they are. + +## Related topics + +[Windows Analytics overview](../update/windows-analytics-overview.md) + +[Manage Windows upgrades with Upgrade Readiness](manage-windows-upgrades-with-upgrade-readiness.md) + +[Get started with Upgrade Readiness](upgrade-readiness-get-started.md) + diff --git a/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md b/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md index 8bbc0e4a13..ea1c4c369a 100644 --- a/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md +++ b/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md @@ -1,73 +1,77 @@ ---- -title: Upgrade Readiness - Upgrade Overview (Windows 10) -ms.reviewer: -manager: laurawi -ms.author: greglin -description: Displays the total count of computers sharing data and upgraded. -ms.prod: w10 -audience: itpro author: greg-lindsay -ms.topic: article -ms.collection: M365-analytics ---- - -# Upgrade Readiness - Upgrade overview - -The first blade in the Upgrade Readiness solution is the upgrade overview blade. This blade displays the total count of computers sharing data with Microsoft, and the count of computers upgraded. As you successfully upgrade computers, the count of computers upgraded increases. - -The upgrade overivew blade displays data refresh status, including the date and time of the most recent data update and whether user changes are reflected. The upgrade overview blade also displays the current target OS version. For more information about the target OS version, see [target version](use-upgrade-readiness-to-manage-windows-upgrades.md#target-version). - -The following color-coded status changes are reflected on the upgrade overview blade: - -- The "Last updated" banner: - - No delay in processing device inventory data = "Last updated" banner is displayed in green. - - Delay processing device inventory data = "Last updated" banner is displayed in amber. -- Computers with incomplete data: - - Less than 4% = Count is displayed in green. - - 4% - 10% = Count is displayed in amber. - - Greater than 10% = Count is displayed in red. -- Computers with outdated KB: - - Less than 10% = Count is displayed in green. - - 10% - 30% = Count is displayed in amber. - - Greater than 30% = Count is displayed in red. -- User changes: - - Pending user changes = User changes count displays "Data refresh pending" in amber. - - No pending user changes = User changes count displays "Up to date" in green. -- Target version: - - If the current value matches the recommended value, the version is displayed in green. - - If the current value is an older OS version than the recommended value, but not deprecated, the version is displayed in amber. - - If the current value is a deprecated OS version, the version is displayed in red. - -Click a row to drill down and see details about individual computers. If updates are missing, see [Enrolling devices in Windows Analytics](../update/windows-analytics-get-started.md) for information on required updates. - -In the following example, there is no delay in data processing, more than 10% of computers (6k\8k) have incomplete data, more than 30% of computers (6k/8k) require an update, there are no pending user changes, and the currently selected target OS version is the same as the recommended version: - -![Upgrade overview](../images/ur-overview.png) - - - -If data processing is delayed, the "Last updated" banner will indicate the date on which data was last updated. You can continue using your workspace as normal. However, any changes or additional information that is added might not be displayed until data is refreshed. When your workspace is in this state, there is no action required; data is typically refreshed and the display will return to normal again within 24 hours. - -If there are computers with incomplete data, verify that you have installed the latest compatibilty updates. Install the updates if necessary and then run the most recent [Update Readiness deployment script](https://go.microsoft.com/fwlink/?LinkID=822966&clcid=0x409) from the Microsoft download center. The updated data payload should appear in Upgrade Readiness within 48 hours of a successful run on the deployment script. - -Select **Total computers** for a list of computers and details about them, including: - -- Computer ID and computer name -- Computer manufacturer -- Computer model -- Operating system version and build -- Count of system requirement, application, and driver issues per computer -- Upgrade assessment based on analysis of computer diagnostic data -- Upgrade decision status - -Select **Total applications** for a list of applications discovered on user computers and details about them, including: - -- Application vendor -- Application version -- Count of computers the application is installed on -- Count of computers that opened the application at least once in the past 30 days -- Percentage of computers in your total computer inventory that opened the application in the past 30 days -- Issues detected, if any -- Upgrade assessment based on analysis of application data -- Rollup level +--- +title: Upgrade Readiness - Upgrade Overview (Windows 10) +ms.reviewer: +manager: laurawi +ms.author: jaimeo +description: Displays the total count of computers sharing data and upgraded. +ms.prod: w10 +audience: itpro +author: jaimeo +ms.topic: article +ms.collection: M365-analytics +--- + +# Upgrade Readiness - Upgrade overview + +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + +The first blade in the Upgrade Readiness solution is the upgrade overview blade. This blade displays the total count of computers sharing data with Microsoft, and the count of computers upgraded. As you successfully upgrade computers, the count of computers upgraded increases. + +The upgrade overivew blade displays data refresh status, including the date and time of the most recent data update and whether user changes are reflected. The upgrade overview blade also displays the current target OS version. For more information about the target OS version, see [target version](use-upgrade-readiness-to-manage-windows-upgrades.md#target-version). + +The following color-coded status changes are reflected on the upgrade overview blade: + +- The "Last updated" banner: + - No delay in processing device inventory data = "Last updated" banner is displayed in green. + - Delay processing device inventory data = "Last updated" banner is displayed in amber. +- Computers with incomplete data: + - Less than 4% = Count is displayed in green. + - 4% - 10% = Count is displayed in amber. + - Greater than 10% = Count is displayed in red. +- Computers with outdated KB: + - Less than 10% = Count is displayed in green. + - 10% - 30% = Count is displayed in amber. + - Greater than 30% = Count is displayed in red. +- User changes: + - Pending user changes = User changes count displays "Data refresh pending" in amber. + - No pending user changes = User changes count displays "Up to date" in green. +- Target version: + - If the current value matches the recommended value, the version is displayed in green. + - If the current value is an older OS version than the recommended value, but not deprecated, the version is displayed in amber. + - If the current value is a deprecated OS version, the version is displayed in red. + +Click a row to drill down and see details about individual computers. If updates are missing, see [Enrolling devices in Windows Analytics](../update/windows-analytics-get-started.md) for information on required updates. + +In the following example, there is no delay in data processing, more than 10% of computers (6k\8k) have incomplete data, more than 30% of computers (6k/8k) require an update, there are no pending user changes, and the currently selected target OS version is the same as the recommended version: + +![Upgrade overview](../images/ur-overview.png) + + + +If data processing is delayed, the "Last updated" banner will indicate the date on which data was last updated. You can continue using your workspace as normal. However, any changes or additional information that is added might not be displayed until data is refreshed. When your workspace is in this state, there is no action required; data is typically refreshed and the display will return to normal again within 24 hours. + +If there are computers with incomplete data, verify that you have installed the latest compatibilty updates. Install the updates if necessary and then run the most recent [Update Readiness deployment script](https://go.microsoft.com/fwlink/?LinkID=822966&clcid=0x409) from the Microsoft download center. The updated data payload should appear in Upgrade Readiness within 48 hours of a successful run on the deployment script. + +Select **Total computers** for a list of computers and details about them, including: + +- Computer ID and computer name +- Computer manufacturer +- Computer model +- Operating system version and build +- Count of system requirement, application, and driver issues per computer +- Upgrade assessment based on analysis of computer diagnostic data +- Upgrade decision status + +Select **Total applications** for a list of applications discovered on user computers and details about them, including: + +- Application vendor +- Application version +- Count of computers the application is installed on +- Count of computers that opened the application at least once in the past 30 days +- Percentage of computers in your total computer inventory that opened the application in the past 30 days +- Issues detected, if any +- Upgrade assessment based on analysis of application data +- Rollup level diff --git a/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades.md b/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades.md index bb0ea00851..ccd157ea5e 100644 --- a/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades.md +++ b/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades.md @@ -14,6 +14,9 @@ ms.topic: article # Use Upgrade Readiness to manage Windows upgrades +>[!IMPORTANT] +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). + >[!IMPORTANT] >>**The OMS portal has been deprecated, so you need to switch to the [Azure portal](https://portal.azure.com) now.** The two portals offer the same experience, with some key differences. Learn how to use [Windows Analytics in the Azure Portal](../update/windows-analytics-azure-portal.md). Find out more about the [OMS portal moving to Azure](https://docs.microsoft.com/azure/log-analytics/log-analytics-oms-portal-transition), or jump right in and [Get started with Upgrade Readiness](https://docs.microsoft.com/windows/deployment/upgrade/upgrade-readiness-get-started). From 3b7cb0f19531f0a0a016696d62b1a80ac292fb93 Mon Sep 17 00:00:00 2001 From: jaimeo Date: Mon, 14 Oct 2019 11:04:59 -0700 Subject: [PATCH 07/11] fixing crosslinks --- .../deployment/upgrade/upgrade-readiness-additional-insights.md | 2 +- windows/deployment/upgrade/upgrade-readiness-architecture.md | 2 +- windows/deployment/upgrade/upgrade-readiness-data-sharing.md | 2 +- windows/deployment/upgrade/upgrade-readiness-deploy-windows.md | 2 +- .../deployment/upgrade/upgrade-readiness-deployment-script.md | 2 +- windows/deployment/upgrade/upgrade-readiness-get-started.md | 2 +- windows/deployment/upgrade/upgrade-readiness-identify-apps.md | 2 +- .../deployment/upgrade/upgrade-readiness-monitor-deployment.md | 2 +- windows/deployment/upgrade/upgrade-readiness-requirements.md | 2 +- windows/deployment/upgrade/upgrade-readiness-resolve-issues.md | 2 +- windows/deployment/upgrade/upgrade-readiness-target-new-OS.md | 2 +- .../deployment/upgrade/upgrade-readiness-upgrade-overview.md | 2 +- .../upgrade/use-upgrade-readiness-to-manage-windows-upgrades.md | 2 +- 13 files changed, 13 insertions(+), 13 deletions(-) diff --git a/windows/deployment/upgrade/upgrade-readiness-additional-insights.md b/windows/deployment/upgrade/upgrade-readiness-additional-insights.md index f1a72fa482..253142dec4 100644 --- a/windows/deployment/upgrade/upgrade-readiness-additional-insights.md +++ b/windows/deployment/upgrade/upgrade-readiness-additional-insights.md @@ -14,7 +14,7 @@ ms.collection: M365-analytics # Upgrade Readiness - Additional insights >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). This topic provides information on additional features that are available in Upgrade Readiness to provide insights into your environment. These include: diff --git a/windows/deployment/upgrade/upgrade-readiness-architecture.md b/windows/deployment/upgrade/upgrade-readiness-architecture.md index 1cfc2e4bc8..d9bc229c23 100644 --- a/windows/deployment/upgrade/upgrade-readiness-architecture.md +++ b/windows/deployment/upgrade/upgrade-readiness-architecture.md @@ -14,7 +14,7 @@ ms.collection: M365-analytics # Upgrade Readiness architecture >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). Microsoft analyzes system, application, and driver diagnostic data to help you determine when computers are upgrade-ready, allowing you to simplify and accelerate Windows upgrades in your organization. The diagram below illustrates how Upgrade Readiness components work together in a typical installation. diff --git a/windows/deployment/upgrade/upgrade-readiness-data-sharing.md b/windows/deployment/upgrade/upgrade-readiness-data-sharing.md index ec3030e57f..322316fb07 100644 --- a/windows/deployment/upgrade/upgrade-readiness-data-sharing.md +++ b/windows/deployment/upgrade/upgrade-readiness-data-sharing.md @@ -17,7 +17,7 @@ ms.collection: M365-analytics # Upgrade Readiness data sharing >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). To enable data sharing with the Upgrade Readiness solution, double-check the endpoints list in [Enrolling devices in Windows Analytics](../update/windows-analytics-get-started.md#enable-data-sharing) to be sure they are whitelisted. diff --git a/windows/deployment/upgrade/upgrade-readiness-deploy-windows.md b/windows/deployment/upgrade/upgrade-readiness-deploy-windows.md index e11b66977e..eb4c1d88d8 100644 --- a/windows/deployment/upgrade/upgrade-readiness-deploy-windows.md +++ b/windows/deployment/upgrade/upgrade-readiness-deploy-windows.md @@ -14,7 +14,7 @@ ms.collection: M365-analytics # Upgrade Readiness - Step 3: Deploy Windows >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). All of your work up to now involved reviewing and resolving application and driver issues. Along the way, as you’ve resolved issues and decided which applications and drivers are ready to upgrade, you’ve been building a list of computers that are upgrade ready. The blades in the **Deploy** section are: diff --git a/windows/deployment/upgrade/upgrade-readiness-deployment-script.md b/windows/deployment/upgrade/upgrade-readiness-deployment-script.md index f96cbdb0e3..1891acd137 100644 --- a/windows/deployment/upgrade/upgrade-readiness-deployment-script.md +++ b/windows/deployment/upgrade/upgrade-readiness-deployment-script.md @@ -17,7 +17,7 @@ ms.collection: M365-analytics # Upgrade Readiness deployment script >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). To automate the steps provided in [Get started with Upgrade Readiness](upgrade-readiness-get-started.md), and to troubleshoot data sharing issues, you can run the [Upgrade Readiness deployment script](https://go.microsoft.com/fwlink/?LinkID=822966&clcid=0x409), developed by Microsoft. diff --git a/windows/deployment/upgrade/upgrade-readiness-get-started.md b/windows/deployment/upgrade/upgrade-readiness-get-started.md index 7681eb53ba..19c322e4bf 100644 --- a/windows/deployment/upgrade/upgrade-readiness-get-started.md +++ b/windows/deployment/upgrade/upgrade-readiness-get-started.md @@ -19,7 +19,7 @@ ms.collection: M365-analytics # Get started with Upgrade Readiness >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). This topic explains how to obtain and configure Upgrade Readiness for your organization. diff --git a/windows/deployment/upgrade/upgrade-readiness-identify-apps.md b/windows/deployment/upgrade/upgrade-readiness-identify-apps.md index 3cddd6a4a7..61818a5efc 100644 --- a/windows/deployment/upgrade/upgrade-readiness-identify-apps.md +++ b/windows/deployment/upgrade/upgrade-readiness-identify-apps.md @@ -14,7 +14,7 @@ ms.collection: M365-analytics # Upgrade Readiness - Step 1: Identify important apps >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). This is the first step of the Upgrade Readiness workflow. In this step, applications are listed and grouped by importance level. Setting the importance level enables you to prioritize applications for upgrade. diff --git a/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md b/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md index dae35a58e1..50d11a0876 100644 --- a/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md +++ b/windows/deployment/upgrade/upgrade-readiness-monitor-deployment.md @@ -16,7 +16,7 @@ ms.collection: M365-analytics # Upgrade Readiness - Step 4: Monitor >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). Now that you have started deploying an update with Upgrade Readiness, you can use it to monitor important elements. diff --git a/windows/deployment/upgrade/upgrade-readiness-requirements.md b/windows/deployment/upgrade/upgrade-readiness-requirements.md index a6a8d7325a..fd00c603e7 100644 --- a/windows/deployment/upgrade/upgrade-readiness-requirements.md +++ b/windows/deployment/upgrade/upgrade-readiness-requirements.md @@ -16,7 +16,7 @@ ms.collection: M365-analytics # Upgrade Readiness requirements >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). This article introduces concepts and steps needed to get up and running with Upgrade Readiness. We recommend that you review this list of requirements before getting started as you may need to collect information, such as account credentials, and get approval from internal IT groups, such as your network security group, before you can start using Upgrade Readiness. diff --git a/windows/deployment/upgrade/upgrade-readiness-resolve-issues.md b/windows/deployment/upgrade/upgrade-readiness-resolve-issues.md index e9dab24950..2c58536bd5 100644 --- a/windows/deployment/upgrade/upgrade-readiness-resolve-issues.md +++ b/windows/deployment/upgrade/upgrade-readiness-resolve-issues.md @@ -16,7 +16,7 @@ ms.collection: M365-analytics # Upgrade Readiness - Step 2: Resolve app and driver issues >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). This section of the Upgrade Readiness workflow reports application and driver inventory and shows you which applications have known issues, which applications have no known issues, and which drivers have issues. We identify applications and drivers that need attention and suggest fixes when we know about them. diff --git a/windows/deployment/upgrade/upgrade-readiness-target-new-OS.md b/windows/deployment/upgrade/upgrade-readiness-target-new-OS.md index 852b31c569..78c11d1569 100644 --- a/windows/deployment/upgrade/upgrade-readiness-target-new-OS.md +++ b/windows/deployment/upgrade/upgrade-readiness-target-new-OS.md @@ -14,7 +14,7 @@ ms.collection: M365-analytics # Targeting a new operating system version >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). After you've used Upgrade Readiness to help deploy a given version of Windows 10, you might want to use it again to help deploy a newer version of Windows 10. When you change the target operating system version (as described in [Use Upgrade Readiness to manage Windows upgrades](use-upgrade-readiness-to-manage-windows-upgrades.md#target-version)), the app states (Importance, AppOwner, UpgradeDecision, TestPlan, and TestResult) are not reset. Follow this guidance to preserve or reset these states as needed: diff --git a/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md b/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md index ea1c4c369a..b78fcd2044 100644 --- a/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md +++ b/windows/deployment/upgrade/upgrade-readiness-upgrade-overview.md @@ -14,7 +14,7 @@ ms.collection: M365-analytics # Upgrade Readiness - Upgrade overview >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). The first blade in the Upgrade Readiness solution is the upgrade overview blade. This blade displays the total count of computers sharing data with Microsoft, and the count of computers upgraded. As you successfully upgrade computers, the count of computers upgraded increases. diff --git a/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades.md b/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades.md index ccd157ea5e..8faa48539f 100644 --- a/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades.md +++ b/windows/deployment/upgrade/use-upgrade-readiness-to-manage-windows-upgrades.md @@ -15,7 +15,7 @@ ms.topic: article # Use Upgrade Readiness to manage Windows upgrades >[!IMPORTANT] ->The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Update Compliance](update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). +>The Upgrade Readiness and Device Health solutions of Windows Analytics are being retired on January 31, 2020. [Get started with Update Compliance](../update/update-compliance-get-started.md) will continue to be supported. For more information, see [Windows Analytics retirement on January 31, 2020](https://support.microsoft.com/en-us/help/4521815/windows-analytics-retirement). >[!IMPORTANT] >>**The OMS portal has been deprecated, so you need to switch to the [Azure portal](https://portal.azure.com) now.** The two portals offer the same experience, with some key differences. Learn how to use [Windows Analytics in the Azure Portal](../update/windows-analytics-azure-portal.md). Find out more about the [OMS portal moving to Azure](https://docs.microsoft.com/azure/log-analytics/log-analytics-oms-portal-transition), or jump right in and [Get started with Upgrade Readiness](https://docs.microsoft.com/windows/deployment/upgrade/upgrade-readiness-get-started). From b554690dbedf33006abf7e2c5ff4765acf01f577 Mon Sep 17 00:00:00 2001 From: John Kaiser <35939694+CoveMiner@users.noreply.github.com> Date: Tue, 15 Oct 2019 10:12:42 -0700 Subject: [PATCH 08/11] Updates for new products --- devices/surface/TOC.md | 16 +++++++++++----- devices/surface/get-started.md | 15 ++++++++------- devices/surface/surface-dock-firmware-update.md | 6 ++++++ .../surface/wake-on-lan-for-surface-devices.md | 6 +++--- 4 files changed, 28 insertions(+), 15 deletions(-) diff --git a/devices/surface/TOC.md b/devices/surface/TOC.md index 3a335c36cb..8c64a598e4 100644 --- a/devices/surface/TOC.md +++ b/devices/surface/TOC.md @@ -3,13 +3,17 @@ ## [Get started](get-started.md) ## Overview -### [Surface Pro Tech specs](https://www.microsoft.com/surface/devices/surface-pro/tech-specs) -### [Surface Book Tech specs](https://www.microsoft.com/surface/devices/surface-book/tech-specs) -### [Surface Studio Tech specs](https://www.microsoft.com/surface/devices/surface-studio/tech-specs) -### [Surface Go Tech specs](https://www.microsoft.com/surface/devices/surface-go/tech-specs) -### [Surface Laptop 2 Tech specs](https://www.microsoft.com/surface/devices/surface-laptop/tech-specs) + +### [Surface Pro 7 for Business](https://www.microsoft.com/surface/business/surface-pro-7) +### [Surface Pro X for Business](https://www.microsoft.com/surface/business/surface-pro-x) +### [Surface Laptop 3 for Business](https://www.microsoft.com/surface/business/surface-laptop-3) +### [Surface Book 2 for Business](https://www.microsoft.com/surface/business/surface-book-2) +### [Surface Studio 2 for Business](https://www.microsoft.com/surface/business/surface-studio-2) +### [Surface Go](https://www.microsoft.com/surface/business/surface-go) +### [Secure, work-anywhere mobility with LTE Advanced](https://www.microsoft.com/surface/business/lte-laptops-and-tablets) ## Plan + ### [Surface device compatibility with Windows 10 Long-Term Servicing Branch](surface-device-compatibility-with-windows-10-ltsc.md) ### [Long-Term Servicing Branch for Surface devices](ltsb-for-surface.md) ### [Wake On LAN for Surface devices](wake-on-lan-for-surface-devices.md) @@ -19,6 +23,7 @@ ### [Ethernet adapters and Surface deployment](ethernet-adapters-and-surface-device-deployment.md) ## Deploy + ### [Deploy Surface devices](deploy.md) ### [Windows Autopilot and Surface devices](windows-autopilot-and-surface-devices.md) ### [Deploying, managing, and servicing Surface Pro X](surface-pro-arm-app-management.md) @@ -33,6 +38,7 @@ ### [Surface System SKU reference](surface-system-sku-reference.md) ## Manage + ### [Optimize Wi-Fi connectivity for Surface devices](surface-wireless-connect.md) ### [Best practice power settings for Surface devices](maintain-optimal-power-settings-on-Surface-devices.md) ### [Surface Dock Firmware Update](surface-dock-firmware-update.md) diff --git a/devices/surface/get-started.md b/devices/surface/get-started.md index 407e12ba82..1bcf364edd 100644 --- a/devices/surface/get-started.md +++ b/devices/surface/get-started.md @@ -14,7 +14,7 @@ ms.localizationpriority: High --- # Get started with Surface devices -Harness the power of Surface, Windows, and Office connected together through the cloud. Find tools, step-by-step guides, and other resources to help you plan, deploy, and manage Surface devices in your organization. +Harness the power of Surface, Windows,and Office connected together through the cloud. Find tools, step-by-step guides, and other resources to help you plan, deploy, and manage Surface devices in your organization.