Get-SCClassInstance
Obtiene instancias de clase.
Sintaxis
Empty (Es el valor predeterminado).
Get-SCClassInstance
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementPackClass
Get-SCClassInstance
[-Class] <ManagementPackClass[]>
[[-Filter] <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMODisplayNameParameterSetName
Get-SCClassInstance
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMONameParameterSetName
Get-SCClassInstance
[-Name] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromGroup
Get-SCClassInstance
[-Group] <EnterpriseManagementObject[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMOIdParameterSetName
Get-SCClassInstance
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromCriteria
Get-SCClassInstance
[-Criteria] <EnterpriseManagementObjectCriteria>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
El cmdlet Get-SCClassInstance recupera instancias de clase.
Ejemplos
Ejemplo 1: Obtener equipos por el nombre de 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-SCClassInstance -criteria $criteria
Estos comandos recuperan equipos utilizando los criterios de NetbiosDomainName es igual a WOODGROVE. Los primeros comandos definen los parámetros que se usan en el cmdlet Get-SCClassInstance final.
Ejemplo 2: Obtención de instancias de clase mediante un filtro
PS C:\>Get-SCClassInstance -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 la propiedad en el filtro debe ser el nombre exacto de la propiedad y que distingue entre mayúsculas y minúsculas.
Ejemplo 3: Obtener todos los objetos del equipo
PS C:\>$class = Get-SCClass -name microsoft.windows.computer
PS C:\>Get-SCClassInstance -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
Este comando recupera todos los objetos de instancia de clase de tipo Computer de la base de datos del Administrador de servicios.
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 .
Propiedades del parámetro
| Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FromManagementPackClass
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 actual del grupo de administración.
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 (.).
Propiedades del parámetro
| Tipo: | System.String[] |
| Valor predeterminado: | Localhost |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Credential
Especifica una cuenta de usuario en 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 PSCredential devuelto por el cmdlet Get-Credential .
Propiedades del parámetro
| Tipo: | System.Management.Automation.PSCredential |
| Valor predeterminado: | Current user context |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Criteria
Especifica un objeto de criterios que restringe el conjunto de instancias de clase que se devuelven desde el servidor de administración.
Propiedades del parámetro
| Tipo: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FromCriteria
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DisplayName
Especifica el nombre para mostrar de la instancia de clase que se va a recuperar.
Propiedades del parámetro
| Tipo: | System.String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FromEMODisplayNameParameterSetName
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Filter
Filtra el conjunto de resultados. La sintaxis del filtro es el valor< del operador >de propiedad<, 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.
Propiedades del parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FromManagementPackClass
| Posición: | 2 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Group
Especifica una instancia de un grupo que contiene las instancias de clase que se van a recuperar.
Propiedades del parámetro
| Tipo: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FromGroup
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Id
Especifica el ID de las instancias de clase que se van a recuperar. Puede ser un GUID o una cadena que se convertirá en un GUID.
Propiedades del parámetro
| Tipo: | System.Guid[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FromEMOIdParameterSetName
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Especifica el nombre de las instancias de clase que se van a recuperar.
Propiedades del parámetro
| Tipo: | System.String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FromEMONameParameterSetName
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SCSession
Especifica una conexión a un servidor de administración. El valor predeterminado es la conexión actual del grupo de administración.
Puede escribir un objeto de conexión de grupo de administración devuelto por el cmdlet Get-SCManagementGroupConnection .
Propiedades del parámetro
| Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Puede canalizar una clase al parámetro Class del cmdlet Get-SCClassInstance .
Salidas
EnterpriseManagementObject
Este cmdlet genera un objeto EnterpriseManagementObject#<classtype> .