Invoke-SCXDiscovery
Richiama l'operazione di individuazione per la configurazione specificata di computer UNIX e Linux.
Sintassi
Invoke-SCXDiscovery
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
-Name <String[]>
-ResourcePool <ManagementServicePool>
[-SshPort <Int32>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Invoke-SCXDiscovery
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
-ResourcePool <ManagementServicePool>
-IPRange <IPAddress[]>
[-SshPort <Int32>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Descrizione
Il cmdlet Invoke-SCXDiscovery richiama l'operazione di individuazione per la configurazione specificata dei computer UNIX e Linux.
L'operazione usa un oggetto credenziali SSH per le azioni di installazione SSH con privilegi e un oggetto credenziale Windows PowerShell facoltativo per la comunicazione dell'agente con privilegi limitati WS-Management. Se l'agente è stato installato manualmente negli host di destinazione, sono necessarie solo le credenziali con privilegi limitati WS-Management.
L'output di questo cmdlet è una matrice di oggetti DiscoveryResult che rappresentano il risultato dell'individuazione per ogni computer di destinazione per cui è stato tentato l'individuazione.
Esempio
Esempio 1: Individuare computer UNIX e Linux all'interno di un intervallo di indirizzi IP
PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key22.ppk" -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool "pool01"
PS C:\> Invoke-SCXDiscovery -IPRange 192.168.1.50,192.168.1.75 -ResourcePool $Pool01 -WSManCredential $WSCredential -SSHCredential $SSHCredentialIl primo comando ottiene una credenziale per un utente usando il cmdlet Get-Credential. Il comando richiede l'autenticazione e quindi archivia i risultati nella variabile $WSCredential.
Il secondo comando crea una credenziale privilegiata per un utente usando il cmdlet Get-SCXSSHCredential. Il comando archivia il risultato nella variabile $SSHCredential.
Il terzo comando ottiene un pool di risorse denominato pool01 usando il cmdlet Get-SCOMResourcePool e lo archivia nella variabile $Pool 01.
Il comando finale individua i computer UNIX e Linux all'interno di un intervallo di indirizzi IP.
Esempio 2: Individuare computer UNIX e Linux per nome con una porta non standard
PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key c:\keys\DavidChew.ppk -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -SSHPort 8022 -ResourcePool $Pool01 -WSManCredential $WSCredential -SSHCredential $SSHCredentialIl primo comando ottiene una credenziale per un utente usando Get-Credential. Il comando richiede l'autenticazione e quindi archivia i risultati nella variabile $WSCredential.
Il secondo comando crea credenziali con privilegi per un utente usando Get-SCXSSHCredential. Il comando archivia il risultato nella variabile $SSHCredential.
Il terzo comando ottiene un pool di risorse denominato pool01 usando Get-SCOMResourcePool e lo archivia nella variabile $Pool 01.
Il comando finale individua i computer UNIX e Linux in base al nome usando un pool di risorse e specificando una porta SSH non standard.
Esempio 3: Individuare computer UNIX e Linux in base al nome
PS C:\>$Pool = Get-SCOMResourcePool "RP1"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -ResourcePool $Pool -WSManCredential "DavidChew"Il primo comando ottiene un pool di risorse denominato RP1 usando Get-SCOMResourcePool e quindi lo archivia nella variabile $Pool.
Il secondo comando individua i computer UNIX e Linux in base al nome in cui è già stato installato l'agente di gestione.
Parametri
-ComputerName
Specifica una matrice di nomi di computer. Il cmdlet stabilisce connessioni temporanee con i gruppi di gestione per questi computer. È possibile usare nomi NetBIOS, indirizzi IP o nomi di dominio completi (FQDN). Per specificare il computer locale, digitare il nome del computer, localhost o un punto (.).
Il servizio Di accesso ai dati di System Center deve essere attivo nel computer. Se non si specifica un computer, il cmdlet utilizza il computer per la connessione al gruppo di gestione corrente.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Specifica l'account utente in cui viene eseguita la connessione al gruppo di gestione.
Specificare un oggetto PSCredential , ad esempio quello restituito dal cmdlet Get-Credential , per questo parametro.
Per altre informazioni sugli oggetti credenziali, digitare Get-Help Get-Credential.
Se si specifica un computer nel parametro ComputerName , utilizzare un account che abbia accesso a tale computer. Il valore predefinito è l'utente corrente.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPRange
Specifica un intervallo di indirizzi IP che verranno usati per l'individuazione. IpRange deve contenere due indirizzi IP, ad esempio 192.168.0.1,192.168.0.254. È necessario specificare i parametri IPRange o Name .
| Type: | IPAddress[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifica un elenco di nomi host, nomi di dominio completi o indirizzi IP validi (separati da una virgola) che verranno usati per l'individuazione. È necessario specificare i parametri IPRange o Name . Questo parametro viene accettato dalla pipeline.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourcePool
Specifica un pool di risorse di server, uno dei quali viene assegnato come server di gestione corrente e gli altri che fungono da server di gestione di backup. Questo parametro richiede un oggetto pool di risorse e restituisce solo i computer gestiti nel pool di risorse.
Per informazioni su come ottenere un oggetto pool di risorse, digitare Get-Help Get-SCOMResourcePool.
| Type: | ManagementServicePool |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SCSession
Specifica una matrice di oggetti Connection . Per ottenere oggetti Connection , usare il cmdlet Get-SCOMManagementGroupConnection .
Se questo parametro non viene specificato, il cmdlet usa la connessione permanente attiva a un gruppo di gestione.
Usare il parametro SCSession per specificare una connessione permanente diversa.
È possibile creare una connessione temporanea a un gruppo di gestione usando i parametri ComputerName e Credential .
Per ulteriori informazioni, digitare Get-Help about_OpsMgr_Connections.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SshCredential
Specifica una credenziale SSH con privilegi utilizzata per eseguire le azioni di installazione dell'agente. Se questo parametro non viene specificato, l'individuazione ha esito negativo a meno che un agente non sia stato installato manualmente nel computer di destinazione.
Per informazioni su come ottenere un oggetto credenziali SSH, digitare Get-Help Get-SCXSSHCredential.
| Type: | CredentialSet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SshPort
Specifica la porta da usare per la comunicazione SSH con l'host. Se non specificato, viene utilizzato il valore predefinito 22.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WsManCredential
Specifica una credenziale usata per la comunicazione dell'agente con privilegi limitati tramite WS-Management.
Digitare un nome utente, ad esempio User01 o immettere un oggetto PSCredential , ad esempio quello restituito dal cmdlet Get-Credential.
Quando si digita un nome utente, viene richiesta una password.
Per ulteriori informazioni, digitare Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Output
DiscoveryResult
Questo cmdlet restituisce una matrice di oggetti DiscoveryResult che rappresentano il risultato dell'individuazione per ogni computer di destinazione per cui è stata pianificata l'individuazione.