< Back

Search-CUComputersFromAD

Mon Jan 13, 2020 5:12 am

NAME Search-CUComputersFromAD



SYNOPSIS

Query AD for computer accounts that can be added to ControlUp





SYNTAX

Search-CUComputersFromAD [-Name] <string> [-Domain] <string> [[-OU] <string>] [<CommonParameters>]





DESCRIPTION

Query AD the for computers returning with the attributes ControlUp requires (Netbios and dnsHostName). The result

set can be piped to Add-CUComputer (use batch when adding large amount of computers)



Name is the search string on computers name. Wildcards are supported.



Domain is the AD domain FQDN or netbios name. This domain must be configured on ControlUp.



OU is optional and offers the ability to limit the search.





PARAMETERS

-Name <string>



Required? true

Position? 1

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Domain <string>



Required? true

Position? 1

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-OU [<string>]



Required? false

Position? 2

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.String



System.String



System.String





OUTPUTS



---------- EXAMPLE 1 ----------



Search-CUComputersFromAD -Domain NTNET -Name *SQLSRV* -OU "CN=Computers,DC=ntnet,DC=local"



---------- EXAMPLE 2 ----------



$b = New-CUBatchUpdate

Search-CUComputersFromAD -Domain NTNET -Name *SQLSRV* | Add-CUComputer -FolderPath ???????\\SQL Servers??????? -Batch $b

Publish-CUUpdates $b





RELATED LINKS







CommonParameters : True

WorkflowCommonParameters : False

details : @{name=Show-CUBatchResult; noun=CUBatchResult; verb=Show}

Syntax : @{syntaxItem=System.Object[]}

parameters : @{parameter=System.Object[]}

inputTypes : @{inputType=}

returnValues : @{returnValue=}

aliases : None



remarks : None

PSSnapIn :

alertSet :

description :

examples :

Synopsis :

Show-CUBatchResult [-Batch] <BatchUpdate> [-ShowSuccess] [<CommonParameters>]



ModuleName : ControlUp.CLI

nonTerminatingErrors :

xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10

xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10

xmlns:maml : http://schemas.microsoft.com/maml/2004/10

Name : Show-CUBatchResult

Category : Cmdlet

Component :

Role :

Functionality :