Dela via

Invoke-SCXDiscovery

  • Referens
Modul:
OperationsManager

Anropar identifieringsåtgärden för den angivna konfigurationen av UNIX- och Linux-datorer.

Syntax

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>]

Description

Cmdleten invoke-SCXDiscovery Invoke-SCXDiscovery anropar identifieringsåtgärden för den angivna konfigurationen av UNIX- och Linux-datorer.

Åtgärden använder ett SSH-autentiseringsobjekt för privilegierade SSH-installationsåtgärder och ett valfritt Windows PowerShell-autentiseringsobjekt för lågprivilegierad WS-Management agentkommunikation. Om agenten har installerats manuellt på målvärdarna krävs endast de lågprivilegierade WS-Management autentiseringsuppgifterna.

Utdata från den här cmdleten är en matris med DiscoveryResult objekt som representerar identifieringsresultatet för varje måldator som identifieringen gjordes för.

Exempel

Exempel 1: Identifiera UNIX- och Linux-datorer inom ett intervall med IP-adresser

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 $SSHCredential

Det första kommandot hämtar en autentiseringsuppgift för en användare med hjälp av cmdleten Get-Credential. Kommandot frågar dig om autentisering och lagrar sedan resultatet i variabeln $WSCredential.

Det andra kommandot skapar en privilegierad autentiseringsuppgift för en användare med hjälp av cmdleten Get-SCXSSHCredential. Kommandot lagrar resultatet i variabeln $SSHCredential.

Det tredje kommandot hämtar en resurspool med namnet pool01 med hjälp av cmdleten Get-SCOMResourcePool och lagrar den sedan i variabeln $Pool 01.

Det sista kommandot identifierar UNIX- och Linux-datorer inom ett intervall med IP-adresser.

Exempel 2: Identifiera UNIX- och Linux-datorer efter namn med en port som inte är 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 $SSHCredential

Det första kommandot hämtar en autentiseringsuppgift för en användare med hjälp av Get-Credential. Kommandot frågar dig om autentisering och lagrar sedan resultatet i variabeln $WSCredential.

Det andra kommandot skapar en privilegierad autentiseringsuppgift för en användare med hjälp av Get-SCXSSHCredential. Kommandot lagrar resultatet i variabeln $SSHCredential.

Det tredje kommandot hämtar en resurspool med namnet pool01 med hjälp av Get-SCOMResourcePooloch lagrar den sedan i variabeln $Pool 01.

Det sista kommandot identifierar UNIX- och Linux-datorer med namn med hjälp av en resurspool och anger en SSH-port som inte är standard.

Exempel 3: Identifiera UNIX- och Linux-datorer med namn

PS C:\>$Pool = Get-SCOMResourcePool "RP1"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -ResourcePool $Pool -WSManCredential "DavidChew"

Det första kommandot hämtar en resurspool med namnet RP1 med hjälp av Get-SCOMResourcePooloch lagrar den sedan i variabeln $Pool.

Det andra kommandot identifierar UNIX- och Linux-datorer med namn där hanteringsagenten redan har installerats.

Parametrar

-ComputerName

Anger en matris med namn på datorer. Cmdleten upprättar tillfälliga anslutningar med hanteringsgrupper för dessa datorer. Du kan använda NetBIOS-namn, IP-adresser eller fullständigt kvalificerade domännamn (FQDN). Om du vill ange den lokala datorn skriver du datornamnet, localhost eller en punkt (.).

System Center Data Access-tjänsten måste vara aktiv på datorn. Om du inte anger någon dator använder cmdleten datorn för den aktuella hanteringsgruppens anslutning.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger det användarkonto under vilket anslutningen till hanteringsgruppen körs. Ange ett PSCredential- objekt, till exempel ett objekt som cmdleten Get-Credential returnerar för den här parametern. Om du vill ha mer information om autentiseringsobjekt skriver du Get-Help Get-Credential.

Om du anger en dator i parametern ComputerName använder du ett konto som har åtkomst till datorn. Standardvärdet är den aktuella användaren.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IPRange

Anger ett intervall med IP-adresser som ska användas för identifiering. IPRange- måste innehålla två IP-adresser (till exempel 192.168.0.1,192.168.0.254). Antingen måste parametrarna IPRange eller Name anges.

Typ:IPAddress[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger en lista med giltiga värdnamn, FQDN eller IP-adresser (avgränsade med ett kommatecken) som ska användas för identifiering. Antingen måste parametrarna IPRange eller Name anges. Den här parametern accepteras från pipelinen.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourcePool

Anger en resurspool med servrar, varav en är tilldelad till den aktuella hanteringsservern och de andra som fungerar som servrar för säkerhetskopieringshantering. Den här parametern kräver ett resurspoolobjekt och returnerar endast de hanterade datorerna i resurspoolen.

Om du vill ha information om hur du hämtar ett resurspoolobjekt skriver du Get-Help Get-SCOMResourcePool.

Typ:ManagementServicePool
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SCSession

Anger en matris med Anslutning objekt. Om du vill hämta anslutningsobjekt använder du cmdleten Get-SCOMManagementGroupConnection.

Om den här parametern inte anges använder cmdleten den aktiva beständiga anslutningen till en hanteringsgrupp. Använd parametern SCSession för att ange en annan beständig anslutning. Du kan skapa en tillfällig anslutning till en hanteringsgrupp med hjälp av parametrarna ComputerName och Credential. Om du vill ha mer information skriver du Get-Help about_OpsMgr_Connections.

Typ:Connection[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SshCredential

Anger en privilegierad SSH-autentiseringsuppgift som används för att utföra agentinstallationsåtgärderna. Om den här parametern inte anges misslyckas identifieringen om inte en agent har installerats manuellt på måldatorn.

Om du vill ha information om hur du hämtar ett SSH-autentiseringsobjekt skriver du Get-Help Get-SCXSSHCredential.

Typ:CredentialSet
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SshPort

Anger den port som ska användas för SSH-kommunikation med värden. Om det inte anges används standardvärdet 22.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WsManCredential

Anger en autentiseringsuppgift som används för kommunikation med lågprivilegierade agenter via WS-Management.

Ange ett användarnamn, till exempel User01 eller ange ett PSCredential- objekt, till exempel ett objekt som returneras av cmdleten Get-Credential. När du skriver ett användarnamn uppmanas du att ange ett lösenord. Om du vill ha mer information skriver du Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

DiscoveryResult

Den här cmdleten returnerar en matris med DiscoveryResult- objekt som representerar identifieringsresultatet för varje måldator som identifieringen planerades för.