Skip to content

Commit 44eee5d

Browse files
authored
Merge pull request MicrosoftDocs#10535 from MicrosoftDocs/main
Publish main to live on 2/28 @ 10:30 am
2 parents 55bccd3 + 02619f4 commit 44eee5d

13 files changed

+566
-88
lines changed

skype/skype-ps/skype/Find-CsOnlineApplicationInstance.md

Lines changed: 22 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml
33
online version: https://learn.microsoft.com/powershell/module/skype/find-csonlineapplicationinstance
4-
applicable: Skype for Business Online
4+
applicable: Microsoft Teams
55
title: Find-CsOnlineApplicationInstance
66
schema: 2.0.0
77
manager: bulenteg
8-
author: tomkau
9-
ms.author: tomkau
8+
author: jenstrier
9+
ms.author: jenstr
1010
ms.reviewer:
1111
---
1212

@@ -18,7 +18,7 @@ Use the Find-CsOnlineApplicationInstance cmdlet to find application instances th
1818
## SYNTAX
1919

2020
```
21-
Find-CsOnlineApplicationInstance -SearchQuery <String> [-MaxResults <UInt32?>] [-ExactMatchOnly] [-AssociatedOnly] [-UnAssociatedOnly] [-Tenant <Guid>] [-CommonParameters]
21+
Find-CsOnlineApplicationInstance [-SearchQuery] <string> [[-MaxResults] <uint>] [-ExactMatchOnly] [-AssociatedOnly] [-UnAssociatedOnly] [-Force] [<CommonParameters>]
2222
```
2323

2424
## DESCRIPTION
@@ -65,7 +65,7 @@ The SearchQuery parameter defines a query for application instances by display n
6565
Type: System.String
6666
Parameter Sets: (All)
6767
Aliases:
68-
Applicable: Skype for Business Online
68+
Applicable: Microsoft Teams
6969

7070
Required: True
7171
Position: Named
@@ -81,7 +81,7 @@ The ExactMatchOnly parameter instructs the cmdlet to return exact matches only.
8181
Type: SwitchParameter
8282
Parameter Sets: (All)
8383
Aliases:
84-
Applicable: Skype for Business Online
84+
Applicable: Microsoft Teams
8585

8686
Required: False
8787
Position: Named
@@ -97,7 +97,7 @@ The AssociatedOnly parameter instructs the cmdlet to return only application ins
9797
Type: SwitchParameter
9898
Parameter Sets: (All)
9999
Aliases:
100-
Applicable: Skype for Business Online
100+
Applicable: Microsoft Teams
101101

102102
Required: False
103103
Position: Named
@@ -113,7 +113,7 @@ The UnAssociatedOnly parameter instructs the cmdlet to return only application i
113113
Type: SwitchParameter
114114
Parameter Sets: (All)
115115
Aliases:
116-
Applicable: Skype for Business Online
116+
Applicable: Microsoft Teams
117117

118118
Required: False
119119
Position: Named
@@ -129,7 +129,7 @@ The MaxResults parameter identifies the maximum number of results to return. If
129129
Type: UInt32
130130
Parameter Sets: (All)
131131
Aliases:
132-
Applicable: Skype for Business Online
132+
Applicable: Microsoft Teams
133133

134134
Required: False
135135
Position: Named
@@ -138,17 +138,18 @@ Accept pipeline input: False
138138
Accept wildcard characters: False
139139
```
140140
141-
### -Tenant
141+
### -Force
142+
This switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If it isn't provided in the command, you're prompted for administrative input if required.
142143
143144
```yaml
144-
Type: System.Guid
145+
Type: SwitchParameter
145146
Parameter Sets: (All)
146147
Aliases:
147-
Applicable: Skype for Business Online
148+
Applicable: Microsoft Teams
148149

149150
Required: False
150151
Position: Named
151-
Default value: None
152+
Default value: False
152153
Accept pipeline input: False
153154
Accept wildcard characters: False
154155
```
@@ -160,12 +161,18 @@ This cmdlet supports the common parameters: `-Debug, -ErrorAction, -ErrorVariabl
160161

161162
### None
162163

163-
164164
## OUTPUTS
165165

166166
### Microsoft.Rtc.Management.Hosted.Online.Models.FindApplicationInstanceResult
167167

168-
169168
## NOTES
170169

171170
## RELATED LINKS
171+
172+
[Get-CsOnlineApplicationInstance](Get-CsOnlineApplicationInstance.md)
173+
174+
[New-CsOnlineApplicationInstance](New-CsOnlineApplicationInstance.md)
175+
176+
[Find-CsOnlineApplicationInstance](Find-CsOnlineApplicationInstance.md)
177+
178+
[Set-CsOnlineApplicationInstance](Set-CsOnlineApplicationInstance.md)

skype/skype-ps/skype/Get-CsOnlineApplicationInstance.md

Lines changed: 69 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
external help file: Microsoft.Rtc.Management.Hosted.dll-help.xml
33
online version: https://learn.microsoft.com/powershell/module/skype/get-csonlineapplicationinstance
4-
applicable: Skype for Business Online
4+
applicable: Microsoft Teams
55
title: Get-CsOnlineApplicationInstance
66
schema: 2.0.0
77
manager: bulenteg
8-
author: tomkau
9-
ms.author: tomkau
8+
author: jenstrier
9+
ms.author: jenstr
1010
ms.reviewer:
1111
---
1212

@@ -18,7 +18,7 @@ Get application instance for the tenant from Azure Active Directory.
1818
## SYNTAX
1919

2020
```
21-
Get-CsOnlineApplicationInstance [[-Identity] <string>] [[-ResultSize] <int>] [-Tenant <guid>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
21+
Get-CsOnlineApplicationInstance [[-Identity] <string>] [[-ResultSize] <int>] [[-Skip] <int>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
2222
```
2323

2424
## DESCRIPTION
@@ -50,13 +50,13 @@ This example returns the details of all application instances.
5050
## PARAMETERS
5151

5252
### -Identity
53-
The URI or the object ID of the application instance to retrieve. If this parameter is not provided, it will retrieve all application instances in the tenant.
53+
The UPN or the object ID of the application instance to retrieve. If this parameter is not provided, it will retrieve all application instances in the tenant.
5454

5555
```yaml
5656
Type: System.String
5757
Parameter Sets: (All)
5858
Aliases:
59-
Applicable: Skype for Business Online
59+
Applicable: Microsoft Teams
6060

6161
Required: False
6262
Position: Named
@@ -69,10 +69,10 @@ Accept wildcard characters: False
6969
The result size for bulk get.
7070
7171
```yaml
72-
Type: UInt32
72+
Type: System.Int32
7373
Parameter Sets: (All)
7474
Aliases:
75-
Applicable: Skype for Business Online
75+
Applicable: Microsoft Teams
7676

7777
Required: False
7878
Position: Named
@@ -81,14 +81,14 @@ Accept pipeline input: False
8181
Accept wildcard characters: False
8282
```
8383
84-
### -Tenant
85-
The Tenant ID.
84+
### -Skip
85+
Skips the first specified number of returned results. The default value is 0.
8686
8787
```yaml
88-
Type: System.Guid
88+
Type: System.Int32
8989
Parameter Sets: (All)
9090
Aliases:
91-
Applicable: Skype for Business Online
91+
Applicable: Microsoft Teams
9292

9393
Required: False
9494
Position: Named
@@ -97,6 +97,55 @@ Accept pipeline input: False
9797
Accept wildcard characters: False
9898
```
9999
100+
### -Force
101+
This switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If it isn't provided in the command, you're prompted for administrative input if required.
102+
103+
```yaml
104+
Type: SwitchParameter
105+
Parameter Sets: (All)
106+
Aliases:
107+
Applicable: Microsoft Teams
108+
109+
Required: False
110+
Position: Named
111+
Default value: False
112+
Accept pipeline input: False
113+
Accept wildcard characters: False
114+
```
115+
116+
### -WhatIf
117+
Shows what would happen if the cmdlet runs.
118+
The cmdlet is not run.
119+
120+
```yaml
121+
Type: SwitchParameter
122+
Parameter Sets: (All)
123+
Aliases: wi
124+
Applicable: Microsoft Teams
125+
126+
Required: False
127+
Position: Named
128+
Default value: False
129+
Accept pipeline input: False
130+
Accept wildcard characters: False
131+
```
132+
133+
### -Confirm
134+
Prompts you for confirmation before running the cmdlet.
135+
136+
```yaml
137+
Type: SwitchParameter
138+
Parameter Sets: (All)
139+
Aliases: cf
140+
Applicable: Microsoft Teams
141+
142+
Required: False
143+
Position: Named
144+
Default value: False
145+
Accept pipeline input: False
146+
Accept wildcard characters: False
147+
```
148+
100149
### CommonParameters
101150
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).
102151

@@ -107,3 +156,11 @@ This cmdlet supports the common parameters: `-Debug, -ErrorAction, -ErrorVariabl
107156
## NOTES
108157

109158
## RELATED LINKS
159+
160+
[Set-CsOnlineApplicationInstance](Set-CsOnlineApplicationInstance.md)
161+
162+
[New-CsOnlineApplicationInstance](New-CsOnlineApplicationInstance.md)
163+
164+
[Find-CsOnlineApplicationInstance](Find-CsOnlineApplicationInstance.md)
165+
166+
[Sync-CsOnlineApplicationInstance](Sync-CsOnlineApplicationInstance.md)

skype/skype-ps/skype/Get-CsOnlineUser.md

Lines changed: 81 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -209,7 +209,68 @@ Enables you to limit the returned data by filtering on specific attributes. For
209209

210210
The Filter parameter uses the same filtering syntax as the Where-Object cmdlet. For example, the following filter returns only users who have been enabled for Enterprise Voice: `-Filter 'EnterpriseVoiceEnabled -eq $True'` or ``-Filter "EnterpriseVoiceEnabled -eq `$True"``.
211211

212-
The following updates are applicable for organizations having TeamsOnly users that use Microsoft Teams PowerShell version 3.0.0 and later:
212+
**Updates in Teams PowerShell Module version 5.0.0**
213+
214+
The following updates are applicable for organizations having TeamsOnly users that use Microsoft Teams PowerShell version 5.0.0 (note that these changes are only rolled out in commercial environments at present):
215+
216+
_Performance_
217+
218+
The performance of Get-CsOnlineUser without the “-identity” parameter is improved. Here are some examples where significant improvement can be observed:
219+
220+
- Get-CsOnlineUser -Filter {AssignedPlan -like "*MCO*"}
221+
- Get-CsOnlineUser -Filter {UserPrincipalName -like "test*" -and (AssignedPlans -eq "MCOEV" -or AssignedPlans -like "MCOPSTN*")}
222+
- Get-CsOnlineUser -Filter {OnPremHostingProvider -ne $null}
223+
- Get-CsOnlineUser -Filter {WhenChanged -gt "1/25/2022 11:59:59 PM"}
224+
225+
_New Filtering Attributes_
226+
227+
These attributes are now enabled for filtering:
228+
229+
- Alias
230+
- City
231+
- CompanyName
232+
- HostingProvider
233+
- UserValidationErrors
234+
- OnPremEnterpriseVoiceEnabled
235+
- OnPremHostingProvider
236+
- OnPremLineURI
237+
- OnPremSIPEnabled
238+
- SipAddress
239+
- SoftDeletionTimestamp
240+
- State
241+
- Street
242+
- TeamsOwnersPolicy
243+
- WhenChanged
244+
- WhenCreated
245+
- FeatureTypes
246+
- PreferredDataLocation
247+
- LastName
248+
249+
_New Operators_
250+
251+
These filtering operators have been reintroduced:
252+
253+
- “-like” operator now supports the use of wildcard operators in ‘contains’ and ‘ends with’ scenarios. For example:
254+
255+
```
256+
Contains Scenario: Get-CsOnlineUser -Filter "AssignedPlan -like '*MCO*'"
257+
Ends with scenario: Get-CsOnlineUser -Filter {AssignedPlan -like '*MCO'}
258+
```
259+
- “-contains” can now be used to filter properties that are an array of strings like FeatureTypes, ProxyAddresses, and ShadowProxyAddresses. For example:
260+
```
261+
Get-CsOnlineUser -Filter {FeatureTypes -contains "PhoneSystem"}
262+
Get-CsOnlineUser -Filter {ProxyAddresses -contains "SMTP:[email protected]"}
263+
```
264+
- “-gt” (greater than), “-lt” (less than), “-le” (less than or equal to) can now be used for filtering all string properties. For example:
265+
```
266+
Get-CsOnlineUser -Filter {UserPrincipalName -gt/-le/-lt “abc”}
267+
```
268+
- “-ge” (greater than or equal to) can now also be used for filtering on policies. For example:
269+
```
270+
Get-CsOnlineUser -Filter {ExternalAccessPolicy -ge "xyz_policy"}
271+
```
272+
273+
The following updates are applicable for organizations having TeamsOnly users that use Microsoft Teams PowerShell version 3.0.0 and later (excluding updates mentioned previously for Teams PowerShell Module version 5.0.0):
213274

214275
In the Teams PowerShell Module version 3.0.0 or later, filtering functionality is now limited to the following attributes (note that these changes are only rolled out in commercial environments at present and will be applicable to the lastest TPM versions in government environments starting March 31, 2023.):
215276

@@ -310,6 +371,7 @@ The following filter syntaxes have been modified in Teams PowerShell Module 3.0.
310371
- -ge: This operator is not supported with policy properties.
311372
- -like: This operator is supported only with wildcard character in the end (e.g., `"like <value>*"`).
312373

374+
313375
```yaml
314376
Type: String
315377
Parameter Sets: (All)
@@ -472,7 +534,24 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
472534

473535
### Notes
474536

475-
The following updates are applicable for organizations having TeamsOnly users that use Microsoft Teams PowerShell version 3.0.0 and later (note that these changes are only rolled out in commercial environments at present and will be applicable to the lastest TPM versions in government environments starting March 31, 2023.):
537+
**Updates in Teams PowerShell Module version 5.0.0**
538+
539+
The following updates are applicable for organizations having TeamsOnly users that use Microsoft Teams PowerShell version 5.0.0 (note that these changes are only rolled out in commercial environments at present):
540+
541+
New attributes have now been introduced in the output of Get-CsOnlineUser when not using the "-identity" parameter:
542+
543+
- CountryAbbreviation
544+
- SipProxyAddress
545+
- TeamsMediaLoggingPolicy
546+
- UserValidationErrors
547+
- WhenCreated
548+
549+
Unlicensed Users: Unlicensed users would show up in the output for 30 days post-license removal.
550+
Soft deleted users: These users will be displayed in the output of Get-CsOnlineUser and the TAC Manage Users page by default with SoftDeletionTimestamp set to a value.
551+
552+
**Updates in Teams PowerShell Module version 3.0.0 and above**
553+
554+
The following updates are applicable for organizations having TeamsOnly users that use Microsoft Teams PowerShell version 3.0.0 and later, excluding updates mentioned previously for Teams PowerShell Module version 5.0.0 (note that these changes are only rolled out in commercial environments at present and will be applicable to the lastest TPM versions in government environments starting March 31, 2023.):
476555

477556
*New user attributes*:
478557

skype/skype-ps/skype/Get-CsTeamsEmergencyCallingPolicy.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,24 @@ Get-CsTeamsEmergencyCallingPolicy -Filter Test*
5252

5353
Retrieves all emergency calling policies with Identity starting with Test.
5454

55+
### Example 4
56+
```powershell
57+
(Get-CsTeamsEmergencyCallingPolicy -Identity TestECP).ExtendedNotifications
58+
```
59+
```output
60+
EmergencyDialString : 112
61+
NotificationGroup : [email protected]
62+
NotificationDialOutNumber :
63+
NotificationMode : ConferenceUnMuted
64+
65+
EmergencyDialString : 911
66+
NotificationGroup : [email protected]
67+
NotificationDialOutNumber : +14255551234
68+
NotificationMode : NotificationOnly
69+
```
70+
71+
This example displays extended notifications set on emergency calling policy with the identity TestECP.
72+
5573
## PARAMETERS
5674

5775
### -Identity

0 commit comments

Comments
 (0)