Skip to content

Commit 444a254

Browse files
kenwithkenwith
authored
Merge branch 'master' into patch-40
2 parents 2d92bd0 + 93611f0 commit 444a254

File tree

3 files changed

+264
-1
lines changed

3 files changed

+264
-1
lines changed

‎sharepoint/sharepoint-ps/sharepoint-online/New-SPOSite.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,7 @@ Accept wildcard characters: False
130130
```
131131

132132
### -ResourceQuota
133-
Specifies the quota for this site collection in Sandboxed Solutions units. This value must not exceed the company’s aggregate available Sandboxed Solutions quota. The default value is 0. For more information, see Resource Usage Limits on Sandboxed Solutions in SharePoint (https://msdn.microsoft.com/en-us/library/gg615462.aspx).
133+
Specifies the quota for this site collection in Sandboxed Solutions units. This value must not exceed the company’s aggregate available Sandboxed Solutions quota. The default value is 0. For more information, see Resource Usage Limits on Sandboxed Solutions in SharePoint (https://msdn.microsoft.com/en-us/library/gg615462.aspx). Note that this parameter is now obsolete and has been deprecated.
134134

135135

136136
```yaml

‎teams/teams-ps/teams/Get-CsBatchPolicyAssignmentOperation.md

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
---
2+
external help file: Microsoft.TeamsCmdlets.PowerShell.Custom.dll-Help.xml
3+
Module Name: MicrosoftTeams
4+
online version:
5+
schema: 2.0.0
6+
author: tomkau
7+
ms.author: tomkau
8+
ms.reviewer:
9+
---
10+
11+
# Get-CsBatchPolicyAssignmentOperation
12+
13+
## SYNOPSIS
14+
This cmdlet is used to assign retrieve the status of batch policy assignment operations.
15+
16+
Note: Status for batch policy assignment operations are retained for 30 days.
17+
18+
## SYNTAX
19+
20+
```
21+
Get-CsBatchPolicyAssignmentOperation [-OperationId <UniqueIdentifier>]
22+
```
23+
24+
## DESCRIPTION
25+
This cmdlets returns the status of all batch policy assignment operations for the last 30 days. If an operation ID is specified, the detailed status for that operation is returned including the status for each user in the batch.
26+
27+
## EXAMPLES
28+
29+
### Example 1
30+
In this example, the status of all batch assignment operations is returned.
31+
32+
```
33+
Get-CsBatchPolicyAssignmentOperation | ft OperationId, CreatedTime, CompletedTime, CompletedCount, ErrorCount
34+
35+
OperationId CreatedTime CompletedTime CompletedCount ErrorCount
36+
----------- ----------- ------------- -------------- ----------
37+
e640a5c9-c74f-4df7-b62e-4b01ae878bdc 7/19/2019 5:21:07 AM 7/19/2019 5:21:15 AM 8 0
38+
01b9b2b7-5dbb-487c-b4ea-887c7c66559c 7/30/2019 7:55:16 PM 7/30/2019 7:55:21 PM 8 0
39+
47bbc636-365d-4441-af34-9e0eceb05ef1 7/30/2019 8:14:22 PM 7/30/2019 8:14:33 PM 8 0
40+
3964004e-caa8-4eb4-b0d2-7dd2c8173c8c 7/30/2019 8:17:37 PM 7/30/2019 8:17:49 PM 8 0
41+
e70ef814-3289-4ee8-9402-5ec7ce1dde49 8/19/2019 8:16:25 PM 8/19/2019 8:16:34 PM 8 0
42+
001141c3-1daa-4da1-88e9-66cc01c511e1 8/19/2019 8:17:41 PM 8/19/2019 8:17:51 PM 8 1
43+
fd269d30-ae75-45b2-ad10-ec678940ef81 8/21/2019 11:28:01 PM 8/21/2019 11:28:07 PM 8 0
44+
7040dcc2-30fa-4d19-a280-09e824c8b7aa 8/21/2019 11:37:00 PM 8/21/2019 11:37:12 PM 8 0
45+
```
46+
47+
### Example 2
48+
In this example, the status of a single batch is returned, including the assignment status for each user. In this example, one of the users was not found.
49+
50+
```
51+
Get-CsBatchPolicyAssignmentOperation -OperationId 001141c3-1daa-4da1-88e9-66cc01c511e1 | Select -ExpandProperty UserState
52+
53+
Id Result State
54+
-- ------ -----
55+
user01@fabrikam.com Success Completed
56+
user02@fabrikam.com Success Completed
57+
user03@fabrikam.com Success Completed
58+
user04@fabrikam.com Success Completed
59+
user05@fabkam.com Error: User not found. Completed
60+
user06@fabrikam.com Success Completed
61+
user07@fabrikam.com Success Completed
62+
user08@fabrikam.com Success Completed
63+
```
64+
65+
## PARAMETERS
66+
67+
### -OperationId
68+
The ID of a batch policy assignment operation.
69+
70+
```yaml
71+
Type: String
72+
Parameter Sets:
73+
Aliases:
74+
75+
Required: False
76+
Position: Named
77+
Default value: None
78+
Accept pipeline input: False
79+
Accept wildcard characters: False
80+
```
81+
### CommonParameters
82+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
83+
For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
84+
85+
## INPUTS
86+
87+
## OUTPUTS
88+
89+
### OperationId
90+
The ID of the operation that can be used with the Get-CsBatchPolicyAssignmentOperation cmdlet to get the status of the operation.
91+
92+
### CompletedCount
93+
The number of users in the batch for which the assignment has been completed (possibly with an error).
94+
95+
### CompletedTime
96+
The date and time when the operation was completed.
97+
98+
### CreatedTime
99+
The date and time when the operation was created.
100+
101+
### ErrorCount
102+
The number of users in the batch for which the assignment failed.
103+
104+
### InProgressCount
105+
The number of users in the batch for which the assignment is in progress.
106+
107+
### NotStartedCount
108+
The number of users in the batch for which the assignment has not yet been performed.
109+
110+
### OperationId
111+
The ID of the operation.
112+
113+
### OperationName
114+
The name of the operation, if one was specific when the operation was created.
115+
116+
### OverallStatus
117+
The overall status of the operations: NotStarted, InProgress, Complete
118+
119+
### UserState
120+
Contains the status for each user in the batch.
121+
122+
**Id:** The ID of the user as specified when the batch was submitted. Either the user object ID (guid) or UPN/SIP/email.
123+
124+
**result:** The result of the assignment operation for the user: Success or an error.
125+
126+
**state:** The status for the user: NotStarted, InProgress, Completed
127+
128+
## NOTES
129+
130+
## RELATED LINKS
131+
132+
[New-CsBatchPolicyAssignmentOperation]()

‎teams/teams-ps/teams/New-CsBatchPolicyAssignmentOperation.md

Lines changed: 131 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,131 @@
1+
---
2+
external help file: Microsoft.TeamsCmdlets.PowerShell.Custom.dll-Help.xml
3+
Module Name: MicrosoftTeams
4+
online version:
5+
schema: 2.0.0
6+
author: tomkau
7+
ms.author: tomkau
8+
ms.reviewer:
9+
---
10+
11+
# New-CsBatchPolicyAssignmentOperation
12+
13+
## SYNOPSIS
14+
This cmdlet is used to assign a policy to a batch of users. A batch may contain up to 20,000 users.
15+
16+
## SYNTAX
17+
18+
```
19+
New-CsBatchPolicyAssignmentOperation -PolicyType <String> -PolicyName <String> -Identity <Array> [-OperationName <String>]
20+
```
21+
22+
## DESCRIPTION
23+
When a policy is assigned to a batch of users, the assignments are performed as an asynchronous operation. The cmdlet returns the operation ID which can be used to track the progress and status of the assignments.
24+
25+
Users can be specified by their object ID (guid) or by their UPN/SIP/email (user@contoso.com).
26+
27+
## EXAMPLES
28+
29+
### Example 1
30+
In this example, the batch of users is specified as an array of user email addresses.
31+
32+
```
33+
$users_ids = @("psmith@contoso.com","tsanchez@contoso.com","bharvest@contoso.com")
34+
New-CsBatchPolicyAssignmentOperation -PolicyType TeamsMeetingPolicy -PolicyName Kiosk -Identity $users_ids -OperationName "Example 1 batch"
35+
```
36+
37+
### Example 2
38+
In this example, the batch of users is read from a text file containing user object IDs (guids).
39+
40+
```
41+
$user_ids = Get-Content .\users_ids.txt
42+
New-CsBatchPolicyAssignmentOperation -PolicyType TeamsMeetingPolicy -PolicyName Kiosk -Identity $users_ids -OperationName "Example 1 batch"
43+
```
44+
45+
### Example 3
46+
In this example, the batch of users is obtained by connecting to Azure AD and retrieving a collection of users and then referencing their user principal names.
47+
48+
```
49+
Connect-AzureAD
50+
$users = Get-AzureADUser
51+
New-CsBatchPolicyAssignmentOperation -PolicyType TeamsMeetingPolicy -PolicyName Kiosk -Identity $users.UserPrincipalName -OperationName "Example 1 batch"
52+
```
53+
54+
## PARAMETERS
55+
56+
### -Identity
57+
An array of users, specified either as object IDs (guid) or as UPN/SIP/email. There is a maximum of 20,000 users per batch.
58+
59+
```yaml
60+
Type: String
61+
Parameter Sets:
62+
Aliases:
63+
64+
Required: True
65+
Position: Named
66+
Default value: None
67+
Accept pipeline input: False
68+
Accept wildcard characters: False
69+
```
70+
71+
### -PolicyName
72+
The name of the policy to be assigned to the users.
73+
74+
```yaml
75+
Type: String
76+
Parameter Sets:
77+
Aliases:
78+
79+
Required: True
80+
Position: Named
81+
Default value: None
82+
Accept pipeline input: False
83+
Accept wildcard characters: False
84+
```
85+
86+
### -PolicyType
87+
The name of the policy to be assigned to the users.
88+
89+
```yaml
90+
Type: String
91+
Parameter Sets:
92+
Aliases:
93+
94+
Required: True
95+
Position: Named
96+
Default value: None
97+
Accept pipeline input: False
98+
Accept wildcard characters: False
99+
```
100+
101+
### -OperationName
102+
An optional name for the batch assignment operation.
103+
104+
```yaml
105+
Type: String
106+
Parameter Sets:
107+
Aliases:
108+
109+
Required: False
110+
Position: Named
111+
Default value: None
112+
Accept pipeline input: False
113+
Accept wildcard characters: False
114+
```
115+
116+
### CommonParameters
117+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
118+
For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
119+
120+
## INPUTS
121+
122+
## OUTPUTS
123+
124+
### OperationId
125+
The ID of the operation that can be used with the Get-CsBatchPolicyAssignmentOperation cmdlet to get the status of the operation.
126+
127+
## NOTES
128+
129+
## RELATED LINKS
130+
131+
[Get-CsBatchPolicyAssignmentOperation]()

0 commit comments

Comments
 (0)