Skip to content

Commit cfb566a

Browse files
Adding missing Teams Targeting Policy cmdlets
1 parent 1bf2aad commit cfb566a

File tree

3 files changed

+432
-0
lines changed

3 files changed

+432
-0
lines changed
Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
---
2+
external help file: MicrosoftTeams-help.xml
3+
Module Name: MicrosoftTeams
4+
online version: https://learn.microsoft.com/powershell/module/teams/get-csteamstargetingpolicy
5+
schema: 2.0.0
6+
---
7+
8+
# Get-CsTeamsTargetingPolicy
9+
10+
## SYNOPSIS
11+
12+
The Teams Targeting Policy cmdlets enable administrators to control the type of Tenant tag setting that users can create or the features that they can access while in a meeting. It also helps determine how meetings deal with anonymous or external users.
13+
14+
## SYNTAX
15+
16+
### Identity (Default)
17+
18+
```powershell
19+
Get-CsTeamsTargetingPolicy [[-Identity] <String>] [-MsftInternalProcessingMode <String>] [<CommonParameters>]
20+
```
21+
22+
### Filter
23+
24+
```powershell
25+
Get-CsTeamsTargetingPolicy [-MsftInternalProcessingMode <String>] [-Filter <String>] [<CommonParameters>]
26+
```
27+
28+
## DESCRIPTION
29+
30+
The CsTeamsTargetingPolicy cmdlets enable administrators to control the type of tags that users can create or the features that they can access in Teams. It also helps determine how tags deal with Teams members or guest users.
31+
32+
The Get-CsTeamsTargetingPolicy cmdlet enables you to return information about all the Tenant tag setting policies that have been configured for use in your organization.
33+
34+
## EXAMPLES
35+
36+
### Example 1
37+
38+
```powershell
39+
PS C:\> Get-CsTeamsTargetingPolicy -Identity SalesPolicy
40+
```
41+
42+
In this example Get-CsTeamsTargetingPolicy is used to return the per-tenant tag policy that has an Identity SalesPolicy. Because identities are unique, this command will never return more than one item.
43+
44+
## PARAMETERS
45+
46+
### -Filter
47+
48+
Enables you to use wildcard characters when indicating the policy (or policies) to be returned.
49+
50+
```yaml
51+
Type: String
52+
Parameter Sets: Filter
53+
Aliases:
54+
55+
Required: False
56+
Position: Named
57+
Default value: None
58+
Accept pipeline input: False
59+
Accept wildcard characters: False
60+
```
61+
62+
### -Identity
63+
64+
Unique identifier of the policy to be returned. To refer to the global policy, use this syntax: -Identity global. To refer to a per-tenant policy, use syntax similar to this: -Identity SalesDepartmentPolicy. If this parameter is omitted, then all the tenant tag setting policies configured for use in your organization will be returned.
65+
66+
```yaml
67+
Type: String
68+
Parameter Sets: Identity
69+
Aliases:
70+
71+
Required: False
72+
Position: 1
73+
Default value: None
74+
Accept pipeline input: False
75+
Accept wildcard characters: False
76+
```
77+
78+
### -MsftInternalProcessingMode
79+
80+
For Internal use only.
81+
82+
```yaml
83+
Type: String
84+
Parameter Sets: (All)
85+
Aliases:
86+
87+
Required: False
88+
Position: Named
89+
Default value: None
90+
Accept pipeline input: False
91+
Accept wildcard characters: False
92+
```
93+
94+
### CommonParameters
95+
96+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
97+
98+
## INPUTS
99+
100+
### System.String
101+
102+
## OUTPUTS
103+
104+
### System.Object
105+
106+
## NOTES
107+
108+
## RELATED LINKS
109+
[Set-CsTargetingPolicy](https://learn.microsoft.com/powershell/module/teams/set-csteamstargetingpolicy)
110+
[Remove-CsTargetingPolicy](https://learn.microsoft.com/powershell/module/teams/remove-csteamstargetingpolicy)
Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
---
2+
external help file: MicrosoftTeams-help.xml
3+
Module Name: MicrosoftTeams
4+
online version: https://learn.microsoft.com/powershell/module/teams/remove-csteamstargetingpolicy
5+
schema: 2.0.0
6+
---
7+
8+
# Remove-CsTeamsTargetingPolicy
9+
10+
## SYNOPSIS
11+
12+
The CsTeamsTargetingPolicy cmdlets removes a previously created CsTeamsTargetingPolicy.
13+
14+
## SYNTAX
15+
16+
```powershell
17+
Remove-CsTeamsTargetingPolicy [-Identity] <String> [-MsftInternalProcessingMode <String>] [-WhatIf] [-Confirm]
18+
[<CommonParameters>]
19+
```
20+
21+
## DESCRIPTION
22+
23+
Deletes a previously created TeamsTargetingPolicy. Any users with no explicitly assigned policies will then fall back to the default policy in the organization.
24+
25+
## EXAMPLES
26+
27+
### Example 1
28+
29+
```powershell
30+
PS C:\> Remove-CsTeamsMeetingPolicy -Identity StudentTagPolicy
31+
```
32+
33+
In the example shown above, the command will delete the student tag policy from the organization's list of policies and remove all assignments of this policy from users who have had the policy assigned.
34+
35+
## PARAMETERS
36+
37+
### -Confirm
38+
39+
Prompts you for confirmation before running the cmdlet.
40+
41+
```yaml
42+
Type: SwitchParameter
43+
Parameter Sets: (All)
44+
Aliases: cf
45+
46+
Required: False
47+
Position: Named
48+
Default value: None
49+
Accept pipeline input: False
50+
Accept wildcard characters: False
51+
```
52+
53+
### -Identity
54+
55+
Unique identifier for the teams meeting policy to be removed. To remove the global policy, use this syntax: -Identity global. (Note that the global policy cannot actually be removed. Instead, all the policy properties will be reset to their default values.) To remove a custom policy, use this syntax: -Identity StudentTagPolicy.
56+
57+
```yaml
58+
Type: String
59+
Parameter Sets: (All)
60+
Aliases:
61+
62+
Required: True
63+
Position: 1
64+
Default value: None
65+
Accept pipeline input: True (ByPropertyName)
66+
Accept wildcard characters: False
67+
```
68+
69+
### -MsftInternalProcessingMode
70+
71+
For Internal use only.
72+
73+
```yaml
74+
Type: String
75+
Parameter Sets: (All)
76+
Aliases:
77+
78+
Required: False
79+
Position: Named
80+
Default value: None
81+
Accept pipeline input: False
82+
Accept wildcard characters: False
83+
```
84+
85+
### -WhatIf
86+
87+
Shows what would happen if the cmdlet runs.
88+
The cmdlet is not run.
89+
90+
```yaml
91+
Type: SwitchParameter
92+
Parameter Sets: (All)
93+
Aliases: wi
94+
95+
Required: False
96+
Position: Named
97+
Default value: None
98+
Accept pipeline input: False
99+
Accept wildcard characters: False
100+
```
101+
102+
### CommonParameters
103+
104+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
105+
106+
## INPUTS
107+
108+
### System.String
109+
110+
## OUTPUTS
111+
112+
### System.Object
113+
114+
## NOTES
115+
116+
## RELATED LINKS
117+
118+
[Get-CsTargetingPolicy](https://learn.microsoft.com/powershell/module/teams/get-csteamstargetingpolicy)
119+
[Set-CsTargetingPolicy](https://learn.microsoft.com/powershell/module/teams/set-csteamstargetingpolicy)

0 commit comments

Comments
 (0)