Get-SCSMClassInstance

Модуль:

System.Center.Service.Manager

Возвращает экземпляры классов.

Синтаксис

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

Описание

Командлет Get-SCSMClassInstance извлекает экземпляры классов.

Примеры

Пример 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-SCSMClassInstance -criteria $criteria

Эти команды извлекают компьютеры с помощью условий NetbiosDomainName равно WOODGROVE. Первые команды определяют параметры, которые затем используются в окончательном командлете Get-SCSMClassInst ance.

Пример 2. Получение экземпляров класса с помощью фильтра

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

Эта команда извлекает объекты экземпляров класса из базы данных Service Manager с помощью фильтра. Обратите внимание, что имя свойства в фильтре должно быть точным именем свойства и учитывается регистр.

Пример 3. Получение всех объектов компьютера

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

Эти команды извлекают все объекты экземпляра класса типа Computer из базы данных Service Manager.

Параметры

-Class

Указывает имя одного или нескольких классов, которые требуется извлечь. Можно указать объект ManagementPackClass, возвращаемый командлетом Get-SCClass.

Тип:	Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ComputerName

Указывает компьютер, с которым необходимо установить подключение. Компьютер должен запускать службу доступа к данным System Center. Значением по умолчанию является компьютер для текущего подключения группы управления.

Допустимые форматы включают имя NetBIOS, IP-адрес или полное доменное имя (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).

Тип:	System.String[]
Position:	Named
Default value:	Localhost
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

Указывает учетную запись пользователя, в которой будет выполняться подключение группы управления. Учетная запись должна иметь доступ к серверу, указанному в параметре ComputerName, если указан сервер. Значение по умолчанию — текущий пользователь.

Можно ввести объект PSCredential, возвращаемый командлетом Get-Credential.

Тип:	System.Management.Automation.PSCredential
Position:	Named
Default value:	Current user context
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Criteria

Указывает объект условий, ограничивающий набор экземпляров класса, возвращаемых с сервера управления.

Тип:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-DisplayName

Указывает отображаемое имя извлекаемого экземпляра класса.

Тип:	System.String[]
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Filter

Фильтрует набор результатов. Синтаксис фильтра — это оператор <> свойства><>значения, где допустимые операторы : -eq, -ne, -ge, -lt, -le, -like и -notlike. Использование фильтра эффективно, так как фильтр ограничивает результаты, полученные с сервера управления, а не применяется после возврата результатов в PowerShell.

Тип:	System.String
Position:	2
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Group

Указывает экземпляр группы, содержащей экземпляры класса для извлечения.

Тип:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Id

Указывает идентификатор извлекаемых экземпляров класса. Это может быть GUID или строка, которая будет преобразована в GUID.

Тип:	System.Guid[]
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Name

Указывает имя извлекаемых экземпляров класса.

Тип:	System.String[]
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SCSession

Указывает подключение к серверу управления. Значением по умолчанию является текущее подключение группы управления.

Можно ввести объект подключения группы управления, возвращаемый командлетом get-SCManagementGroupConnection.

Тип:	Microsoft.SystemCenter.Core.Connection.Connection[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Класс можно передать в параметр класса командлет а Get-SCSMClassInstance.

Выходные данные

EnterpriseManagementObject

Этот командлет создает объект EnterpriseManagementObject#classtype.

Связанные ссылки

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