Set-WssUserGroupAccess
Set-WssUserGroupAccess
Modifies access for user groups.
Syntax
Parameter Set: Default
Set-WssUserGroupAccess -Name <String> [-GrantAccess <WSSGroupType> {RemoteAccess | ShareAccess | ComputerAccess | MediaAccess | DashboardAccess | HomePageLinks | VpnAccess} ] [-RevokeAccess <WSSGroupType> {RemoteAccess | ShareAccess | ComputerAccess | MediaAccess | DashboardAccess | HomePageLinks | VpnAccess} ] [ <CommonParameters>]
Detailed Description
The Set-WssUserGroupAccess cmdlet modifies access for user groups.
Parameters
-GrantAccess<WSSGroupType>
Specifies the access to grant. The cmdlet grants the access that you specify to users in the user group. To grant more than one type of access, run the cmdlet for each type to grant. The acceptable values for this parameter are:
-- 1 RemoteAccess
-- 2 ShareAccess
-- 3 ComputerAccess
-- 4 MediaAccess
-- 6 DashboardAccess
-- 7 HomePageLinks
-- 9 VpnAccess
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies a name. The cmdlet modifies access for the group that you specify by name.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-RevokeAccess<WSSGroupType>
Specifies the access to revoke. The cmdlet revokes the access that you specify to users in the user group. To revoke more than one type of access, use the cmdlet for each type to revoke. The acceptable values for this parameter are:
-- 1 RemoteAccess
-- 2 ShareAccess
-- 3 ComputerAccess
-- 4 MediaAccess
-- 6 DashboardAccess
-- 7 HomePageLinks
-- 9 VpnAccess
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Grant ShareAccess to a group
This command grants ShareAccess to the group named HRGroup. The GrantAccess parameter specifies a value of 2, which corresponds to ShareAccess.
PS C:\> Set-WssUserGroupAccess -Name "HRGroup" -GrantAccess 2