Skip to content

Commit c750b87

Browse files
tomkautomkau
authored
Update Get-CsGroupPolicyAssignment.md
1 parent 91ee0fa commit c750b87

File tree

1 file changed

+52
-70
lines changed

1 file changed

+52
-70
lines changed

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

Lines changed: 52 additions & 70 deletions
Original file line numberDiff line numberDiff line change
@@ -16,54 +16,72 @@ This cmdlet is used to return group policy assignments.
1616
## SYNTAX
1717

1818
```
19-
Get-CsGroupPolicyAssignment [-GroupId ] [-PolicyType ]
19+
Get-CsGroupPolicyAssignment [-GroupId] [-PolicyType]
2020
```
2121

2222
## DESCRIPTION
23-
sss
23+
This cmdlets returns group policy assignments. Optional parameters allow the results to be restricted to policies assigned to a specific group or policies of a specific type.
2424

2525
## EXAMPLES
2626

2727
### Example 1
28-
In this example, the status of all batch assignment operations is returned.
28+
In this example, all group policy assignments are returned.
2929

3030
```
31-
Get-CsBatchPolicyAssignmentOperation | ft OperationId, CreatedTime, CompletedTime, CompletedCount, ErrorCount
32-
33-
OperationId CreatedTime CompletedTime CompletedCount ErrorCount
34-
----------- ----------- ------------- -------------- ----------
35-
e640a5c9-c74f-4df7-b62e-4b01ae878bdc 7/19/2019 5:21:07 AM 7/19/2019 5:21:15 AM 8 0
36-
01b9b2b7-5dbb-487c-b4ea-887c7c66559c 7/30/2019 7:55:16 PM 7/30/2019 7:55:21 PM 8 0
37-
47bbc636-365d-4441-af34-9e0eceb05ef1 7/30/2019 8:14:22 PM 7/30/2019 8:14:33 PM 8 0
38-
3964004e-caa8-4eb4-b0d2-7dd2c8173c8c 7/30/2019 8:17:37 PM 7/30/2019 8:17:49 PM 8 0
39-
e70ef814-3289-4ee8-9402-5ec7ce1dde49 8/19/2019 8:16:25 PM 8/19/2019 8:16:34 PM 8 0
40-
001141c3-1daa-4da1-88e9-66cc01c511e1 8/19/2019 8:17:41 PM 8/19/2019 8:17:51 PM 8 1
41-
fd269d30-ae75-45b2-ad10-ec678940ef81 8/21/2019 11:28:01 PM 8/21/2019 11:28:07 PM 8 0
42-
7040dcc2-30fa-4d19-a280-09e824c8b7aa 8/21/2019 11:37:00 PM 8/21/2019 11:37:12 PM 8 0
31+
Get-CsGroupPolicyAssignment
32+
33+
GroupId PolicyName PolicyType Priority
34+
------- ---------- ---------- --------
35+
d8ebfa45-0f28-4d2d-9bcc-b158a49e2d17 Host:AllOn TeamsMeetingPolicy 1
36+
e050ce51-54bc-45b7-b3e6-c00343d31274 Tenant:SalesMessaging TeamsMessagingPolicy 2
37+
e050ce51-54bc-45b7-b3e6-c00343d31274 Host:AllOff TeamsMeetingPolicy 2
38+
566b8d39-5c5c-4aaa-bc07-4f36278a1b38 Host:Kiosk TeamsMeetingPolicy 3
4339
```
4440

4541
### Example 2
46-
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.
42+
In this example, only the policies assigned to a specific group are returned.
4743

4844
```
49-
Get-CsBatchPolicyAssignmentOperation -OperationId 001141c3-1daa-4da1-88e9-66cc01c511e1 | Select -ExpandProperty UserState
50-
51-
Id Result State
52-
-- ------ -----
53-
user01@fabrikam.com Success Completed
54-
user02@fabrikam.com Success Completed
55-
user03@fabrikam.com Success Completed
56-
user04@fabrikam.com Success Completed
57-
user05@fabkam.com Error: User not found. Completed
58-
user06@fabrikam.com Success Completed
59-
user07@fabrikam.com Success Completed
60-
user08@fabrikam.com Success Completed
45+
Get-CsGroupPolicyAssignment -GroupId e050ce51-54bc-45b7-b3e6-c00343d31274
46+
47+
GroupId PolicyName PolicyType Priority
48+
------- ---------- ---------- --------
49+
e050ce51-54bc-45b7-b3e6-c00343d31274 Tenant:SalesMessaging TeamsMessagingPolicy 2
50+
e050ce51-54bc-45b7-b3e6-c00343d31274 Host:AllOff TeamsMeetingPolicy 2
51+
```
52+
53+
### Example 3
54+
In this example, only the policies of a specific type are returned.
55+
56+
Get-CsGroupPolicyAssignment -PolicyType TeamsMeetingPolicy
57+
58+
```
59+
GroupId PolicyName PolicyType Priority
60+
------- ---------- ---------- --------
61+
d8ebfa45-0f28-4d2d-9bcc-b158a49e2d17 Host:AllOn TeamsMeetingPolicy 1
62+
e050ce51-54bc-45b7-b3e6-c00343d31274 Host:AllOff TeamsMeetingPolicy 2
63+
566b8d39-5c5c-4aaa-bc07-4f36278a1b38 Host:Kiosk TeamsMeetingPolicy 3
6164
```
6265

6366
## PARAMETERS
6467

65-
### -OperationId
66-
The ID of a batch policy assignment operation.
68+
### -GroupId
69+
The ID of a group whose policy assignments will be returned.
70+
71+
```yaml
72+
Type: String
73+
Parameter Sets:
74+
Aliases:
75+
76+
Required: False
77+
Position: Named
78+
Default value: None
79+
Accept pipeline input: False
80+
Accept wildcard characters: False
81+
```
82+
83+
### -PolicyType
84+
The policy type for which group policy assignments will be returned.
6785
6886
```yaml
6987
Type: String
@@ -76,6 +94,7 @@ Default value: None
7694
Accept pipeline input: False
7795
Accept wildcard characters: False
7896
```
97+
7998
### CommonParameters
8099
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
81100
For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
@@ -84,47 +103,10 @@ For more information, see about_CommonParameters (https://go.microsoft.com/fwlin
84103
85104
## OUTPUTS
86105
87-
### OperationId
88-
The ID of the operation that can be used with the Get-CsBatchPolicyAssignmentOperation cmdlet to get the status of the operation.
89-
90-
### CompletedCount
91-
The number of users in the batch for which the assignment has been completed (possibly with an error).
92-
93-
### CompletedTime
94-
The date and time when the operation was completed.
95-
96-
### CreatedTime
97-
The date and time when the operation was created.
98-
99-
### ErrorCount
100-
The number of users in the batch for which the assignment failed.
101-
102-
### InProgressCount
103-
The number of users in the batch for which the assignment is in progress.
104-
105-
### NotStartedCount
106-
The number of users in the batch for which the assignment has not yet been performed.
107-
108-
### OperationId
109-
The ID of the operation.
110-
111-
### OperationName
112-
The name of the operation, if one was specific when the operation was created.
113-
114-
### OverallStatus
115-
The overall status of the operations: NotStarted, InProgress, Complete
116-
117-
### UserState
118-
Contains the status for each user in the batch.
119-
120-
**Id:** The ID of the user as specified when the batch was submitted. Either the user object ID (guid) or UPN/SIP/email.
121-
122-
**result:** The result of the assignment operation for the user: Success or an error.
123-
124-
**state:** The status for the user: NotStarted, InProgress, Completed
125-
126106
## NOTES
127107
128108
## RELATED LINKS
129109
130-
[New-CsBatchPolicyAssignmentOperation]()
110+
[New-CsGroupPolicyAssignment]()
111+
[Set-CsBatchPolicyAssignment]()
112+
[Remove-CsBatchPolicyAssignment]()

0 commit comments

Comments
 (0)