Get-SCClassInstance
Получает экземпляры класса.
Синтаксис
Empty (по умолчанию)
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>]
Описание
Командлет Get-SCClassInstance извлекает экземпляры классов.
Примеры
Пример 1: Получение компьютеров по имени 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
Эти команды извлекают компьютеры с использованием критериев NetbiosDomainName равно WOODGROVE. Первые команды определяют параметры, которые затем используются в окончательном командлете Get-SCClassInstance .
Пример 2: Получение экземпляров класса с помощью фильтра
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
Эта команда извлекает объекты экземпляров классов из базы данных Service Manager с помощью фильтра. Обратите внимание, что имя свойства в фильтре должно быть точным именем свойства и что оно чувствительно к регистру.
Пример 3: Получение всех объектов компьютера
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
Эти команды извлекают все объекты экземпляров класса типа Computer из базы данных Service Manager.
Параметры
-Class
Указывает имя одного или нескольких классов для извлечения. Можно указать объект ManagementPackClass , возвращаемый командлетом Get-SCClass .
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromManagementPackClass
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ComputerName
Указывает компьютер для установки соединения. На компьютере должна быть запущена служба доступа к данным System Center. Значением по умолчанию является компьютер для текущего подключения к группе управления.
Допустимые форматы включают имя NetBIOS, IP-адрес или полное доменное имя (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).
Свойства параметра
| Тип: | System.String[] |
| Default value: | Localhost |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетную запись пользователя, от имени которой будет выполняться подключение к группе управления. Учетная запись должна иметь доступ к серверу, указанному в параметре ComputerName , если сервер указан. Значение по умолчанию — текущий пользователь.
Вы можете ввести объект PSCredential , который возвращается командлетом Get-Credential .
Свойства параметра
| Тип: | System.Management.Automation.PSCredential |
| Default value: | Current user context |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Criteria
Указывает объект условия, ограничивающий набор экземпляров классов, возвращаемых с сервера управления.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromCriteria
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisplayName
Указывает отображаемое имя экземпляра класса для извлечения.
Свойства параметра
| Тип: | System.String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromEMODisplayNameParameterSetName
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Filter
Фильтрует набор результатов. Синтаксисом фильтра является <значение> оператора <свойства>, где допустимыми операторами являются -eq, -ne, -gt, -ge, -lt, -le, -like и -notlike. Использование фильтра является эффективным, так как он ограничивает результаты, получаемые с сервера управления, а не применяется после их возврата в PowerShell.
Свойства параметра
| Тип: | System.String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromManagementPackClass
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Group
Указывает экземпляр группы, содержащей экземпляры класса для извлечения.
Свойства параметра
| Тип: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromGroup
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Id
Указывает идентификатор экземпляров класса для извлечения. Это может быть GUID или строка, которая будет преобразована в GUID.
Свойства параметра
| Тип: | System.Guid[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromEMOIdParameterSetName
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя экземпляров класса для извлечения.
Свойства параметра
| Тип: | System.String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromEMONameParameterSetName
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SCSession
Указывает подключение к серверу управления. Значением по умолчанию является текущее подключение к группе управления.
Можно ввести объект подключения к группе управления, который возвращается командлетом Get-SCManagementGroupConnection .
Свойства параметра
| Тип: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Вы можете передать класс в параметр Class командлета Get-SCClassInstance .
Выходные данные
EnterpriseManagementObject
Этот командлет создает объект типа EnterpriseManagementObject#<classtype> .