Update-SCXAgent
Обновляет агент управления на указанных компьютерах UNIX и Linux до последней доступной версии.
Синтаксис
Default (по умолчанию)
Update-SCXAgent
-Agent <IPersistedUnixComputer[]>
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Update-SCXAgent обновляет агент на указанных компьютерах до последней доступной версии. Если последняя доступная версия агента управления уже установлена на целевом компьютере, никаких действий не выполняется.
Требуемый параметр агента указывает целевые управляемые компьютеры UNIX и Linux для удаления и требуют объекта компьютера UNIX и Linux. Сведения о получении управляемых компьютеров UNIX и Linux см. в командлете Get-SCXAgent. Этот командлет принимает SshCredential и входных параметров WsManCredential. Предоставленный параметр SshCredential используется для действий обновления привилегированного агента, а предоставленный WsManCredential используется для связи с агентом с низким уровнем привилегий. Если параметр SshCredential не указан, командлет пытается использовать учетную запись запуска от имени определенного агента, связанную с целевым компьютером.
Выходные данные этого командлета — это массив управляемых объектов компьютера UNIX или Linux, представляющих целевые системы, которые были успешно обновлены.
Примеры
Пример 1. Обновление агента управления
PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Update-SCXAgent -SSHCredential $SSHCredential -WSManCredential $WSCredential -Agent $Agent01
Первая команда получает агент для управляемого компьютера Linux или UNIX с именем nx1.contoso.com с помощью командлета Get-SCXAgent. Команда сохраняет ее в переменной $Agent 01.
Вторая команда получает учетные данные для пользователя с помощью командлета Get-Credential. Командная строка выполняет проверку подлинности, а затем сохраняет результаты в переменной $WSCredential.
Третья команда создает привилегированные учетные данные для пользователя с помощью командлета Get-SCXSSHCredential. Команда сохраняет результат в переменной $SSHCredential.
Последняя команда обновляет агент управления в $Agent 01 со значениями из второй и третьей команд.
Пример 2. Обновление агента управления с помощью определенной учетной записи запуска от имени
PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Update-SCXAgent
Эта команда получает агент для управляемого компьютера Linux или UNIX с именем nx1.contoso.com с помощью Get-SCXAgent. Команда передает управляемый компьютер текущему командлету. Команда обновляет агент управления с помощью определенной учетной записи запуска от имени.
Параметры
-Agent
Указывает один или несколько управляемых объектов компьютера UNIX или Linux.
Сведения о том, как получить управляемый объект компьютера UNIX или Linux, введите Get-Help Get-SCXAgent.
Свойства параметра
| Тип: | IPersistedUnixComputer[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ComputerName
Задает массив имен компьютеров. Командлет устанавливает временные подключения с группами управления для этих компьютеров. Вы можете использовать имена NetBIOS, IP-адреса или полные доменные имена (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).
Служба доступа к данным System Center должна быть активной на компьютере. Если компьютер не указан, командлет использует компьютер для текущего подключения группы управления.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(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 |
-SCSession
Задает массив объектов подключения
Если этот параметр не указан, командлет использует активное постоянное подключение к группе управления.
Используйте параметр SCSession для указания другого постоянного подключения.
Можно создать временное подключение к группе управления с помощью параметров ComputerName и учетных данных.
Дополнительные сведения см. в Get-Help about_OpsMgr_Connections.
Свойства параметра
| Тип: | Connection[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SshCredential
Указывает привилегированный параметр SshCredential, используемый для выполнения действий обновления агента. Если этот параметр не указан, командлет пытается использовать определенную учетную запись запуска от имени агента.
Сведения о том, как получить объект учетных данных SSH, введите Get-Help Get-SCXSSHCredential.
Свойства параметра
| Тип: | CredentialSet |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WsManCredential
Указывает учетные данные, используемые для связи с агентом с низким уровнем привилегий через WSMan. Этот командлет использует эти учетные данные для проверки доступности агента.
Введите имя пользователя, например User01 или введите объект PSCredential, например объект, возвращаемый командлетом Get-Credential. При вводе имени пользователя вам будет предложено ввести пароль.
Свойства параметра
| Тип: | PSCredential |
| 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
Этот командлет возвращает коллекцию результатов обновления, каждая из которых представляет состояние обновления для компьютера. Каждый результат должен содержать следующие сведения:
- Имя узла
- Операционные системы
- Старая версия агента
- Новая версия агента
- Состояние обновления
- Описание
Описание содержит сведения о том, почему обновление завершилось сбоем.
Примечания
- Этот командлет принимает коллекцию имен узлов в перечисленном виде. Он собирает все имена узлов и обрабатывает всю коллекцию параллельно в конце конвейера.