Condividi tramite

Get-SCSMClassInstance

  • Riferimento
Modulo:
System.Center.Service.Manager

Ottiene le istanze della classe.

Sintassi

Get-SCSMClassInstance
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Class] <ManagementPackClass[]>
   [[-Filter] <String>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Name] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Group] <EnterpriseManagementObject[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Id] <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Criteria] <EnterpriseManagementObjectCriteria>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-SCSMClassInstance recupera le istanze della classe.

Esempio

Esempio 1: Ottenere computer in base al nome NetBIOS

PS C:\>$MP = Get-SCManagementPack -name "Microsoft.Windows.Library"
PS C:\>$CriteriaFormat = '<Criteria 
>> xmlns="http://Microsoft.EnterpriseManagement.Core.Criteria/"><Reference 
>> Id="Microsoft.Windows.Library" Version="{0}" PublicKeyToken="{1}" 
>> Alias="myMP" 
>>/><Expression><SimpleExpression><ValueExpressionLeft><Property>$Target/Property[Type="myMP!Microsoft.Windows.Computer"]/NetbiosDomainName$</Property></ValueExpressionLeft><Operator>Equal</Operator><ValueExpressionRight><Value>IR2</Value></ValueExpressionRight></SimpleExpression></Expression></Criteria>'
PS C:\>$CriteriaType = "Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria"
PS C:\>$criteriaString = $criteriaFormat -f $MP.Version, $MP.KeyToken
PS C:\>$class = Get-SCClass -name "microsoft.windows.computer"
PS C:\>$criteria = new-object $CriteriaType $CriteriaString,$class,$class.ManagementGroup
PS C:\>Get-SCSMClassInstance -criteria $criteria

Questi comandi recuperano i computer usando i criteri di NetbiosDomainName uguale a WOODGROVE. I primi comandi definiscono i parametri che vengono quindi usati nell'ultimo cmdlet Get-SCSMClassInstance.

Esempio 2: Ottenere istanze di classe usando un filtro

PS C:\>Get-SCSMClassInstance -class $class -filter 'NetbiosDomainName -eq "WOODGROVE"'
PrincipalName                 ObjectStatus ActiveDirectorySite     NetBiosDomainName
-------------                 ------------ -------------------     -----------------
WIN-752HJBSX24M.woodgrove.com Active       Default-First-Site-Name WOODGROVE
JWT-SCDW.woodgrove.com        Active                               WOODGROVE

Questo comando recupera gli oggetti dell'istanza della classe dal database di Service Manager usando un filtro. Si noti che il nome della proprietà nel filtro deve essere il nome esatto della proprietà e che fa distinzione tra maiuscole e minuscole.

Esempio 3: Ottenere tutti gli oggetti computer

PS C:\>$class = Get-SCSMClass -name microsoft.windows.computer
PS C:\>Get-SCSMClassInstance -class $class|format-table PrincipalName,ObjectStatus,ActiveDirectorySite,NetbiosDomainName
PrincipalName                 ObjectStatus ActiveDirectorySite     NetbiosDomainName
-------------                 ------------ -------------------     -----------------
WIN-752HJBSX24M.woodgrove.com Active       Default-First-Site-Name WOODGROVE
JWT-SCDW.woodgrove.com        Active                               WOODGROVE

Questi comandi recuperano tutti gli oggetti istanza della classe di tipo Computer dal database di Service Manager.

Parametri

-Class

Specifica il nome di una o più classi da recuperare. È possibile specificare un oggetto ManagementPackClass restituito dal cmdlet Get-SCClass .

Tipo:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ComputerName

Specifica un computer con cui stabilire una connessione. Il computer deve eseguire il servizio di accesso ai dati di System Center. Il valore predefinito è il computer per la connessione al gruppo di gestione corrente.

I formati validi includono un nome NetBIOS, un indirizzo IP o un nome di dominio completo (FQDN). Per specificare il computer locale, digitare il nome del computer, "localhost" o un punto (.).

Tipo:System.String[]
Posizione:Named
Valore predefinito:Localhost
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica un account utente in cui verrà eseguita la connessione al gruppo di gestione. L'account deve avere accesso al server specificato nel parametro NomeComputer, se il server è specificato. Il valore predefinito è l'utente corrente.

È possibile immettere un oggetto PSCredential restituito dal cmdlet Get-Credential .

Tipo:System.Management.Automation.PSCredential
Posizione:Named
Valore predefinito:Current user context
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Criteria

Specifica un oggetto criteri che limita il set di istanze di classe restituite dal server di gestione.

Tipo:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DisplayName

Specifica il nome visualizzato dell'istanza della classe da recuperare.

Tipo:System.String[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Filter

Filtra il set di risultati. La sintassi del filtro è la proprietà <proprietà> operatore <valore>, dove gli operatori validi sono -eq, -ne, -gt, -ge, -lt, -le, -like e -notlike. L'uso di un filtro è efficiente perché il filtro limita i risultati recuperati dal server di gestione, anziché essere applicati dopo che i risultati vengono restituiti a PowerShell.

Tipo:System.String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Group

Specifica un'istanza di un gruppo che contiene le istanze della classe da recuperare.

Tipo:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Id

Specifica l'ID delle istanze della classe da recuperare. Può trattarsi di un GUID o di una stringa che verrà convertita in un GUID.

Tipo:System.Guid[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome delle istanze della classe da recuperare.

Tipo:System.String[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SCSession

Specifica una connessione a un server di gestione. Il valore predefinito è la connessione corrente al gruppo di gestione.

È possibile immettere un oggetto connessione del gruppo di gestione restituito dal cmdlet Get-SCManagementGroupConnection .

Tipo:Microsoft.SystemCenter.Core.Connection.Connection[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

È possibile inviare tramite pipe una classe al parametro Classe del cmdlet get-SCSMClassInstance .

Output

EnterpriseManagementObject

Questo cmdlet genera un oggetto classtype<EnterpriseManagementObject#>.