Remove-PAMTrust

Module:

MIMPAM Module

Removes a trust of the PAM forest from an existing forest that was established by New-PAMTrust.

Syntax

Default (Default)

Remove-PAMTrust
    [-SourceForest] <String>
    [-Credentials] <PSCredential>
    [<CommonParameters>]

Description

This cmdlet removes the trust relationship that a forest has to the privileged access management forest. It is assumed that the trust was originally created by the New-PAMTrust cmdlet. This cmdlet does not remove domain configuration data from the source domains other than the trust relationship.

Examples

EXAMPLE 1

$sfc = Get-Credential ; Remove-PAMTrust -SourceForest "contoso.local" -Credentials $sfc

This cmdlet removes the trust relationship which had been established with the source domain in another forest. Note that it requires authentication credentials for an administrator user in that forest.

Parameters

-Credentials

Credentials to authenticate as an administrator to the existing forest.

Parameter properties

Type:	PSCredential
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	2
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-SourceForest

Domain name of the existing forest.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	1
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

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