Merge branch 'master' into patch-1

Author: kenwith

exchange/docs-conceptual/exchange-online/exchange-online-powershell-v2/app-only-auth-powershell-v2.md

@@ -30,12 +30,13 @@ The following examples show how to use the Exchange Online PowerShell V2 module
   ```powershell
   Connect-ExchangeOnline -CertificateFilePath "C:\Users\johndoe\Desktop\automation-cert.pfx" -AppID "alpha-beta-gamma-123456" -TenantID "contosoelectronics.onmicrosoft.com"
   ```
- 
+
 - Connect using a certificate thumbprint:
 
   ```powershell
   Connect-ExchangeOnline -CertificateThumbPrint "012THISISADEMOTHUMBPRINT" -AppID "alpha-beta-gamma-123456" -TenantID "contosoelectronics.onmicrosoft.com" 
   ```
+
   When you use the _CertificateThumbPrint_ parameter, the certificate needs to be installed on the computer where you are running the command. The certificate should be installed in the user certificate store.
 
 - Connect using an existing service principal and client-secret:

exchange/docs-conceptual/exchange-online/exchange-online-powershell-v2/cmdlet-property-sets.md

@@ -20,6 +20,8 @@ description: "Learn about the available property sets in the Exchange Online Pow
 
 This topic describes the property sets that are available in the new cmdlets in the [Exchange Online PowerShell V2 module](exchange-online-powershell-v2.md). For more information about property sets, see [Properties and property sets in the EXO V2 module](exchange-online-powershell-v2.md#properties-and-property-sets-in-the-exo-v2-module).
 
+For more information about filtering in the EXO V2 module, see [Filters in the Exchange Online V2 module](filters-v2.md).
+
 ## Get-EXOCasMailbox property sets
 
 The available property sets for the **Get-EXOCasMailbox** cmdlet and the properties they contain are described in the following table:

exchange/docs-conceptual/exchange-online/exchange-online-powershell-v2/exchange-online-powershell-v2.md

@@ -52,7 +52,6 @@ The new cmdlets in the EXO V2 module are listed in the following table:
 |[Disconnect-ExchangeOnline](https://docs.microsoft.com/powershell/module/exchange/disconnect-exchangeonline)|[Remove-PSSession](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/remove-pssession)|
 |[Connect-IPPSSession](https://docs.microsoft.com/powershell/module/exchange/connect-ippssession)|[Connect-IPPSSession](https://docs.microsoft.com/powershell/exchange/office-365-scc/connect-to-scc-powershell/mfa-connect-to-scc-powershell)|
 
-
 ## Install and maintain the Exchange Online PowerShell V2 module
 
 You can download the EXO V2 module from the PowerShell gallery [here](https://www.powershellgallery.com/packages/ExchangeOnlineManagement/).
@@ -268,6 +267,8 @@ Get-EXOMailbox -ResultSize 10 -PropertySets All
 > [!NOTE]
 > We highly discourage using the _PropertySets_ parameter with the value `All` because it slows down the cmdlet and reduces reliability. Always use the _PropertySets_ and _Properties_ parameters to retrieve only the required properties.
 
+For more information about filtering in the EXO V2 module, see [Filters in the Exchange Online V2 module](filters-v2.md).
+
 ## Release notes
 
 ### Current release: Version 1.0.1

exchange/docs-conceptual/exchange-online/exchange-online-powershell-v2/filters-v2.md

@@ -0,0 +1,63 @@
+---
+title: Filters in the V2 module
+ms.author: chrisda
+author: chrisda
+manager: dansimp
+ms.date:
+ms.audience: Admin
+ms.topic: article
+ms.service: exchange-online
+ms.reviewer: navgupta
+localization_priority: Priority
+ms.collection: Strat_EX_Admin
+ms.custom:
+ms.assetid:
+search.appverid: MET150
+description: "Learn about how to use filtering for cmdlets in the Exchange Online V2 module."
+---
+
+# Filters in the Exchange Online V2 module
+
+The Exchange Online PowerShell V2 module (abbreviated as the EXO V2 module) contains a few new cmdlets that are optimized for high speed, high volume operations, and (after you connect to your organization) gives you access to the hundreds of existing cmdlets in the service. For more information, see [Use the Exchange Online PowerShell V2 module](exchange-online-powershell-v2.md).
+
+In order to get the most out of the EXO V2 module, you need to follow the guidance in this topic.
+
+## Use client-side filtering for the best performance
+
+Server-side filtering uses the available _Filter_ or _RecipientFilter_ parameters on a cmdlet. Client-side filtering uses the [Where-Object](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/where-object) cmdlet (also known as **where** or **?**).
+
+Generally, you get much better performance with server-side filtering. However, for the EXO V2 module, you actually get better performance when using client-side filtering. We're working on improving the performance of server-side filtering in module.
+
+## Supported and unsupported attributes
+
+Although the EXO V2 module supports the majority of filterable attributes, the following attributes are currently not supported for filtering:
+
+||||
+|---|---|---|
+|**Cmdlet**|**Attribute**|**LDAP Display Name**|
+|[Get-CASMailbox](https://docs.microsoft.com/powershell/module/exchange/get-casmailbox)|MemberOfGroup <br/><br/> ExternalDirectoryObjectId|memberOf <br/><br/> msExchExternalDirectoryObjectId|
+|[Get-Mailbox](https://docs.microsoft.com/powershell/module/exchange/get-mailbox)|DeletedItemFlags <br/><br/> ExternalDirectoryObjectId <br/><br/> LanguagesRaw <br/><br/> MasterAccountSid <br/><br/> MemberOfGroup <br/><br/> RequireAllSendersAreAuthenticated <br/><br/> SCLDeleteThresholdInt <br/><br/> SCLJunkThresholdInt <br/><br/> SCLQuarantineThresholdInt <br/><br/> SCLRejectThresholdInt|deletedItemFlags <br/><br/> msExchExternalDirectoryObjectId <br/><br/> msExchUserCulture <br/><br/> msExchMasterAccountSid <br/><br/> memberOf <br/><br/> msExchRequireAuthToSendTo <br/><br/> msExchMessageHygieneSCLDeleteThreshold <br/><br/> msExchMessageHygieneSCLJunkThreshold <br/><br/> msExchMessageHygieneSCLQuarantineThreshold <br/><br/> msExchMessageHygieneSCLRejectThreshold|
+|[Get-Recipient](https://docs.microsoft.com/powershell/module/exchange/get-recipient)|CountryCode <br/><br/> ExternalDirectoryObjectId <br/><br/> MasterAccountSid <br/><br/> MemberOfGroup <br/><br/> Members|countryCode <br/><br/> msExchExternalDirectoryObjectId <br/><br/> msExchMasterAccountSid <br/><br/> memberOf <br/><br/> member|
+|
+
+## Supported and unsupported operators
+
+The following operators are fully supported for all string formats in the EXO V2 module:
+
+- -eq
+- -and
+- -ne
+- -or
+- -not
+- -lt
+- -gt
+
+The -like and -notlike operators are limited in using wildcards (*). Specifically, you can only use wildcards at the beginning of a string value, at the end of a string value, or both.
+
+For example, the following text search is not supported:
+
+`"UPN  -like 'A*B*C'`
+
+However, the following searches are supported:
+
+`"UPN -like 'A*' -and UPN -like '*C' -and UPN like '*B*'"`

exchange/docs-conceptual/toc.yml

@@ -1,4 +1,3 @@
-
 - name: Home
   href: index.md
   items:
@@ -46,8 +45,10 @@
   - name: Exchange Online PowerShell V2
     href: exchange-online/exchange-online-powershell-v2/exchange-online-powershell-v2.md
     items:
-    - name: Property sets in cmdlets
+    - name: Property sets in V2 cmdlets
       href: exchange-online/exchange-online-powershell-v2/cmdlet-property-sets.md
+    - name: Filters in the V2 module
+      href: exchange-online/exchange-online-powershell-v2/filters-v2.md
   - name: Office 365 Security & Compliance Center PowerShell
     href: office-365-scc/office-365-scc-powershell.md
     items:

exchange/exchange-ps/exchange/Connect-ExchangeOnline.md

@@ -36,6 +36,7 @@ Connect-ExchangeOnline
  [-PageSize <UInt32>]
  [-Prefix <String>]
  [[-PSSessionOption] <PSSessionOption>]
+ [ShowBanner]
  [-ShowProgress <Boolean>]
  [-TrackPerformance <Boolean>]
  [-UseMultithreading <Boolean>]
@@ -56,7 +57,7 @@ Connect-ExchangeOnline -Credential $UserCredential
 
 The first command gets the user credentials and stores them in the $UserCredential variable.
 
-The second command connects the current PowerShell session using the credentials in the $UserCredential, which isn't MFA enabled. Note that after the second command is complete, the password key in the $UserCredential variable becomes empty.
+The second command connects the current PowerShell session using the credentials in the $UserCredential, which isn't MFA enabled.
 
 After the Connect-ExchangeOnline command is successful, you can run ExO V2 module cmdlets and older remote PowerShell cmdlets.
 
@@ -284,6 +285,26 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ShowBanner
+The ShowBanner switch shows or hides the banner message that's displayed when you run Connect-ExchangeOnline. You don't need to specify a value with this switch.
+
+To show the banner, you don't need to use this switch (the banner is displayed by default).
+
+To hide the banner, use this exact syntax: `-ShowBanner:$false`.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: Named
+Default value: $true
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ShowProgress
 The ShowProgress parameter shows a visual progress bar in the PowerShell client module. The progress bar shows number of objects received and total number of objects requested. Valid values are:
 

exchange/exchange-ps/exchange/Get-UnifiedGroup.md

@@ -149,6 +149,8 @@ The Identity parameter specifies the Office 365 Group that you want to view. You
 
 - GUID
 
+**Note**: You can use the DisplayName value to identify the Office 365 group, but the results aren't guaranteed to be unique. If you must return a singular and unique result, use a unique identifier for the Office 365 Group.
+
 ```yaml
 Type: UnifiedGroupIdParameter
 Parameter Sets: Identity

exchange/exchange-ps/exchange/Set-RemoteMailbox.md

@@ -1406,9 +1406,11 @@ The Type parameter specifies the type for the mailbox in the service. Valid valu
 
 Notes on the value Shared:
 
-- Shared is available only in Exchange 2013 CU21 or later and Exchange 2016 CU10 or later. To use this value, you also need to run setup.exe /PrepareAD. For more information, see [KB4133605](https://support.microsoft.com/help/4133605/cmdlets-to-create-modify-remote-shared-mailbox-in-on-premises-exchange).
+- Shared is available only in Exchange 2013 CU21 or later, Exchange 2016 CU10 or later, and Exchange 2019. In Exchange 2013 and Exchange 2016, you also need to run setup.exe /PrepareAD. For more information, see [KB4133605](https://support.microsoft.com/help/4133605/).
 
-- You can only use Shared on a mailbox that was originally created in Exchange Online. If the mailbox was originally created in on-premises Exchange and then migrated to Exchange Online, take the action described in Step 3 in the Resolution section in [KB2710029](https://support.microsoft.com/help/2710029/shared-mailboxes-are-unexpectedly-converted-to-user-mailboxes-after-di).
+- If you tried to convert a migrated remote mailbox to a shared remote mailbox, you would receive the following error: `remoteMailbox.RemoteRecipientType must include ProvisionMailbox`. This issue was fixed in Exchange 2016 CU14 and Exchange 2019 CU3, but not in Exchange 2013. For more information, see [KB4515271](https://support.microsoft.com/help/4515271/).
+
+- If directory synchronization unexpectedly converts shared mailboxes in Exchange Online back into user mailboxes, or if you continue to receive the `remoteMailbox.RemoteRecipientType must include ProvisionMailbox` error when you use the value Shared, take the action described in Step 3 in the Resolution section in [KB2710029](https://support.microsoft.com/help/2710029/).
 
 ```yaml
 Type: ConvertibleRemoteMailboxSubType

sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSite.md

@@ -101,6 +101,14 @@ Get-SPOSite -Identity https://contoso.sharepoint.com/sites/groupname -detailed |
 
 This example gets quota details for a Group Site.
 
+### -----------------------EXAMPLE 6-----------------------------
+
+```powershell
+Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegment
+```
+
+This example returns the InformationSegments associated to the site.
+
 ## PARAMETERS
 
 ### -Detailed
@@ -251,6 +259,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### InformationSegment
+This parameter displays the segments associated with a site. 
+
+It is applicable for tenants who have enabled Microsoft 365 Information barriers capability. Please read https://docs.microsoft.com/sharepoint/information-barriers documentation to understand Information barriers in SharePoint Online.
+
+**Note**: This parameter is available only in SharePoint Online Management Shell Version 16.0.19927.12000 or later.
+
+```yaml
+Type: Collection of GUIDs
+Applicable: SharePoint Online
+Required: False
+Position: Named
+Default value: None
+```
+
 ### CommonParameters
 
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

skype/skype-ps/skype/Set-CsOnlineLisCivicAddress.md

@@ -85,7 +85,7 @@ Accept wildcard characters: False
 ```
 
 ### -CityAlias
-PARAMVALUE: String
+Short form of the city name.
 
 ```yaml
 Type: String
@@ -117,7 +117,7 @@ Accept wildcard characters: False
 ```
 
 ### -CompanyTaxId
-PARAMVALUE: String
+Used to store TaxId for regulatory reasons. 
 
 ```yaml
 Type: String
@@ -363,7 +363,7 @@ Accept wildcard characters: False
 ```
 
 ### -ValidationStatus
-PARAMVALUE: String
+Microsoft internal use only
 
 ```yaml
 Type: String