< Back
Search-CUComputersFromAD
Post
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 :
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 :