New-WindowsDiscoveryConfiguration
New-WindowsDiscoveryConfiguration
Creates an object that describes computers to discover.
Syntax
Parameter Set: FromComputerNames
New-WindowsDiscoveryConfiguration [-ComputerName] <String[]> [[-PerformVerification]] [[-ComputerType] <DiscoveryComputerType> ] [[-ActionAccountCredential] <PSCredential> ] [ <CommonParameters>]
Parameter Set: FromLdapQueryDiscoveryCriteria
New-WindowsDiscoveryConfiguration [-LdapQueryDiscoveryCriteria] <LdapQueryDiscoveryCriteria> [[-PerformVerification]] [[-ComputerType] <DiscoveryComputerType> ] [[-ActionAccountCredential] <PSCredential> ] [ <CommonParameters>]
Detailed Description
Creates an object that describes computers to discover. Creates a new WindowsDiscoveryConfiguration object used to discover computers.
Parameters
-ActionAccountCredential<PSCredential>
Specifies the account credentials to use in the discovery.
Aliases |
none |
Required? |
false |
Position? |
5 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-ComputerName<String[]>
Specifies a computer or set of computers to discover information about. The names of the computers are entered as strings. To enter more than one name, separate them by using commas.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-ComputerType<DiscoveryComputerType>
Specifies the type of the computer to discover.The following lists the acceptable values for this parameter:
Aliases |
none |
Required? |
false |
Position? |
4 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-LdapQueryDiscoveryCriteria<LdapQueryDiscoveryCriteria>
Specifies an LDAPQueryDiscoveryCriteria object to use for the windows discovery. Use new-LdapQueryDiscoveryCriteria to create one of these objects.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-PerformVerification
Determines whether to perform verification.
Aliases |
none |
Required? |
false |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters
Notes
- For more information, type "Get-Help New-WindowsDiscoveryConfiguration -detailed". For technical information, type "Get-Help New-WindowsDiscoveryConfiguration -full".
When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".
Examples
-------------- EXAMPLE 1 --------------
This command creates a type of object (WindowsDiscoveryConfiguration) that describes the computer named "fabrikam" so that information about that computer can be discovered by using the start-Discovery cmdlet. The command stores the configuration information in the $win_dis_cfg variable for later use. Type $win_dis_cfg to see the contents of this object.
C:\PS>$win_dis_cfg = new-windowsdiscoveryconfiguration -computername "fabrikam"