|
1 |
| ---- |
2 |
| -external help file: MicrosoftTeams-help.xml |
3 |
| -Module Name: MicrosoftTeams |
4 |
| -online version: https://learn.microsoft.com/powershell/module/teams/grant-csteamsfilespolicy |
5 |
| -schema: 2.0.0 |
6 |
| ---- |
7 |
| - |
8 |
| -# Grant-CsTeamsFilesPolicy |
9 |
| - |
10 |
| -## SYNOPSIS |
11 |
| -Assigns an online teams files policy to a user account, to a group of users, or set the tenant Global instance. |
12 |
| -Online teams files policies manage usages of files-related features. |
13 |
| - |
14 |
| -## SYNTAX |
15 |
| - |
16 |
| -### GrantToTenant (Default) |
17 |
| -``` |
18 |
| -Grant-CsTeamsFilesPolicy [-Global] [[-PolicyName] <String>] [<CommonParameters>] |
19 |
| -
|
20 |
| -``` |
21 |
| - |
22 |
| -### GrantToGroup |
23 |
| -``` |
24 |
| -Grant-CsTeamsFilesPolicy [[-PolicyName] <String>] [-Group] <String> [<CommonParameters>] |
25 |
| -``` |
26 |
| - |
27 |
| -### Identity |
28 |
| -``` |
29 |
| -Grant-CsTeamsFilesPolicy [[-PolicyName] <String>] [-Identity <String>] [<CommonParameters>] |
30 |
| -``` |
31 |
| - |
32 |
| -## DESCRIPTION |
33 |
| -This cmdlet assigns an existing user-specific online teams files policy to a user, a group of users, or the Global policy instance. |
34 |
| - |
35 |
| -## EXAMPLES |
36 |
| - |
37 |
| -### Example 1 |
38 |
| -``` |
39 |
| -Grant-CsTeamsFilesPolicy -Identity "[email protected]" -PolicyName NativeEntrypointDisabled |
40 |
| -``` |
41 |
| - |
42 |
| -The command shown in Example 1 assigns the per-user online teams files policy NativeEntrypointDisabled to a single user [email protected]. |
43 |
| - |
44 |
| -### Example 2 |
45 |
| -``` |
46 |
| -Grant-CsTeamsFilesPolicy -Group [email protected] -PolicyName NativeEntrypointDisabled |
47 |
| -``` |
48 |
| - |
49 |
| -The command shown in Example 2 assigns the online teams files policy NativeEntrypointDisabled to the members of the group [email protected]. |
50 |
| - |
51 |
| -## PARAMETERS |
52 |
| - |
53 |
| -### -Global |
54 |
| -Sets the parameters of the Global policy instance to the values in the specified policy instance. |
55 |
| - |
56 |
| -```yaml |
57 |
| -Type: SwitchParameter |
58 |
| -Parameter Sets: GrantToTenant |
59 |
| -Aliases: |
60 |
| - |
61 |
| -Required: False |
62 |
| -Position: Named |
63 |
| -Default value: None |
64 |
| -Accept pipeline input: False |
65 |
| -Accept wildcard characters: False |
66 |
| -``` |
67 |
| -
|
68 |
| -### -PolicyName |
69 |
| -A unique identifier(name) of the policy. |
70 |
| -
|
71 |
| -```yaml |
72 |
| -Type: String |
73 |
| -Parameter Sets: (All) |
74 |
| -Aliases: |
75 |
| - |
76 |
| -Required: False |
77 |
| -Position: 1 |
78 |
| -Default value: None |
79 |
| -Accept pipeline input: False |
80 |
| -Accept wildcard characters: False |
81 |
| -``` |
82 |
| -
|
83 |
| -### -Group |
84 |
| -Specifies the group used for the group policy assignment. |
85 |
| -
|
86 |
| -```yaml |
87 |
| -Type: String |
88 |
| -Parameter Sets: GrantToGroup |
89 |
| -Aliases: |
90 |
| - |
91 |
| -Required: True |
92 |
| -Position: 0 |
93 |
| -Default value: None |
94 |
| -Accept pipeline input: False |
95 |
| -Accept wildcard characters: False |
96 |
| -``` |
97 |
| -
|
98 |
| -### -Identity |
99 |
| -The Identity parameter represents the ID of the specific user in your organization; this can be either a SIP address or an Object ID. |
100 |
| -
|
101 |
| -```yaml |
102 |
| -Type: String |
103 |
| -Parameter Sets: Identity |
104 |
| -Aliases: |
105 |
| - |
106 |
| -Required: False |
107 |
| -Position: Named |
108 |
| -Default value: None |
109 |
| -Accept pipeline input: True (ByPropertyName, ByValue) |
110 |
| -Accept wildcard characters: False |
111 |
| -``` |
112 |
| -
|
113 |
| -### CommonParameters |
114 |
| -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). |
115 |
| -
|
116 |
| -## INPUTS |
117 |
| -
|
118 |
| -## OUTPUTS |
119 |
| -
|
120 |
| -## NOTES |
121 |
| -The GrantToGroup syntax is supported in Teams PowerShell Module 4.5.1-preview or later. |
122 |
| -
|
123 |
| -## RELATED LINKS |
124 |
| -
|
125 |
| -[Get-CsTeamsFilesPolicy](https://learn.microsoft.com/powershell/module/teams/get-csteamsfilespolicy) |
126 |
| -
|
127 |
| -[Get-CsTeamsFilesPolicy](https://learn.microsoft.com/powershell/module/teams/set-csteamsfilespolicy) |
128 |
| -
|
129 |
| -[Get-CsTeamsFilesPolicy](https://learn.microsoft.com/powershell/module/teams/new-csteamsfilespolicy) |
130 |
| -
|
131 |
| -[Get-CsTeamsFilesPolicy](https://learn.microsoft.com/powershell/module/teams/remove-csteamsfilespolicy) |
| 1 | +--- |
| 2 | +external help file: Microsoft.Teams.Policy.Administration.Cmdlets.Core.dll-Help.xml |
| 3 | +Module Name: MicrosoftTeams |
| 4 | +online version: https://learn.microsoft.com/powershell/module/teams/grant-csteamsfilespolicy |
| 5 | +schema: 2.0.0 |
| 6 | +--- |
| 7 | + |
| 8 | +# Grant-CsTeamsFilesPolicy |
| 9 | + |
| 10 | +## SYNOPSIS |
| 11 | + |
| 12 | +This cmdlet applies an instance of the Teams AI policy to users or groups in a tenant. |
| 13 | + |
| 14 | +## SYNTAX |
| 15 | + |
| 16 | +### Identity (Default) |
| 17 | + |
| 18 | +```powershell |
| 19 | +Grant-CsTeamsFilesPolicy [<CommonParameters>] |
| 20 | +``` |
| 21 | + |
| 22 | +### GrantToUser |
| 23 | + |
| 24 | +```powershell |
| 25 | +Grant-CsTeamsFilesPolicy -Identity <String> [[-PolicyName] <String>] [<CommonParameters>] |
| 26 | +``` |
| 27 | + |
| 28 | +### GrantToGroup |
| 29 | + |
| 30 | +```powershell |
| 31 | +Grant-CsTeamsFilesPolicy [[-PolicyName] <String>] [-Group] <String> -Rank <Int32> [<CommonParameters>] |
| 32 | +``` |
| 33 | + |
| 34 | +### GrantToTenant |
| 35 | + |
| 36 | +```powershell |
| 37 | +Grant-CsTeamsFilesPolicy [[-PolicyName] <String>] [-Global] [-Force] [<CommonParameters>] |
| 38 | +``` |
| 39 | + |
| 40 | +## DESCRIPTION |
| 41 | + |
| 42 | +The Teams Files Policy is used to modify files related settings in Microsoft teams. |
| 43 | + |
| 44 | +## EXAMPLES |
| 45 | + |
| 46 | +### Example 1 |
| 47 | + |
| 48 | +```powershell |
| 49 | +PS C:\> Grant-CsTeamsFilesPolicy -PolicyName Test -Identity [email protected] |
| 50 | +``` |
| 51 | + |
| 52 | +Assigns a given policy to a user. |
| 53 | + |
| 54 | +### Example 2 |
| 55 | + |
| 56 | +```powershell |
| 57 | +PS C:\> Grant-CsTeamsFilesPolicy -Group f13d6c9d-ce76-422c-af78-b6018b4d9c80 -PolicyName Test |
| 58 | +``` |
| 59 | + |
| 60 | +Assigns a given policy to a group. |
| 61 | + |
| 62 | +### Example 3 |
| 63 | + |
| 64 | +```powershell |
| 65 | +PS C:\> Grant-CsTeamsFilesPolicy -Global -PolicyName Test |
| 66 | +``` |
| 67 | + |
| 68 | +Assigns a given policy to the tenant. |
| 69 | + |
| 70 | +### Example 4 |
| 71 | + |
| 72 | +```powershell |
| 73 | +PS C:\> Grant-CsTeamsFilesPolicy -Global -PolicyName Test |
| 74 | +``` |
| 75 | + |
| 76 | +Note: _Using $null in place of a policy name can be used to unassigned a policy instance._ |
| 77 | + |
| 78 | +## PARAMETERS |
| 79 | + |
| 80 | +### -Force |
| 81 | + |
| 82 | +Suppresses the display of any non-fatal error message that might arise when running the command. |
| 83 | + |
| 84 | +```yaml |
| 85 | +Type: SwitchParameter |
| 86 | +Parameter Sets: GrantToTenant |
| 87 | +Aliases: |
| 88 | + |
| 89 | +Required: False |
| 90 | +Position: Named |
| 91 | +Default value: None |
| 92 | +Accept pipeline input: False |
| 93 | +Accept wildcard characters: False |
| 94 | +``` |
| 95 | +
|
| 96 | +### -Global |
| 97 | +
|
| 98 | +This is the equivalent to `-Identity Global`. |
| 99 | + |
| 100 | +```yaml |
| 101 | +Type: SwitchParameter |
| 102 | +Parameter Sets: GrantToTenant |
| 103 | +Aliases: |
| 104 | +
|
| 105 | +Required: True |
| 106 | +Position: 0 |
| 107 | +Default value: None |
| 108 | +Accept pipeline input: False |
| 109 | +Accept wildcard characters: False |
| 110 | +``` |
| 111 | + |
| 112 | +### -Group |
| 113 | + |
| 114 | +This is the identifier of the group that the policy should be assigned to. |
| 115 | + |
| 116 | +```yaml |
| 117 | +Type: String |
| 118 | +Parameter Sets: GrantToGroup |
| 119 | +Aliases: |
| 120 | +
|
| 121 | +Required: True |
| 122 | +Position: 0 |
| 123 | +Default value: None |
| 124 | +Accept pipeline input: False |
| 125 | +Accept wildcard characters: False |
| 126 | +``` |
| 127 | + |
| 128 | +### -Identity |
| 129 | + |
| 130 | +Specifies the identity of the target user. |
| 131 | + |
| 132 | + |
| 133 | + |
| 134 | +Example: 98403f08-577c-46dd-851a-f0460a13b03d |
| 135 | + |
| 136 | +Use the "Global" Identity if you wish to set the policy for the entire tenant. |
| 137 | + |
| 138 | +```yaml |
| 139 | +Type: String |
| 140 | +Parameter Sets: GrantToUser |
| 141 | +Aliases: |
| 142 | +
|
| 143 | +Required: True |
| 144 | +Position: Named |
| 145 | +Default value: None |
| 146 | +Accept pipeline input: True (ByPropertyName, ByValue) |
| 147 | +Accept wildcard characters: False |
| 148 | +``` |
| 149 | + |
| 150 | +### -PolicyName |
| 151 | + |
| 152 | +Specifies the name of the policy to be assigned. The PolicyName is the policy identity minus the policy scope ("tag:"), for example, a policy that has an identity of "Tag:Enabled" has a PolicyName of "Enabled". |
| 153 | + |
| 154 | +```yaml |
| 155 | +Type: String |
| 156 | +Parameter Sets: GrantToUser, GrantToGroup, GrantToTenant |
| 157 | +Aliases: |
| 158 | +
|
| 159 | +Required: False |
| 160 | +Position: 1 |
| 161 | +Default value: None |
| 162 | +Accept pipeline input: False |
| 163 | +Accept wildcard characters: False |
| 164 | +``` |
| 165 | + |
| 166 | +### -Rank |
| 167 | + |
| 168 | +The rank of the policy assignment, relative to other group policy assignments for the same policy type. |
| 169 | + |
| 170 | +```yaml |
| 171 | +Type: Int32 |
| 172 | +Parameter Sets: GrantToGroup |
| 173 | +Aliases: |
| 174 | +
|
| 175 | +Required: True |
| 176 | +Position: Named |
| 177 | +Default value: None |
| 178 | +Accept pipeline input: False |
| 179 | +Accept wildcard characters: False |
| 180 | +``` |
| 181 | + |
| 182 | +### CommonParameters |
| 183 | + |
| 184 | +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). |
| 185 | + |
| 186 | +## INPUTS |
| 187 | + |
| 188 | +### System.String |
| 189 | + |
| 190 | +## OUTPUTS |
| 191 | + |
| 192 | +### System.Object |
| 193 | + |
| 194 | +## NOTES |
| 195 | + |
| 196 | +## RELATED LINKS |
| 197 | + |
| 198 | +[Grant-CsTeamsFilesPolicy](Grant-CsTeamsFilesPolicy.md) |
| 199 | + |
| 200 | +[Remove-CsTeamsFilesPolicy](Remove-CsTeamsFilesPolicy.md) |
| 201 | + |
| 202 | +[Get-CsTeamsFilesPolicy](Get-CsTeamsFilesPolicy.md) |
| 203 | + |
| 204 | +[Set-CsTeamsFilesPolicy](Set-CsTeamsFilesPolicy.md) |
| 205 | + |
| 206 | +[New-CsTeamsFilesPolicy](New-CsTeamsFilesPolicy.md) |
0 commit comments