Merge remote-tracking branch 'upstream/master'

Author: markjjo

exchange/exchange-ps/exchange/antispam-antimalware/Export-QuarantineMessage.md

@@ -11,7 +11,9 @@ monikerRange: "exchonline-ps || eop-ps"
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-Use the Export-QuarantineMessage cmdlet to export quarantined messages from your cloud-based organization to .eml message files. You can then open the .eml files in Outlook.
+Use the Export-QuarantineMessage cmdlet to export quarantined messages and files from your cloud-based organization. Messages are exported to .eml message files so you can open them in Outlook.
+
+For files that are protected by Office 365 Advanced Threat Protection in SharePoint Online, OneDrive for Business and Microsoft Teams, the files are exported in Base64 format.
 
 For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://technet.microsoft.com/library/bb123552.aspx).
 
@@ -43,6 +45,13 @@ Notes:
 
 - You need to use the Out-File cmdlet to write the .eml message file with the required encoding. If you use the default PowerShell redirection operator ">" to write the output file, the default encoding is Unicode, which might not match the actual message encoding.
 
+### -------------------------- Example 2 --------------------------
+```
+$e = Export-QuarantineMessage -Identity 9c6bb3e8-db9e-4823-9759-08d594179bd3\7fec89fe-41b0-ae67-4887-5bede017d111; $bytes = [Convert]::FromBase64String($e.eml); [IO.File]::WriteAllBytes("C:\My Documents\Export1.txt", $bytes)
+```
+
+This example exports the quarantined file with the specified Identity value. The first command exports the file to a Base 64 string. The next two commands convert the string to byte format and write it to the output file.
+
 ## PARAMETERS
 
 ### -Identity

exchange/exchange-ps/exchange/antispam-antimalware/Get-QuarantineMessage.md

@@ -11,7 +11,9 @@ monikerRange: "exchonline-ps || eop-ps"
 ## SYNOPSIS
 This cmdlet is available only in the cloud-based service.
 
-Use the Get-QuarantineMessage cmdlet to view quarantined messages in your cloud-based organization.
+Use the Get-QuarantineMessage cmdlet to view quarantined messages and files in your cloud-based organization.
+
+**Not**: Quarantined files are files protected by Office 365 Advanced Threat Protection in SharePoint Online, OneDrive for Business and Microsoft Teams. 
 
 For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://technet.microsoft.com/library/bb123552.aspx).
 
@@ -62,6 +64,15 @@ This example returns the quarantined message with the Message-ID value \<5c695d7
 Get-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 | Format-List
 ```
 
+This example returns detailed information for the quarantined message with the specified Identity value.
+
+### -------------------------- Example 5 --------------------------
+```
+Get-QuarantineMessage -QuarantineTypes SPOMalware | Format-List
+```
+
+This example returns detailed information for the files protected by Office 365 Advanced Threat Protection in SharePoint Online, OneDrive for Business and Microsoft Teams.
+
 ## PARAMETERS
 
 ### -Identity
@@ -216,12 +227,16 @@ The QuarantineTypes parameter filters the results by what caused the message to
 
 - Spam
 
+- SPOMalware
+
 - TransportRule
 
 You can specify multiple values separated by commas.
 
 You don't need to use this parameter with the Type parameter.
 
+For files protected by Office 365 Advanced Threat Protection in SharePoint Online, OneDrive for Business and Microsoft Teams, the detection information can be found in CustomData field in the output.
+
 ```yaml
 Type: QuarantineMessageTypeEnum[]
 Parameter Sets: Set1

exchange/exchange-ps/exchange/antispam-antimalware/Preview-QuarantineMessage.md

@@ -13,6 +13,8 @@ This cmdlet is available only in the cloud-based service.
 
 Use the Preview-QuarantineMessage cmdlet to preview the contents of quarantined messages in your cloud-based organization.
 
+**Note**: This cmdlet isn't available for files that are protected by Office 365 Advanced Threat Protection in SharePoint Online, OneDrive for Business, and Microsoft Teams.
+
 For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://technet.microsoft.com/library/bb123552.aspx).
 
 ## SYNTAX

exchange/exchange-ps/exchange/antispam-antimalware/Release-QuarantineMessage.md

@@ -1,3 +1,5 @@
+ 
+
 ---
 external help file: Microsoft.Exchange.ServerStatus-Help.xml
 applicable: Exchange Online, Exchange Online Protection
@@ -13,6 +15,8 @@ This cmdlet is available only in the cloud-based service.
 
 Use the Release-QuarantineMessage cmdlet to release messages from quarantine in your cloud-based organization. You can release messages to all original recipients, or to specific recipients.
 
+For files that are protected by Office 365 Advanced Threat Protection in SharePoint Online, OneDrive for Business and Microsoft Teams, you can unblock the files in the respective team sites and document libraries by using the Release-QuarantineMessage cmdlet so users can access, share, and download the files.
+
 For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://technet.microsoft.com/library/bb123552.aspx).
 
 ## SYNTAX
@@ -133,6 +137,8 @@ Accept wildcard characters: False
 ### -ReleaseToAll
 The ReleaseToAll switch releases the quarantined message to all original recipients. You don't have to specify a value with this switch.
 
+This parameter is required for the quarantine type SPOMalware.
+
 If you previously used the User parameter or the ReleaseToAll switch to release the quarantined message to some or all of the original recipients, those recipients are skipped when you use the ReleaseToAll parameter again. You don't have to specify a value with the ReleaseToAll switch.
 
 You can't use the ReleaseToAll switch and the User parameter in the same command.

exchange/exchange-ps/exchange/mailboxes/Search-Mailbox.md

@@ -46,8 +46,6 @@ You can use the Search-Mailbox cmdlet to search messages in a specified mailbox
 
 - Delete messages from the source mailbox. You have to be assigned the Mailbox Import Export management role to delete messages.
 
-- Copy messages from the source mailbox and delete them from the target mailbox.
-
 - Perform single item recovery to recover items from a user's Recoverable Items folder.
 
 - Clean up the Recoverable Items folder for a mailbox when it has reached the Recoverable Items hard quota.

repo_docs/NEW_CMDLETS.md

@@ -1,16 +1,31 @@
 # Generate Your Own Markdown
 **SECTION IN PROGRESS**
 
-Use PlatyPS to generate Markdown. See, https://github.com/PowerShell/platyPS. 
+1. Open PowerShell as Administrator.
+2. Import the module you want to document.
+- Skype for Business Online: https://technet.microsoft.com/en-us/library/dn362795(v=ocs.15).aspx
+- Microsoft Teams: https://blogs.technet.microsoft.com/skypehybridguy/2017/11/07/microsoft-teams-powershell-support/
+   Hint: Might need to use Upgrade-Module and also Uninstall-Module depending on version and if you already have a version installed.
+3. Use PlatyPS to generate Markdown.
+- Skype for Business Online: `New-MarkdownHelp -module tmp_byivwzpq.e1k -OutputFolder .\docs`.
+4. Find the new cmdlet and you will see the stubbed markdown.
+5. Add correct metadata, see other similar cmdlets for examples.
+6. Add the correct Applicable tags to the top metadata and also the parameters for the cmdlet. See others for details. 
+    This is important since when the XML is generated to go back into the product the applicable is what is used for which content goes into which product.
+7. Add the cmdlet to TOC. TOC file is the name of the module. 
+    For example, for all Skype cmdlets the TOC file is skype.md.
+8. Submit a Pull Request into the repo in appropriate place with adding the new cmdlet. aka.ms/office-powershell
 
-Install PlatyPS.
 
-Get to where you can run Get-Help and see cmdlets.
-
-Generate help with PlatyPS.
 
 If you want to merge multiple versions into a single version then use the PlatyPS merge command.
 
 Make sure to update the TOC file. Exact format required so that the template text doesn't show up.
 
 Add metadata to the file so it shows in the correct reports. See these scripts to do it or you can do it manually too.
+
+
+References:
+https://docs.microsoft.com/en-us/powershell/module/powershellget/install-module?view=powershell-6
+https://docs.microsoft.com/en-us/powershell/module/powershellget/update-module?view=powershell-6
+https://github.com/PowerShell/platyPS

sharepoint/sharepoint-ps/sharepoint-online/Remove-SPOUserProfile.md

@@ -19,6 +19,9 @@ Remove-SPOUserProfile -LoginName <String> [<CommonParameters>]
 ## DESCRIPTION
 Can be used to remove the SharePoint user profile from the tenant.
 
+> [!NOTE]
+> The User must be first be deleted from AAD before the user profile can be deleted. You can use the Azure AD cmdlet Remove-AzureADUser for this action
+
 ## EXAMPLES
 
 ###   ------------ Example 1 --------------------

sharepoint/sharepoint-ps/sharepoint-online/Restore-SPODeletedSite.md

@@ -29,7 +29,7 @@ For permissions and the most current information about Windows PowerShell for Sh
 ```
 Restore-SPODeletedSite -Identity https://contoso.sharepoint.com/sites/arecycledsite
 ```
-This example restores a SharePoint Online deleted site collection named HYPERLINK "https://contoso.sharepoint.com/sites/arecycledsite" https://contoso.sharepoint.com/sites/arecycledsite from the Recycle Bin.
+This example restores a SharePoint Online deleted site collection named "https://contoso.sharepoint.com/sites/arecycledsite" from the Recycle Bin.
 
 
 ## PARAMETERS

sharepoint/sharepoint-ps/sharepoint-server/Get-SPProjectDatabaseUsage.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Get-SPProjectDatabaseUsage
 
 ## SYNOPSIS
-{{Fill in the Synopsis}}
+Returns an approximate size, in megabytes (MB) of the Project Web App data used in the content database.
 
 ## SYNTAX
 
@@ -17,21 +17,23 @@ Get-SPProjectDatabaseUsage [-AssignmentCollection <SPAssignmentCollection>] -Url
 ```
 
 ## DESCRIPTION
-{{Fill in the Description}}
+Returns an approximate size, in megabytes (MB) of the Project Web App data used in the content database.
 
 ## EXAMPLES
 
 ### Example 1 
 ```
-PS C:\> {{ Add example code here }}
+PS C:\>Get-SPProjectDatabaseUsage -Url  http://contoso.com/sites/pwa
 ```
 
-{{ Add example description here }}
+This example shows the size of the Project Web App data in the content data for the Project Web App site at http://contoso.com/sites/pwa.
 
 ## PARAMETERS
 
 ### -AssignmentCollection
-{{Fill AssignmentCollection Description}}
+Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.
+
+When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.
 
 ```yaml
 Type: SPAssignmentCollection
@@ -47,7 +49,7 @@ Accept wildcard characters: False
 ```
 
 ### -Url
-{{Fill Url Description}}
+The URL of the Project Web App site collection.
 
 ```yaml
 Type: Uri

sharepoint/sharepoint-ps/sharepoint-server/Get-SPProjectEnterpriseProjectTaskSync.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Get-SPProjectEnterpriseProjectTaskSync
 
 ## SYNOPSIS
-{{Fill in the Synopsis}}
+Returns whether the task list sync between Project Web App and project sites is enabled or disabled. This cmdlet returns a value only if the feature has previously been enabled or disabled.
 
 ## SYNTAX
 
@@ -18,21 +18,23 @@ Get-SPProjectEnterpriseProjectTaskSync [-AssignmentCollection <SPAssignmentColle
 ```
 
 ## DESCRIPTION
-{{Fill in the Description}}
+Returns whether the task list sync between Project Web App and project sites is enabled or disabled. This cmdlet returns a value only if the feature has previously been enabled or disabled.
 
 ## EXAMPLES
 
 ### Example 1 
 ```
-PS C:\> {{ Add example code here }}
+PS C:\>Get-SPProjectEnterpriseProjectTaskSync -Url http://contoso/sites/PWA
 ```
 
-{{ Add example description here }}
+This example shows the syntax for getting the task sync status for the Project Web App site at http://contoso/sites/PWA.
 
 ## PARAMETERS
 
 ### -AssignmentCollection
-{{Fill AssignmentCollection Description}}
+Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.
+
+When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.
 
 ```yaml
 Type: SPAssignmentCollection
@@ -48,7 +50,7 @@ Accept wildcard characters: False
 ```
 
 ### -Url
-{{Fill Url Description}}
+The URL of the PWA site.
 
 ```yaml
 Type: Uri