Skip to content

Invoke-MutatieUit

SYNOPSIS

Processes a mutation for removing an Active Directory user's group memberships.

SYNTAX

Invoke-MutatieUit [-Gebruiker] <Object> [-TaskNr] <String> [[-Rechten] <Array>] [-MobielePloeg] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

The `Invoke-MutatieUit` function removes specified group memberships for an Active Directory user. It supports filtering groups to exclude specific ones, handles mobile team rights, and logs the mutation task in Active Directory.

EXAMPLES

EXAMPLE 1

Invoke-MutatieUit -Gebruiker "jdoe" -TaskNr "12345"

Processes the mutation for the user "jdoe" and logs the task with number "12345."

EXAMPLE 2

Invoke-MutatieUit -Gebruiker "jdoe" -TaskNr "12345" -Rechten @("Group1", "Group2")

Removes the specified groups "Group1" and "Group2" from the user "jdoe" and logs the task.

EXAMPLE 3

Invoke-MutatieUit -Gebruiker "jdoe" -TaskNr "12345" -MobielePloeg

Processes the mutation for the user "jdoe" and includes mobile team rights in the process.

PARAMETERS

-Gebruiker

The identity of the Active Directory user (e.g., DistinguishedName or SamAccountName).

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-TaskNr

The task number associated with the mutation process.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Rechten

An array of group memberships to be removed. If not specified, the function prompts the user to select groups interactively.

Type: Array
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-MobielePloeg

A switch parameter that, when specified, includes mobile team rights in the mutation process.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
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.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES