< Back

Add-CUComputer

Mon Jan 13, 2020 5:07 am

NAME Add-CUComputer



SYNOPSIS

Adds a computer to ControlUp real-time Console.





SYNTAX

Add-CUComputer [-Domain] <string> [-Name] <string> [[-FolderPath] <string>] [[-DnsName] <string>] [[-SiteId]

<string>] [[-Batch] <BatchUpdate>] [<CommonParameters>]





DESCRIPTION

Adds a computer account from Active Directory to ControlUp real-time Console.



ADComputerName describes the computer account name as appears in Active Directory.



DomainName describes the domain name from which the computer will be added.



FolderPath describes the ControlUp folder path to which the computer will be added.



DnsName is optional for explicitly writing the DNS name of the computer.



SiteId is optional for specifying the ControlUp site Id.



Batch instance is optional in case using a batch mode.





PARAMETERS

-Name <string>



Required? true

Position? 1

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Domain <string>



Required? true

Position? 2

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-FolderPath <string>



Required? false

Position? 3

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-DnsName <string>



Required? false

Position? 4

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-SiteId <string>



Required? false

Position? 5

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Batch <BatchUpdate>



Required? false

Position? 6

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



System.String



System.String



ControlUp.PowerShell.User.Cmdlets.BatchUpdate





OUTPUTS



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



Add-CUComputer -ADComputerName ???????PC001??????? -DomainName ???????NTNET??????? -FolderPath ???????\\SQL Servers???????



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



$b = New-CUBatchUpdate

Add-CUComputer -Name PC002 -Domain NTNET -FolderPath ???????\\SQL Servers??????? -Batch $b

Add-CUComputer -Name PC003 -Domain NTNET -FolderPath ???????\\SQL Servers??????? -Batch $b

Add-CUComputer -Name PC004 -Domain NTNET.local -DnsName PC004.SomeDNSName.com -FolderPath ???????\\SQL Servers??????? -Batch $b

Publish-CUUpdates $b



---------- EXAMPLE 3 ----------



$b = New-CUBatchUpdate

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

Publish-CUUpdates $b





RELATED LINKS

{Remove-CUComputer, New-CUBatchUpdate, Publish-CUUpdates, Search-CUComputersFromAD}