Get-SCClassInstance
Obtém instâncias de classe.
Sintaxe
Empty (Predefinição)
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
O cmdlet Get-SCClassInstance recupera instâncias de classe.
Exemplos
Exemplo 1: Obter computadores pelo 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-SCClassInstance -criteria $criteria
Esses comandos recuperam computadores usando os critérios de NetbiosDomainName igual a WOODGROVE. Os primeiros comandos definem os parâmetros que são usados no cmdlet Get-SCClassInstance final.
Exemplo 2: Obter instâncias de classe usando um 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 instância de classe do banco de dados do Service Manager usando um filtro. Observe que o nome da propriedade no filtro deve ser o nome exato da propriedade e que diferencia maiúsculas de minúsculas.
Exemplo 3: Obter todos os objetos de computador
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
Esses comandos recuperam todos os objetos de instância de classe do tipo Computer do banco de dados do Service Manager.
Parâmetros
-Class
Especifica o nome de uma ou mais classes a serem recuperadas. Você pode especificar um objeto ManagementPackClass que é retornado pelo cmdlet Get-SCClass .
Propriedades dos parâmetros
| Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromManagementPackClass
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ComputerName
Especifica um computador com o qual estabelecer uma conexão. O computador deve estar executando o serviço de Acesso a Dados do System Center. O valor padrão é o computador para a conexão atual do grupo de gerenciamento.
Os formatos válidos incluem um nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado (FQDN). Para especificar o computador local, digite o nome do computador, "localhost" ou um ponto (.).
Propriedades dos parâmetros
| Tipo: | System.String[] |
| Default value: | Localhost |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Especifica uma conta de usuário sob a qual a conexão do grupo de gerenciamento será executada. A conta deve ter acesso ao servidor especificado no parâmetro ComputerName , se o servidor for especificado. O valor padrão é o usuário atual.
Você pode inserir um objeto PSCredential retornado pelo cmdlet Get-Credential .
Propriedades dos parâmetros
| Tipo: | System.Management.Automation.PSCredential |
| Default value: | Current user context |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Criteria
Especifica um objeto criteria que restringe o conjunto de instâncias de classe retornadas do servidor de gerenciamento.
Propriedades dos parâmetros
| Tipo: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromCriteria
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-DisplayName
Especifica o nome para exibição da instância de classe a ser recuperada.
Propriedades dos parâmetros
| Tipo: | System.String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromEMODisplayNameParameterSetName
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Filter
Filtra o conjunto de resultados. A sintaxe do filtro é o valor< do operador >de propriedade<, onde os >operadores válidos são -eq, -ne, -gt, -ge, -lt, -le, -like e -notlike. O uso de um filtro é eficiente porque o filtro limita os resultados recuperados do servidor de gerenciamento, em vez de ser aplicado depois que os resultados são retornados ao PowerShell.
Propriedades dos parâmetros
| Tipo: | System.String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromManagementPackClass
| Position: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Group
Especifica uma instância de um grupo que contém as instâncias de classe a serem recuperadas.
Propriedades dos parâmetros
| Tipo: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromGroup
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Id
Especifica a ID das instâncias de classe a serem recuperadas. Isso pode ser um GUID ou uma cadeia de caracteres que será convertida em um GUID.
Propriedades dos parâmetros
| Tipo: | System.Guid[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromEMOIdParameterSetName
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica o nome das instâncias de classe a serem recuperadas.
Propriedades dos parâmetros
| Tipo: | System.String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromEMONameParameterSetName
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SCSession
Especifica uma conexão com um servidor de gerenciamento. O valor padrão é a conexão atual do grupo de gerenciamento.
Você pode inserir um objeto de conexão de grupo de gerenciamento retornado pelo cmdlet Get-SCManagementGroupConnection .
Propriedades dos parâmetros
| Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Você pode canalizar uma classe para o parâmetro Class do cmdlet Get-SCClassInstance .
Saídas
EnterpriseManagementObject
Este cmdlet gera um objeto EnterpriseManagementObject#<classtype> .