Get-SCSMClassInstance

Módulo:

System.Center.Service.Manager

Obtiene instancias de clase.

Sintaxis

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

Description

El cmdlet Get-SCSMClassInstance recupera instancias de clase.

Ejemplos

Ejemplo 1: Obtener equipos por nombre 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

Estos comandos recuperan equipos con los criterios de NetbiosDomainName es igual a WOODGROVE. Los primeros comandos definen los parámetros que se usan después en el último cmdlet Get-SCSMClassInstance.

Ejemplo 2: Obtener instancias de clase mediante 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

Este comando recupera objetos de instancia de clase de la base de datos de Service Manager mediante un filtro. Tenga en cuenta que el nombre de propiedad del filtro debe ser el nombre exacto de la propiedad y que distingue mayúsculas de minúsculas.

Ejemplo 3: Obtener todos los objetos de equipo

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

Estos comandos recuperan todos los objetos de instancia de clase de tipo Equipo de la base de datos de Service Manager.

Parámetros

-Class

Especifica el nombre de una o varias clases que se van a recuperar. Puede especificar un objeto ManagementPackClass devuelto por el cmdlet Get-SCClass.

Tipo:	Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ComputerName

Especifica un equipo con el que establecer una conexión. El equipo debe ejecutar el servicio de acceso a datos de System Center. El valor predeterminado es el equipo para la conexión del grupo de administración actual.

Los formatos válidos incluyen un nombre NetBIOS, una dirección IP o un nombre de dominio completo (FQDN). Para especificar el equipo local, escriba el nombre del equipo, "localhost" o un punto (.).

Tipo:	System.String[]
Posición:	Named
Valor predeterminado:	Localhost
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Credential

Especifica una cuenta de usuario con la que se ejecutará la conexión del grupo de administración. La cuenta debe tener acceso al servidor especificado en el parámetro ComputerName, si se especifica el servidor. El valor predeterminado es el usuario actual.

Puede escribir un objeto de PSCredential devuelto por el cmdlet Get-Credential.

Tipo:	System.Management.Automation.PSCredential
Posición:	Named
Valor predeterminado:	Current user context
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Criteria

Especifica un objeto criteria que restringe el conjunto de instancias de clase que se devuelven desde el servidor de administración.

Tipo:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-DisplayName

Especifica el nombre para mostrar de la instancia de clase que se va a recuperar.

Tipo:	System.String[]
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Filter

Filtra el conjunto de resultados. La sintaxis del filtro es la propiedad <> operador <valor>, donde los operadores válidos son -eq, -ne, -gt, -ge, -lt, -le, -like y -notlike. El uso de un filtro es eficaz porque el filtro limita los resultados que se recuperan del servidor de administración, en lugar de aplicarse después de que los resultados se devuelvan a PowerShell.

Tipo:	System.String
Posición:	2
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Group

Especifica una instancia de un grupo que contiene las instancias de clase que se van a recuperar.

Tipo:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Id

Especifica el identificador de las instancias de clase que se van a recuperar. Puede ser un GUID o una cadena que se convertirá en un GUID.

Tipo:	System.Guid[]
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifica el nombre de las instancias de clase que se van a recuperar.

Tipo:	System.String[]
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-SCSession

Especifica una conexión a un servidor de administración. El valor predeterminado es la conexión del grupo de administración actual.

Puede escribir un objeto de conexión de grupo de administración devuelto por el cmdlet Get-SCManagementGroupConnection.

Tipo:	Microsoft.SystemCenter.Core.Connection.Connection[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Puede canalizar una clase al parámetro Class del cmdlet Get-SCSMClassInstance.

Salidas

EnterpriseManagementObject

Este cmdlet genera un objeto EnterpriseManagementObject#.

Vínculos relacionados

• New-SCSMClassInstance
• Remove-SCSMClassInstance
• Update-SCSMClassInstance