Revoke-DfsrDelegation
Revoke-DfsrDelegation
Revokes delegation of permissions in a replication group.
Syntax
Parameter Set: Default
Revoke-DfsrDelegation [-GroupName] <String[]> [-AccountName] <String[]> [[-DomainName] <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Revoke-DfsrDelegation cmdlet revokes delegation of permissions for users or groups to create replicated folders, connections, members, and memberships inside a replication group. For information about delegation, see the Grant-DfsrDelegation cmdlet.
Parameters
-AccountName<String[]>
Specifies an array of security principals to remove. The security principals include users and groups.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DomainName<String>
Specifies the NetBIOS name or fully qualified domain name (FQDN) for the Active Directory® Domain Services () domain that contains the replication group. If you do not specify this parameter, the cmdlet uses the domain of the current user.
Aliases |
none |
Required? |
false |
Position? |
101 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Force
Forces the command to run without asking for user confirmation. Use this parameter for scripted revocation of delegation.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-GroupName<String[]>
Specifies an array of names of replication groups. You can specify multiple groups, separated by commas, as well as wildcard characters (*).
Aliases |
RG,RgName |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue, ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
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: Revoke delegation for a group
This command revokes delegation of permissions from the group named DFSR Admins for the replication group named RG06.
PS C:\> Revoke-DfsrDelegation -GroupName "RG06" -AccountName "DFSR Admins"
Example 2: Revoke delegtion for a group without confirmation
This command revokes delegation of permissions from the group named DFSR Admins for the replication group named RG06. The command specifies the Verbose parameter. This Windows PowerShell® common parameter causes the command to display details about the operation. For more information, type Get-Help about_CommonParameters
. The command specifies the Force parameter, and, therefore, the cmdlet does not prompt you for confirmation.
PS C:\> Revoke-DfsrDelegation -GroupName RG06 -AccountName "DFSR Admins" -Verbose -Force