Get-SCXAgent
Возвращает список управляемых компьютеров UNIX и Linux в группе управления.
Синтаксис
Empty (по умолчанию)
Get-SCXAgent
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgentNamesParameterSetName
Get-SCXAgent
[-Name] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgentGuidsParameterSetName
Get-SCXAgent
-ID <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromResourcePoolParameterSetName
Get-SCXAgent
-ResourcePool <ManagementServicePool>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Описание
Командлет Get-SCXAgent извлекает управляемые компьютеры UNIX и Linux, соответствующие указанным критериям выбора. Если критерии выбора не указаны, возвращаются все управляемые компьютеры UNIX и Linux в группе управления.
Результаты возвращаются в виде массива управляемых объектов компьютеров UNIX и Linux.
Примеры
Пример 1. Возврат управляемых компьютеров UNIX и Linux
PS C:\>Get-SCXAgent
Эта команда возвращает все управляемые компьютеры UNIX и Linux в пуле ресурсов.
Пример 2. Возврат управляемых компьютеров UNIX и Linux из пула ресурсов
PS C:\>$ResourcePool = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Get-SCXAgent -ResourcePool $ResourcePool
Первая команда получает пул ресурсов с помощью командлета Get-SCOMResourcePool и сохраняет его в переменной $ResourcePool.
Вторая команда возвращает все управляемые компьютеры UNIX и Linux для пула ресурсов в $ResourcePool.
Пример 3. Возврат управляемых компьютеров UNIX и Linux с помощью имени
PS C:\>Get-SCXAgent -Name "nx1.contoso.com,nx2.*","*.development.contoso.com"
Эта команда возвращает управляемые компьютеры UNIX и Linux с именами, соответствующими предоставленному списку строк.
Пример 4. Возврат управляемых компьютеров UNIX и Linux с помощью конвейера
PS C:\>"server1", "server2", "server3" | Get-SCXAgent
Эта команда предоставляет параметр имени
Пример 5. Подключение к пулу ресурсов и получение управляемого компьютера по имени
PS C:\>Get-SCXAgent -Name "*development.contoso.com" -ComputerName "server1.contoso.com"
Эта команда подключается к пулу ресурсов с временным подключением с использованием учетных данных текущего пользователя и возвращает только управляемые компьютеры, соответствующие свойству Name.
Параметры
-ComputerName
Задает массив имен компьютеров. Командлет устанавливает временные подключения с группами управления для этих компьютеров. Вы можете использовать имена NetBIOS, IP-адреса или полные доменные имена (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).
Служба доступа к данным System Center должна быть активной на компьютере. Если компьютер не указан, командлет использует компьютер для текущего подключения группы управления.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетную запись пользователя, в которой выполняется подключение группы управления.
Укажите объект PSCredential, например объект get-Credential для этого параметра.
Дополнительные сведения об объектах учетных данных введите Get-Help Get-Credential.
Если указать компьютер в параметре ComputerName, используйте учетную запись, доступ к которому имеется. По умолчанию используется текущий пользователь.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ID
Указывает идентификатор управляемого объекта компьютера UNIX или Linux. Возвращает только управляемые компьютеры с свойствами идентификатора, которые соответствуют этому значению. Этот параметр принимается из конвейера.
Свойства параметра
| Тип: | Guid[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromAgentGuidsParameterSetName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Задает список полных доменных имен для одного или нескольких управляемых компьютеров UNIX и Linux.
Возвращает только управляемые компьютеры, соответствующие свойству имени
Вы можете включить подстановочные знаки, в этом случае возвращаются все компьютеры, соответствующие подстановочным знакам.
Сведения об использовании подстановочных знаков введите Get-Help About_Wildcards.
Этот параметр принимается из конвейера.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Отображаемое имя |
Наборы параметров
FromAgentNamesParameterSetName
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResourcePool
Указывает пул ресурсов серверов, один из которых назначается текущим сервером управления, а другой — сервером управления резервным копированием. Этот параметр требует объекта пула ресурсов и возвращает только управляемые компьютеры в этом пуле ресурсов.
Сведения о том, как получить объект SCOMResourcePool, введите Get-Help Get-SCOMResourcePool.
Свойства параметра
| Тип: | ManagementServicePool |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | RP |
Наборы параметров
FromResourcePoolParameterSetName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SCSession
Задает массив объектов подключения
Если этот параметр не указан, командлет использует активное постоянное подключение к группе управления.
Используйте параметр SCSession для указания другого постоянного подключения.
Можно создать временное подключение к группе управления с помощью параметров ComputerName и учетных данных.
Дополнительные сведения см. в Get-Help about_OpsMgr_Connections.
Свойства параметра
| Тип: | 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.Unix.Computer
Этот командлет возвращает один или несколько объектов компьютеров, представляющих управляемые компьютеры UNIX и Linux, когда компьютеры UNIX и Linux соответствуют критериям ввода.