Active Directory Management Framework

Configuration driven Active Directory management.

Invoke-AdmfItem

SYNOPSIS

Apply individual changes found by Test-AdmfDc, Test-AdmfDomain or Test-AdmfForest.

SYNTAX

Invoke-AdmfItem [[-TestResult] <Object>] [[-Credential] <PSCredential>] [[-CredentialProvider] <String>]
 [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Apply individual changes found by Test-AdmfDc, Test-AdmfDomain or Test-AdmfForest. This allows applying individual changes, irrespective of domain or type.

While this command accepts from the pipeline, it groups results by server and executes during the end phase. This is done to rationalize the application of credential providers, context switching and connection management.

EXAMPLES

EXAMPLE 1

Test-AdmfDomain -Server contoso.com | Where-Object ObjectType -in User, Group | Where-Object ObjectType -eq Create | Invoke-AdmfItem

Apply all create actions for all users and groups in contoso.com.

PARAMETERS

-TestResult

The test results to apply. Output objects of Test-AdmfDc, Test-AdmfDomain or Test-AdmfForest.

Type: Object
Parameter Sets: (All)
Aliases:

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

-Credential

The credentials to use for this operation.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-CredentialProvider

The credential provider to use to resolve the input credentials. See help on Register-AdmfCredentialProvider for details.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: Default
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

If this switch is enabled, no actions are performed but informational messages will be displayed that explain what would happen if the command were to run.

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

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

-Confirm

If this switch is enabled, you will be prompted for confirmation before executing any operations that change state.

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

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

-ProgressAction

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

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