Updates from: 01/21/2022 02:46:36
Category Microsoft Docs article Related commit history on GitHub Change details
admin Add Another Email Alias For A User https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/admin/email/add-another-email-alias-for-a-user.md
You must have Global Admin rights to add email aliases to a user.
> [!IMPORTANT] > If you purchased your subscription from GoDaddy or another Partner, to set the new alias as the primary, you must go to the GoDaddy/partner management console. ++
+ > [!IMPORTANT]
+ > If you get the error message **This user is synchronized with your local Active DirectoryΓÇÄ. Some details can be edited only through your local Active Directory**, It means that the Active Directory is authoritative for attributes on synchronized users, you need to modify the attributes in your on-premises Active Directory.
> [!TIP] > The email alias must end with a domain from the drop-down list. To add another domain name to the list, see [Add a domain to Microsoft 365](../setup/add-domain.md).
admin Set Password Expiration Policy https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/admin/manage/set-password-expiration-policy.md
description: "Learn how an admin can set a password expiration policy for your b
## Before you begin
-This article is for people who set password expiration policy for a business, school, or nonprofit. To complete these steps, you need to sign in with your Microsoft 365 admin account. [What's an admin account?](Overview of the Microsoft 365 admin center](../admin-overview/admin-center-overview.md).
+This article is for people who set password expiration policy for a business, school, or nonprofit. To complete these steps, you need to sign in with your Microsoft 365 admin account. [What's an admin account?](/microsoft-365/admin/add-users/about-admin-roles).
As an admin, you can make user passwords expire after a certain number of days, or set passwords to never expire. By default, passwords are set to never expire for your organization.
admin Add Domain https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/admin/setup/add-domain.md
Each Microsoft 365 organization can have up to three onmicrosoft.com domains.
> [!NOTE] > You must be a Global admin or a Domain Name admin to add a domain.
+> Creating an additional .onmicrosoft domain and using it as your default will not do a rename for SharePoint Online. To make changes to your .onmicrosoft SharePoint domain you would need to use the [SharePoint domain rename preview](/sharepoint/change-your-sharepoint-domain-name) (currently available to any tenant with less than 1,000 sites).
+> If you're using Microsoft 365 mail services, removal of your initial .onmicrosoft domain is not supported.
To add an onmicrosoft.com domain:
commerce Cancel Your Subscription https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/commerce/subscriptions/cancel-your-subscription.md
- AdminSurgePortfolio - commerce_subscriptions - AdminTemplateSet
+- admindeeplinkMAC
search.appverid: MET150
-description: "If you have fewer than 25 user licenses, you can cancel your Microsoft 365 for business trial or paid subscription in the admin center."
Previously updated : 09/16/2021
+description: "Learn how to cancel your Dynamics 365, Intune, Power Platform, and Microsoft 365 for business trial or paid subscriptions in the Microsoft 365 admin center."
Last updated : 01/20/2022 # Cancel your subscription
-> [!IMPORTANT]
-> This article only applies to Microsoft 365 for business subscriptions. If you have Microsoft 365 Family or Personal, see [Cancel a Microsoft 365 subscription](https://support.microsoft.com/en-us/office/cancel-a-microsoft-365-subscription-46e2634c-c64b-4c65-94b9-2cc9c960e91b?OCID=M365_DocsCancel_Link).
-
-*Eligibility:* If you have fewer than 25 licenses assigned to users, you can cancel your Microsoft 365 for business trial or paid subscription online in the Microsoft 365 admin center at any time. If you have more than 25 licenses assigned to users, reduce it to less than 25 or [call support to cancel your subscription](../../admin/get-help-support.md).
+You can cancel your subscription at any time in the <a href="https://go.microsoft.com/fwlink/p/?linkid=2024339" target="_blank">Microsoft 356 admin center</a>. However, to receive a refund, you must meet certain refund eligibility requirements. For more information, see [Understand refund eligibility](#understand-refund-eligibility).
-*Refund:* Any prorated credit will be returned to you within the next billing cycle.
+If you have multiple subscriptions to the same product, such as Microsoft 365 Business Premium, canceling one subscription wonΓÇÖt impact the purchased licenses or services inside the others.
-> [!NOTE]
->
-> - If you have multiple subscriptions to the same product, such as Microsoft 365 Business Premium, canceling one of them will not impact the purchased licenses or services inside the other subscriptions.
-> - For some subscriptions, you can only cancel during a limited window of time after you buy or renew your subscription. If the cancellation window has passed, turn off recurring billing to cancel the subscription at the end of its term.
+> [!IMPORTANT]
+> This article only applies to Dynamics 365, Intune, Power Platform, and Microsoft 365 for business subscriptions. If you have Microsoft 365 Family or Personal, see [Cancel a Microsoft 365 subscription](https://support.microsoft.com/office/cancel-a-microsoft-365-subscription-46e2634c-c64b-4c65-94b9-2cc9c960e91b?OCID=M365_DocsCancel_Link).
## Before you begin You must be a Global or Billing admin to do the tasks in this article. For more information, see [About admin roles](../../admin/add-users/about-admin-roles.md).
+## Understand refund eligibility
+
+### If you have a billing profile
+
+You must cancel within 72 hours of starting a paid subscription to get a prorated refund for unused time you already paid for. Refunds arenΓÇÖt available after 72 hours.
+
+For example, let's say you bought a one year subscription for which you pay $20 each month for a single license. You bought the subscription on February 1, 2022 at 11 AM UST, and decide to cancel it on February 3, 2022 at 11 AM UST. We deduct $1.43 for the two days you held the subscription, and you receive a prorated refund of $18.57.
+
+**Not sure if you have a billing profile?** To learn how to find out if you have a billing profile, see [View my billing profiles](../billing-and-payments/manage-billing-profiles.md#view-my-billing-profiles).
+
+### If you don't have a billing profile
+
+Use the following table to help determine if you can cancel your subscription yourself.
+
+|If your subscription has |You can |
+|--|--|
+|25 or fewer licenses | Cancel your trial or paid subscription online in the <a href="https://go.microsoft.com/fwlink/p/?linkid=2024339" target="_blank">Microsoft 356 admin center</a> at any time. |
+|More than 25 licenses | Reduce the number of licenses to 25 or fewer and try again, or [call support to cancel your subscription](../../admin/get-help-support.md). |
+
+For subscriptions that don't have a billing profile, you can only cancel during a limited window of time after you buy or renew your subscription. If the cancellation window has passed, [turn off recurring billing](renew-your-subscription.md) to cancel the subscription at the end of its term.
+
+If you cancel during the limited time window, any prorated credit will be returned to you within the next billing cycle.
+ ## Steps to cancel your subscription If you added your own domain name to use with your subscription, you must remove the domain before you cancel your subscription. For more information, see [Remove a domain](../../admin/get-help-with-domains/remove-a-domain.md).
compliance Device Onboarding Macos Overview https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/compliance/device-onboarding-macos-overview.md
description: Learn about onboarding macOS devices into Compliance solutions
MacOS devices can be onboarded into Microsoft 365 compliance solutions using either Intune or JAMF Pro. The onboarding procedures differ depending on which management solution you are using. If your macOS devices have already been onboarded into Microsoft Defender for Endpoint (MDE), there are fewer steps. See [Next steps](#next-steps) for links to the appropriate procedures for you.
-## Get registered
-
-To get access to this feature, you must register your tenant with Microsoft. See, [get registered for Microsoft 365 macOS support](https://aka.ms/EndpointDLPIgnite21-Previews).
- **Applies to:** - [Microsoft 365 Endpoint data loss prevention (DLP)](./endpoint-dlp-learn-about.md)
compliance Device Onboarding Offboarding Macos Intune Mde https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/compliance/device-onboarding-offboarding-macos-intune-mde.md
description: Learn how to onboard and offboard macOS devices into Microsoft 365
> [!IMPORTANT] > Use this procedure ***if you have*** deployed Microsoft Defender for Endpoint (MDE) to your macOS devices
-## Get registered
-
-To get access to this feature, you must register your tenant with Microsoft. See, [get registered for Microsoft 365 macOS support](https://aka.ms/EndpointDLPIgnite21-Previews).
- **Applies to:** - Customers who have MDE deployed to their macOS devices.
compliance Device Onboarding Offboarding Macos Intune https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/compliance/device-onboarding-offboarding-macos-intune.md
You can use Intune to onboard macOS devices into Microsoft 365 compliance soluti
> [!IMPORTANT] > Use this procedure if you ***do not*** have Microsoft Defender for Endpoint (MDE) deployed to your macOS devices
-## Get registered
-
-To get access to this feature, you must register your tenant with Microsoft. See, [get registered for Microsoft 365 macOS support](https://aka.ms/EndpointDLPIgnite21-Previews).
- **Applies to:** - [Microsoft 365 Endpoint data loss prevention (DLP)](./endpoint-dlp-learn-about.md)
compliance Device Onboarding Offboarding Macos Jamfpro Mde https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/compliance/device-onboarding-offboarding-macos-jamfpro-mde.md
You can use JAMF Pro to onboard macOS devices into Microsoft 365 compliance solu
> [!IMPORTANT] > Use this procedure ***if you have*** deployed Microsoft Defender for Endpoint (MDE) to your macOS devices
-## Get registered
-
-To get access to this feature, you must register your tenant with Microsoft. See, [get registered for Microsoft 365 macOS support](https://aka.ms/EndpointDLPIgnite21-Previews).
- **Applies to:** - Customers who have MDE deployed to their macOS devices.
compliance Device Onboarding Offboarding Macos Jamfpro https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/compliance/device-onboarding-offboarding-macos-jamfpro.md
You can use JAMF Pro to onboard macOS devices into Microsoft 365 compliance solu
> [!IMPORTANT] > Use this procedure if you ***do not*** have Microsoft Defender for Endpoint (MDE) deployed to your macOS devices
-## Get registered
-
-To get access to this feature, you must register your tenant with Microsoft. See, [get registered for Microsoft 365 macOS support](https://aka.ms/EndpointDLPIgnite21-Previews).
- **Applies to:** - [Microsoft 365 Endpoint data loss prevention (DLP)](./endpoint-dlp-learn-about.md)
compliance Dlp Conditions And Exceptions https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/compliance/dlp-conditions-and-exceptions.md
The tables in the following sections describe the conditions and exceptions that
### Senders If you use the sender address as a condition or exception the actual field where the value is looked for varies depending on the type of rule you use. For DLP based rules, the Envelope address is used as the sender address. For Exchange transport rules the Header address is used as the sender address.
-<!-- REMOVE COMMENTS ON 1/20/2022
+ > [!NOTE] > Starting January 20, 2022, the default sender address location will be moved to the Header address along with the availability of the -SenderAddressLocation parameter to configure desired behavior at a DLP rule level.
To configure the sender address location at a DLP rule level, the parameter is _
- **Header or envelope** (`HeaderOrEnvelope`) Examine senders in the message header and the message envelope. <br>> |condition or exception in DLP|condition/exception parameters in Microsoft 365 PowerShell|property type|description| |||||
Prepend subject|PrependSubject|String|Adds the specified text to the beginning o
|Modify Subject|ModifySubject|PswsHashTable | Remove text from the subject line that matches a specific pattern and replace it with different text. See the example below. You can: </br>- **Replace** all matches in the subject with the replacement text </br>- **Append** to remove all matches in the subject and inserts the replacement text at the end of the subject. </br>- **Prepend** to remove all matches and inserts the replacement text at the beginning of the subject.| |Apply HTML disclaimer|ApplyHtmlDisclaimer|First property: *Text*</br>Second property: *Location*</br>Third property: *Fallback action*|Applies the specified HTML disclaimer to the required location of the message.</br>This parameter uses the syntax: @{ Text = ΓÇ£ ΓÇ¥ ; Location = <Append \|Prepend>; FallbackAction = <Wrap \|Ignore \|Reject> }| |Remove Office 365 Message Encryption and rights protection|RemoveRMSTemplate|n/a|Removes Office 365 encryption applied on an email|
+|Deliver the message to the hosted quarantine |_Quarantine_|n/a| This action is currently in **public preview**. During this phase, emails quarantined by DLP policies will show policy type as ExchangeTransportRule.</br> Delivers the message to the quarantine in EOP. For more information, see [Quarantined email messages in EOP](/microsoft-365/security/office-365-security/quarantine-email-messages).|
|
compliance Dlp On Premises Scanner Get Started https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/compliance/dlp-on-premises-scanner-get-started.md
Before you get started with DLP on-premises scanner, you should confirm your [Mi
For full licensing details see: [Microsoft 365 licensing guidance for security & compliance](/office365/servicedescriptions/microsoft-365-service-descriptions/microsoft-365-tenantlevel-services-licensing-guidance/microsoft-365-security-compliance-licensing-guidance)
+> [!IMPORTANT]
+> All users who contribute to the scanned location either by adding files or consuming files need to have a license, not just the scanner user.
+ ### Permissions Data from DLP on-premises scanner can be viewed in [Activity explorer](data-classification-activity-explorer.md). There are four roles that grant permission to activity explorer, the account you use for accessing the data must be a member of any one of them.
Now that you have deployed a test policy for DLP on-premises locations and can v
- [Learn about data loss prevention](dlp-learn-about-dlp.md) - [Create, test, and tune a DLP policy](create-test-tune-dlp-policy.md) - [Get started with Activity explorer](data-classification-activity-explorer.md)-- [Microsoft 365 subscription](https://www.microsoft.com/microsoft-365/compare-microsoft-365-enterprise-plans?rtc=1)
+- [Microsoft 365 subscription](https://www.microsoft.com/microsoft-365/compare-microsoft-365-enterprise-plans?rtc=1)
compliance Endpoint Dlp Using https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/compliance/endpoint-dlp-using.md
Or
### Advanced classification scanning and protection
-<!--#### Get registered
-
-To get access to this feature, you must register your tenant with Microsoft. See, [get registered for Microsoft 365 macOS support](https://aka.ms/EndpointDLPIgnite21-Previews).
-
-When enabled,-->
- Advanced classification scanning and protection allows the more advanced Microsoft 365 cloud based data classification service to scan items, classify them and return the results to the local machine. This means you can take advantage of [exact data match](create-custom-sensitive-information-types-with-exact-data-match-based-classification.md) classification, [named entities (preview)](named-entities-learn.md#learn-about-named-entities-preview) classification techniques in your DLP policies. In advanced classification, content is sent from the local device to the cloud services for scanning and classification. If bandwidth utilization is a concern, you can set a limit in this global setting that is applied per device on how much can be used in a rolling 24 hour period. If you set a bandwidth utilization limit and it is exceeded, DLP stops sending the user content to the cloud and data classification will continue locally on the device. When the cumulative bandwidth utilization drops below the rolling 24 hour limit, communication with the cloud services will resume.
compliance Get Started With Sensitivity Labels https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/compliance/get-started-with-sensitivity-labels.md
All scenarios require you to [Create and configure sensitivity labels and their
|I want to ...|Documentation| |-|| |Manage sensitivity labels for Office apps so that content is labeled as it's createdΓÇöincludes support for manual labeling on all platforms |[Manage sensitivity labels in Office apps](sensitivity-labels-office-apps.md)|
-|Enable users to label and protect files from Windows computers using Office apps, File Explorer, and PowerShell|[Azure Information Protection unified labeling client for Windows](/azure/information-protection/rms-client/aip-clientv2)|
+|Extend labeling beyond Office apps by using File Explorer and PowerShell, with additional features for Office apps on Windows (if needed)|[Azure Information Protection unified labeling client for Windows](/azure/information-protection/rms-client/aip-clientv2)|
|Encrypt documents and emails with sensitivity labels and restrict who can access that content and how it can be used |[Restrict access to content by using sensitivity labels to apply encryption](encryption-sensitivity-labels.md)| |Enable sensitivity labels for Office on the web, with support for coauthoring, eDiscovery, data loss prevention, searchΓÇöeven when documents are encrypted | [Enable sensitivity labels for Office files in SharePoint and OneDrive](sensitivity-labels-sharepoint-onedrive-files.md) |Use co-authoring and AutoSave in Office desktop apps when documents are encrypted | [Enable co-authoring for files encrypted with sensitivity labels](sensitivity-labels-coauthoring.md)
contentunderstanding Powershell Syntex Explanations https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/contentunderstanding/powershell-syntex-explanations.md
- m365initiative-syntex search.appverid: MET150 ms.localizationpriority: normal
-description: "Learn about work with SharePoint Syntex document understanding model explanations in PowerShell"
+description: "Learn about work with SharePoint Syntex document understanding model explanations in PowerShell."
+ # Work with document understanding model explanations in PowerShell > [!IMPORTANT]
Add-PnPListItem -List $explanationTemplatesList -Values @{"Title"= $explanationN
## Create a phrase list explanation based on a term set
-This example shows how to create a custom phrase list explanation template, by taking the values from a term set. This includes the preferred term names and any synonyms.
+This example shows how to create a custom phrase list explanation template by taking the values from a term set. This includes the preferred term names and any synonyms.
```PowerShell $contentCenterURL = "https://contoso.sharepoint.com/sites/yourContentCenter"
contentunderstanding Powershell Syntex Import Export https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/contentunderstanding/powershell-syntex-import-export.md
- m365initiative-syntex search.appverid: MET150 ms.localizationpriority: normal
-description: "Learn about how to export and import document understanding models with PowerShell in SharePoint Syntex"
+description: "Learn about how to export and import document understanding models with PowerShell in SharePoint Syntex."
# Export and import document understanding models with PowerShell
description: "Learn about how to export and import document understanding models
> [!IMPORTANT] > The SharePoint Syntex PowerShell cmdlets and all other PnP components are open-source tools backed by an active community providing support for them. There is no SLA for open-source tool support from official Microsoft support channels.
-SharePoint Syntex models can be exported as PnP templates, enabling reuse across Content Centers or tenants.
+SharePoint Syntex models can be exported as PnP templates, enabling reuse across content centers or tenants.
-## Export all models in a Content Center
+## Export all models in a content center
-To export all models in a Content Center into a single PnP template, use the following [PnP PowerShell](https://pnp.github.io/powershell/) cmdlets:
+To export all models in a content center into a single PnP template, use the following [PnP PowerShell](https://pnp.github.io/powershell/) cmdlets:
```powershell Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Get-PnPSiteTemplate -Out MyModels.pnp -Handlers SyntexModels ```
-## Export Specific Models
+## Export specific models
-To export specific models from a Content Center into a PnP template, use the following [PnP PowerShell](https://pnp.github.io/powershell/) cmdlets:
+To export specific models from a content center into a PnP template, use the following [PnP PowerShell](https://pnp.github.io/powershell/) cmdlets:
```powershell Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Get-PnPSiteTemplate -Out MyModels.pnp -Configuration .\extract.json ```
-The extract.json defines which models you want to export, allowing to specify model by name or ID and optionally configuring to not extract training data
+The extract.json defines which models you want to export, allowing to specify model by name or ID and optionally configuring to not extract training data.
-### Example- Specify model by name
+### Example - Specify model by name
```json {
The extract.json defines which models you want to export, allowing to specify mo
} ```
-### Example- Specify model by ID
+### Example - Specify model by ID
```json {
The extract.json defines which models you want to export, allowing to specify mo
If you do not include the property "includeTrainingData", the default behavior is to include.
-> NOTE: training data is required for a model to be editable when imported to a destination Content Center
+> [!NOTE]
+> Training data is required for a model to be editable when imported to a destination content center.
## Import models to a content center Document understanding models that have been exported to PnP templates can be imported to a content center on any tenant. If the export included training data, then the model will be editable once imported.
contentunderstanding Powershell Syntex Intro https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/contentunderstanding/powershell-syntex-intro.md
- m365initiative-syntex search.appverid: MET150 ms.localizationpriority: normal
-description: "Learn how to manage SharePoint Syntex with PowerShell"
+description: "Learn how to manage SharePoint Syntex with PowerShell."
# Manage SharePoint Syntex with PowerShell
description: "Learn how to manage SharePoint Syntex with PowerShell"
> [!IMPORTANT] > The SharePoint Syntex PowerShell cmdlets and all other PnP components are open-source tools backed by an active community providing support for them. There is no SLA for open-source tool support from official Microsoft support channels.
-For these scenarios, the SharePoint Syntex cmdlets in the PnP PowerShell module can be used to interact with models and explanations. To learn more about how to install this module, see [**PnP PowerShell overview**](/powershell/sharepoint/sharepoint-pnp/sharepoint-pnp-cmdlets)
+For these scenarios, the SharePoint Syntex cmdlets in the PnP PowerShell module can be used to interact with models and explanations. To learn more about how to install this module, see [PnP PowerShell overview](/powershell/sharepoint/sharepoint-pnp/sharepoint-pnp-cmdlets).
-Select from the following topics to learn how to use PowerShell to manage Syntex:
+Select from the following scenarios to learn how to use PowerShell to manage SharePoint Syntex:
- [**Import and Export Models**](powershell-syntex-import-export.md)
Select from the following topics to learn how to use PowerShell to manage Syntex
- [**Processing**](powershell-syntex-processing.md)
- Start here if you want to learn how to use PowerShell to trigger document understanding processing on a document library
+ Start here if you want to learn how to use PowerShell to trigger document understanding processing on a document library.
- [**Explanations**](powershell-syntex-explanations.md)
contentunderstanding Powershell Syntex Processing https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/contentunderstanding/powershell-syntex-processing.md
description: "Learn how to use PowerShell to request processing by a SharePoint
> [!IMPORTANT] > The SharePoint Syntex PowerShell cmdlets and all other PnP components are open-source tools backed by an active community providing support for them. There is no SLA for open-source tool support from official Microsoft support channels.
-Document understanding models will process newly uploaded files to a library. It is also possible to manually request processing in the UI. However there may be scenarios where it is more efficient to trigger processing through PowerShell.
+Document understanding models will process newly uploaded files to a library. It is also possible to manually request processing in the UI. However there might be scenarios where it is more efficient to trigger processing through PowerShell.
## Request processing of all items that have not been previously classified
For lower priority processing, you might also consider using the -OffPeak parame
## Request processing of all items in a library
-You can request processing of all files in the library, even if they have previously been classified. This may be useful if you have updated a model or added another model to the library.
+You can request processing of all files in the library, even if they have previously been classified. This might be useful if you have updated a model or added another model to the library.
```PowerShell #Note: you're connecting here to the site that holds the document library you want to process
Request-PnPSyntexClassifyAndExtract -List "Documents" -Force
``` > [!NOTE]
-> Using the -Force option with more than 5000 items will automatcially enable off peak processing.
+> Using the -Force option with more than 5000 items will automatically enable off peak processing.
## Request processing of all items based on a property
-If you want to limit processing to a specific subset of items in a library, you can use a script to select a specific group of files. In the below example, the script allows a field to be selected, and a field value to filter by. More complex queries can be completed using [Get-PnPListItem](https://pnp.github.io/powershell/cmdlets/Get-PnPListItem.html).
+If you want to limit processing to a specific subset of items in a library, you can use a script to select a specific group of files. In the following example, the script allows a field to be selected, and a field value to filter by. More complex queries can be completed using [Get-PnPListItem](https://pnp.github.io/powershell/cmdlets/Get-PnPListItem.html).
```PowerShell #Note: you're connecting here to the site that holds the document library you want to process
contentunderstanding Powershell Syntex Publishing https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/contentunderstanding/powershell-syntex-publishing.md
description: "Learn how to publish a SharePoint Syntex document understanding mo
> [!IMPORTANT] > The SharePoint Syntex PowerShell cmdlets and all other PnP components are open-source tools backed by an active community providing support for them. There is no SLA for open-source tool support from official Microsoft support channels.
-SharePoint Syntex Models typically are deployed to document libraries across your tenant. This can be done by using the Content Center site, but this can also be done using [PnP PowerShell](https://pnp.github.io/powershell/) as explained in this article.
+SharePoint Syntex models typically are deployed to document libraries across your tenant. This can be done by using the content center site, but this can also be done using [PnP PowerShell](https://pnp.github.io/powershell/) as explained in this article.
-## Listing the available models in a Content Center
+## Listing the available models in a content center
-To get an overview of the models added to the current SharePoint Syntex Content Center site use the [Get-PnPSyntexModel](https://pnp.github.io/powershell/cmdlets/Get-PnPSyntexModel.html) cmdlet:
+To get an overview of the models added to the current SharePoint Syntex content center site, use the [Get-PnPSyntexModel](https://pnp.github.io/powershell/cmdlets/Get-PnPSyntexModel.html) cmdlet:
```PowerShell Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Get-PnPSyntexModel
## Apply a model to a library
-To apply a model to a library you can use the [Publish-PnPSyntexModel](https://pnp.github.io/powershell/cmdlets/Publish-PnPSyntexModel.html) cmdlet:
+To apply a model to a library, use the [Publish-PnPSyntexModel](https://pnp.github.io/powershell/cmdlets/Publish-PnPSyntexModel.html) cmdlet:
```PowerShell Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Publish-PnPSyntexModel -Model "Contract Notice" -ListWebUrl "https://contoso.sha
## Understanding where a model is used
-Once you've deployed a model to many libraries you might want to review the list of libraries using your model. This can be done using the [Get-PnPSyntexModelPublication](https://pnp.github.io/powershell/cmdlets/Get-PnPSyntexModelPublication.html) cmdlet:
+Once you've deployed a model to many libraries, you might want to review the list of libraries using your model. This can be done using the [Get-PnPSyntexModelPublication](https://pnp.github.io/powershell/cmdlets/Get-PnPSyntexModelPublication.html) cmdlet:
```PowerShell Connect-PnPOnline -Url "https://contoso.sharepoint.com/sites/yourContentCenter"
Unpublish-PnPSyntexModel -Model "Invoice model" -ListWebUrl "https://contoso.sha
## Apply models in bulk
-If you want to publish multiple models to multiple libraries, then
-
-First, create an input CSV file listing the models and the target locations:
+If you want to publish multiple models to multiple libraries, create an input CSV file listing the models and the target locations:
```CSV ModelName,TargetSiteUrl,TargetWebServerRelativeUrl,TargetLibraryServerRelativeUrl
Contract Notice,https://contoso.sharepoint.com/sites/Site1,/sites/Site1,/sites/s
Trade Confirmation,https://contoso.sharepoint.com/sites/Site2,/sites/Site2,/sites/site2/shared%20documents ```
-This CSV file can then be used as an input into a script that will publish the listed models to the appropriate libraries. In the below example batching is used to increase the efficiency of the requests
+This CSV file can then be used as an input into a script that will publish the listed models to the appropriate libraries. In the following example, batching is used to increase the efficiency of the requests.
```PowerShell $contentCenterURL = "https://contoso.sharepoint.com/sites/yourSite"
security Api Portal Mapping https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/security/defender-endpoint/api-portal-mapping.md
Title: Microsoft Defender for Endpoint alert fields
-description: Understand how the alert fields map to the values in Microsoft Defender for Endpoint
+ Title: Microsoft Defender for Endpoint detection fields
+description: Understand how the detection fields map to the values in Microsoft Defender for Endpoint
keywords: detections, detections fields, fields, api, fields, pull Detections, rest api, request, response search.appverid: met150 ms.prod: m365-security
ms.technology: mde
-# Microsoft Defender for Endpoint alert fields
+# Microsoft Defender for Endpoint detection fields
[!INCLUDE [Microsoft 365 Defender rebranding](../../includes/microsoft-defender.md)]
> Want to experience Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-apiportalmapping-abovefoldlink)
+> [!NOTICE]
+> The Microsoft Defender for Endpoint SIEM REST API is planned for deprecation, as the Microsoft Defender for Endpoint Alert API and the Microsoft 365 Defender Incident API that replace it provide much richer metadata - including the up-to-date status of the alert, all evidence entities that are related to the alert, all comments entered by analysts, and allows updating status, assignedTo, classification, and determination fields programmatically.
+>
+> No new onboarding to the Microsoft Defender for Endpoint SIEM API will be supported - instead, see [Enable SIEM integration in Defender for Endpoint](enable-siem-integration.md) for more information on integrating with the Microsoft Defender for Endpoint Alert API or the Microsoft 365 Defender Incident API.
+>
+> For information on integration SIEM Tools (Splunk, ArcSight, and QRadar), see [Integrate your SIEM tools with Microsoft Defender for Endpoint](../defender-endpoint/configure-siem.md).
+ Understand what data fields are exposed as part of the detections API and how they map to Microsoft 365 Defender. > [!NOTE] >
-> - [Defender for Endpoint Alert](alerts.md) is composed from one or more detections.
-> - **Microsoft Defender ATP Detection** is composed from the suspicious event occurred on the Device and its related **Alert** details.
+> - [Microsoft Defender for Endpoint Alert](alerts.md) is composed from one or more detections.
+> - **Microsoft Defender for Endpoint Detection** is composed from the suspicious event occurred on the Device and its related **Alert** details.
> - The Microsoft Defender for Endpoint Alert API is the latest API for alert consumption and contain a detailed list of related evidence for each alert. For more information, see [Alert methods and properties](alerts.md) and [List alerts](get-alerts.md). ## Detections API fields and portal mapping The following table lists the available fields exposed in the detections API payload. It shows examples for the populated values and a reference on how data is reflected on the portal.-
+>
+> The MicroFocus ArcSight FlexConnector described below has been replaced with an official SmartConnector that calls the Microsoft 365 Defender Incident API. For more information, see [Enable SIEM integration in Defender for Endpoint](enable-siem-integration.md).
+>
The ArcSight field column contains the default mapping between the Defender for Endpoint fields and the built-in fields in ArcSight. You can download the mapping file from the portal when you enable the SIEM integration feature and you can modify it to match the needs of your organization. For more information, see [Enable SIEM integration in Defender for Endpoint](enable-siem-integration.md). Field numbers match the numbers in the images below.
security Configure Server Endpoints https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/security/defender-endpoint/configure-server-endpoints.md
The following specifics apply to the new unified solution package for Windows Se
- Operating system upgrades are not supported. Offboard then uninstall before upgrading. - Automatic exclusions for *server roles* are not supported on Windows Server 2012 R2; however, built-in exclusions for operating system files are. For more information about adding exclusions, see [Virus scanning recommendations for Enterprise computers that are running currently supported versions of Windows](https://support.microsoft.com/topic/virus-scanning-recommendations-for-enterprise-computers-that-are-running-currently-supported-versions-of-windows-kb822158-c067a732-f24a-9079-d240-3733e39b40bc). + <a name="integration-with-azure-defender"></a> ## Integration with Microsoft Defender for Cloud
security Live Response https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/security/defender-endpoint/live-response.md
-
+
Title: Investigate entities on devices using live response in Microsoft Defender for Endpoint description: Access a device using a secure remote shell connection to do investigative work and take immediate response actions on a device in real time. keywords: remote, shell, connection, live, response, real-time, command, script, remediate, hunt, export, log, drop, download, file,
Before you can initiate a session on a device, make sure you fulfill the followi
- [Version 1803 (RS 4)](/windows/whats-new/whats-new-windows-10-version-1803) with [KB4537795](https://support.microsoft.com/help/4537795/windows-10-update-kb4537795) - [Version 1709 (RS 3)](/windows/whats-new/whats-new-windows-10-version-1709) with [KB4537816](https://support.microsoft.com/help/4537816/windows-10-update-kb4537816)
- - **macOS** - Only applicable for Public Preview, minimum required version: 101.43.84
+ - **macOS** - Only applicable for Public Preview, minimum required version: 101.43.84
- - **Linux** - Only applicable for Public Preview, minimum required version: 101.45.13
-
+ - **Linux** - Only applicable for Public Preview, minimum required version: 101.45.13
+
- **Windows Server 2012 R2** - with [KB5005292](https://support.microsoft.com/topic/microsoft-defender-for-endpoint-update-for-edr-sensor-f8f69773-f17f-420f-91f4-a8e5167284ac) - **Windows Server 2016** - with [KB5005292](https://support.microsoft.com/topic/microsoft-defender-for-endpoint-update-for-edr-sensor-f8f69773-f17f-420f-91f4-a8e5167284ac)
Before you can initiate a session on a device, make sure you fulfill the followi
- **Windows Server 2019** - Version 1903 or (with [KB4515384](https://support.microsoft.com/help/4515384/windows-10-update-kb4515384)) later - Version 1809 (with [KB4537818](https://support.microsoft.com/help/4537818/windows-10-update-kb4537818))-
+
- **Windows Server 2022**
+
+ - **Enable live response from the advanced settings page**. You'll need to enable the live response capability in the [Advanced features settings](advanced-features.md) page.
The following commands are available for user roles that are granted the ability
**** | Command | Description | Windows and Windows Server | macOS | Linux | ||||||
-| cd | Changes the current directory. | Y | Y | Y |
+| cd | Changes the current directory. | Y | Y | Y |
| cls | Clears the console screen. | Y | Y | Y | | connect | Initiates a live response session to the device. | Y | Y | Y |
-| connections | Shows all the active connections. | Y | N | N |
-| dir | Shows a list of files and subdirectories in a directory. | Y | Y |Y |
-| drivers | Shows all drivers installed on the device. | Y | N | N |
+| connections | Shows all the active connections. | Y | N | N |
+| dir | Shows a list of files and subdirectories in a directory. | Y | Y | Y |
+| drivers | Shows all drivers installed on the device. | Y | N | N |
| fg `<command ID>` | Place the specified job in the foreground in the foreground, making it the current job. NOTE: fg takes a 'command ID` available from jobs, not a PID | Y | Y | Y |
-| fileinfo | Get information about a file. |Y | Y | Y |
-| findfile | Locates files by a given name on the device. | Y | Y | Y |
+| fileinfo | Get information about a file. | Y | Y | Y |
+| findfile | Locates files by a given name on the device. | Y | Y | Y |
| getfile <file_path> | Downloads a file. | Y | Y | Y |
-| help | Provides help information for live response commands. |Y | Y | Y |
-| jobs | Shows currently running jobs, their ID and status. | Y | Y | Y |
-| persistence | Shows all known persistence methods on the device. | Y | N | N |
+| help | Provides help information for live response commands. | Y | Y | Y |
+| jobs | Shows currently running jobs, their ID and status. | Y | Y | Y |
+| persistence | Shows all known persistence methods on the device. | Y | N | N |
| processes | Shows all processes running on the device. | Y | Y | Y |
-| registry | Shows registry values. | Y | N | N |
-| scheduledtasks | Shows all scheduled tasks on the device. | Y | N | N |
-| services | Shows all services on the device. | Y | N | N |
-| trace | Sets the terminal's logging mode to debug. | Y | Y |Y |
+| registry | Shows registry values. | Y | N | N |
+| scheduledtasks | Shows all scheduled tasks on the device. | Y | N | N |
+| services | Shows all services on the device. | Y | N | N |
+| startupfolders | Shows all known files in startup folders on the device. | Y | N | N |
+| status | Shows the status and output of specific command. | Y | N | N |
+| trace | Sets the terminal's logging mode to debug. | Y | Y | Y |
### Advanced commands
The following commands are available for user roles that are granted the ability
| run | Runs a PowerShell script from the library on the device. | Y | Y | Y | | library | Lists files that were uploaded to the live response library. | Y | Y | Y | | putfile | Puts a file from the library to the device. Files are saved in a working folder and are deleted when the device restarts by default. | Y | Y | Y |
-| remediate | Remediates an entity on the device. The remediation action will vary depending on the entity type: File: delete Process: stop, delete image file Service: stop, delete image file Registry entry: delete Scheduled task: remove Startup folder item: delete file NOTE: This command has a prerequisite command. You can use the -auto command in conjunction with remediate to automatically run the prerequisite command. | Y | Y | Y |
-| scan | Disconnects the device from the network while retaining connectivity to the Defender for Endpoint service | N | Y | Y |
+| remediate | Remediates an entity on the device. The remediation action will vary depending on the entity type: File: delete Process: stop, delete image file Service: stop, delete image file Registry entry: delete Scheduled task: remove Startup folder item: delete file NOTE: This command has a prerequisite command. You can use the -auto command in conjunction with remediate to automatically run the prerequisite command. | Y | Y | Y |
+| scan | Runs an antivirus (quick) scan to help identify and remediate malware. | N | Y | Y |
| undo | Restores an entity that was remediated. | Y | Y | Y | + ## Use live response commands The commands that you can use in the console follow similar principles as [Windows Commands](/windows-server/administration/windows-commands/windows-commands#BKMK_c).
Select the **Command log** tab to see the commands used on the device during a s
- Live response sessions are limited to 25 live response sessions at a time. - Live response session inactive timeout value is 30 minutes.-- Getfile command inactive timeout value is 30 minutes. It is considered inactive while the command is running in the background. - A user can initiate up to 10 concurrent sessions. - A device can only be in one session at a time. - The following file size limits apply:
Select the **Command log** tab to see the commands used on the device during a s
## Related article -- [Live response command examples](live-response-command-examples.md)
+- [Live response command examples](live-response-command-examples.md)
security Server Migration https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/security/defender-endpoint/server-migration.md
These instructions apply to the new unified solution and installer package of Mi
> Operating system upgrades with Microsoft Defender for Endpoint installed are not supported. Please offboard then uninstall before proceeding with an upgrade. > [!NOTE]
-> During preview, full Microsoft Endpoint Configuration Manager automation and integration to perform an automated upgrade will be available in a later release of MECM. From the 2107 release, you CAN use the Endpoint Protection node for configuration as well as Group Policy, PowerShell, Microsoft Endpoint Manager tenant attach or local configuration. In addition, you can leverage existing functionality in Microsoft Endpoint Configuration Manager to automate manual upgrade steps; methods for which are described below.
+> During preview, full Microsoft Endpoint Configuration Manager automation and integration to perform an automated upgrade will be available in a later release of MECM. From the 2107 release with the latest hotfix rollup, you CAN use the Endpoint Protection node for configuration as well as Group Policy, PowerShell, Microsoft Endpoint Manager tenant attach or local configuration. In addition, you can leverage existing functionality in Microsoft Endpoint Configuration Manager to automate manual upgrade steps; methods for which are described below.
+ ## Installer script
security Whats New In Microsoft Defender Endpoint https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/security/defender-endpoint/whats-new-in-microsoft-defender-endpoint.md
For more information on Microsoft Defender for Endpoint on other operating syste
## January 2021 -- [Windows Virtual Desktop](https://azure.microsoft.com/services/virtual-desktop/) <br> Microsoft Defender for Endpoint now adds support for Windows Virtual Desktop.
+- [Azure Virtual Desktop](https://azure.microsoft.com/services/virtual-desktop/) <br> Microsoft Defender for Endpoint now adds support for Azure Virtual Desktop.
test-base Rules https://github.com/MicrosoftDocs/microsoft-365-docs/commits/public/microsoft-365/test-base/rules.md
+
+ Title: 'Application/Test rules'
+description: Rules to be followed when uploading an application/test
+search.appverid: MET150
+++
+audience: Software-Vendor
+ Last updated : 07/06/2021+
+ms.localizationpriority: medium
+++
+f1.keywords: NOCSH
+
+# Application/Test rules
+
+All applications or tests in Test Base need to comply with the following rules:
+
+## Test Base folders
+
+The following folders are used by the Test Base infrastructure:
+* %SYSTEMDRIVE%\USL
+* %SYSTEMDRIVE%\Ffmpeg
+* %SYSTEMDRIVE%\Monitoring
+* %SYSTEMDRIVE%\powershell-yaml
+* %SYSTEMDRIVE%\ProcMon
+* %SYSTEMDRIVE%\PSTools
+* %SYSTEMDRIVE%\TokenProviderTool
+* %SYSTEMDRIVE%\USLPowershellModules
+* %SYSTEMDRIVE%\UtcUtil
+* %SYSTEMDRIVE%\WPT
+* %SYSTEMDRIVE%\WULogs
+
+> [!IMPORTANT]
+> **Avoid the following**:
+> * Blocking the execution of any process from these folders. If your application is anti-malware software, configure your app installation to allow unimpeded execution of all processes from these folders.
+> * Tampering with any of these folders.
+
+## Test Base registry keys
+
+The applications/tests should not delete or modify any registry keys related to:
+* Windows telemetry level
+* Removing TLS 1.2