Test-DtActiveDirectoryCredentials

This cmdlet tests if the specified credentials have privileges to update Active Directory on the specified server's domain. For this cmdlet, the -ServiceHost could be your source or target server.

Syntax

Test-DtActiveDirectoryCredentials [-Credential] <PSCredential> [-ComputerDomain] <String> [-ComputerName] <String> [-ServiceHost] <Server> [<CommonParameters>]

Test-DtActiveDirectoryCredentials [-UserName] <String> [-Password] <String> [-ComputerDomain] <String> [-ComputerName] <String> [-ServiceHost] <Server> [<CommonParameters>]

Parameters

-ComputerDomain<String>

Specify a domain name.

Required?	true
Position?	named
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ComputerName<String>

Specify a computer name.

Required?	true
Position?	named
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Credential<PSCredential>

Specify the credential object returned from the Windows PowerShell Get-Credential cmdlet. This password will not be visible because Windows stores an encrypted password.

Required?	true
Position?	2
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-UserName<String>

Specify a user name. If you are using a domain, specify domain\user name.

Required?	true
Position?	2
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Password<String>

Specify the password associated with the user you have entered. This password will be visible in plain text.

Required?	true
Position?	3
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ServiceHost<Server>

Specify the server object returned from the New-DtServer cmdlet.

Required?	true
Position?	1
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

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

Examples

------------------EXAMPLE------------------

A server object is created for the server alpha using the domain\administrator and password credentials. It assigns the server object to the variable called DtServerObjectAlpha. Then you will be prompted for credentials for the domain\administrator account and those credentials will be stored in the variable DtCredentials. Finally, the stored credentials will be tested to see if they can update Active Directory on the server's domain. The connections for the server object are then closed.

$DtServerObjectAlpha= New-DtServer -Name alpha -UserName domain\administrator -Password password

$DtCredentials = Get-Credential domain\administrator

Test-DtActiveDirectoryCredentials -ServiceHost $DtServerObjectAlpha -Credential $DtCredentials

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha