Update-SCXAgent

참조

모듈:: OperationsManager

지정된 UNIX 및 Linux 컴퓨터의 관리 에이전트를 사용 가능한 최신 버전으로 업그레이드합니다.

Syntax

Update-SCXAgent
      -Agent <IPersistedUnixComputer[]>
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update-SCXAgent cmdlet은 지정된 컴퓨터의 에이전트를 사용 가능한 최신 버전으로 업데이트합니다. 사용 가능한 최신 버전의 관리 에이전트가 대상 컴퓨터를 이미 설치한 경우 아무 작업도 수행되지 않습니다.

필요한 에이전트 매개 변수는 제거할 대상 관리 UNIX 및 Linux 컴퓨터를 지정하며 UNIX 및 Linux 컴퓨터 개체가 필요합니다. 관리되는 UNIX 및 Linux 컴퓨터를 검색하는 방법에 대한 자세한 내용은 Get-SCXAgent cmdlet을 참조하세요. 이 cmdlet은 SshCredential 및 WsManCredential 입력 매개 변수를 허용합니다. 제공된 SshCredential 매개 변수는 권한 있는 에이전트 업데이트 작업에 사용되고 제공된 WsManCredential 은 낮은 권한의 에이전트 통신에 사용됩니다. SshCredential 매개 변수가 제공되지 않으면 cmdlet은 대상 컴퓨터와 연결된 정의된 에이전트 유지 관리 실행 계정을 사용하려고 시도합니다.

이 cmdlet의 출력은 성공적으로 업데이트된 대상 시스템을 나타내는 관리되는 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

첫 번째 명령은 Get-SCXAgent cmdlet을 사용하여 nx1.contoso.com 관리되는 Linux 또는 UNIX 컴퓨터에 대한 에이전트를 가져옵니다. 명령은 $Agent 01 변수에 저장합니다.

두 번째 명령은 Get-Credential cmdlet을 사용하여 사용자에 대한 자격 증명을 가져옵니다. 이 명령은 인증을 요청하는 메시지를 표시한 다음 결과를 $WSCredential 변수에 저장합니다.

세 번째 명령은 Get-SCXSSHCredential cmdlet을 사용하여 사용자에 대한 권한 있는 자격 증명을 만듭니다. 이 명령은 결과를 $SSHCredential 변수에 저장합니다.

최종 명령은 $Agent 01의 관리 에이전트를 두 번째 및 세 번째 명령의 값으로 업데이트합니다.

예제 2: 정의된 실행 계정으로 관리 에이전트 업데이트

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Update-SCXAgent

이 명령은 Get-SCXAgent를 사용하여 nx1.contoso.com 관리되는 Linux 또는 UNIX 컴퓨터에 대한 에이전트를 가져옵니다. 이 명령은 관리되는 컴퓨터를 현재 cmdlet에 전달합니다. 이 명령은 정의된 실행 계정을 사용하여 관리 에이전트를 업데이트합니다.

매개 변수

-Agent

하나 이상의 관리되는 UNIX 또는 Linux 컴퓨터 개체를 지정합니다. 관리되는 UNIX 또는 Linux 컴퓨터 개체를 가져오는 방법에 대한 자세한 내용을 보려면 다음을 입력합니다 Get-Help Get-SCXAgent.

Type:	IPersistedUnixComputer[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

컴퓨터 이름의 배열을 지정합니다. cmdlet은 이러한 컴퓨터에 대한 관리 그룹과 임시 연결을 설정합니다. NetBIOS 이름, IP 주소 또는 FQDN(정규화된 도메인 이름)을 사용할 수 있습니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, localhost 또는 점(.)을 입력합니다.

System Center 데이터 액세스 서비스는 컴퓨터에서 활성화되어 있어야 합니다. 컴퓨터를 지정하지 않으면 cmdlet은 현재 관리 그룹 연결에 컴퓨터를 사용합니다.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

관리 그룹 연결이 실행되는 사용자 계정을 지정합니다. 이 매개 변수에 대해 Get-Credential cmdlet이 반환하는 것과 같은 PSCredential 개체를 지정합니다. 자격 증명 개체에 대한 자세한 내용을 보려면 .를 입력합니다 Get-Help Get-Credential.

ComputerName 매개 변수에 컴퓨터를 지정하는 경우 해당 컴퓨터에 액세스할 수 있는 계정을 사용합니다. 기본값은 현재 사용자입니다.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SCSession

Connection 개체의 배열을 지정합니다. 연결 개체를 얻으려면 Get-SCOMManagementGroupConnection cmdlet을 사용합니다.

이 매개 변수를 지정하지 않으면 cmdlet은 관리 그룹에 대한 활성 영구 연결을 사용합니다. SCSession 매개 변수를 사용하여 다른 영구 연결을 지정합니다. ComputerName 및 자격 증명 매개 변수를 사용하여 관리 그룹에 대한 임시 연결을 만들 수 있습니다. 자세한 내용을 보려면 Get-Help about_OpsMgr_Connections를 입력하십시오.

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SshCredential

에이전트 업데이트 작업을 수행하는 데 사용되는 권한 있는 SshCredential 매개 변수를 지정합니다. 이 매개 변수를 지정하지 않으면 cmdlet은 에이전트에 대해 정의된 에이전트 유지 관리 실행 계정을 사용하려고 시도합니다.

SSH 자격 증명 개체를 가져오는 방법에 대한 자세한 내용을 보려면 을 입력합니다 Get-Help Get-SCXSSHCredential.

Type:	CredentialSet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WsManCredential

WSMan을 통한 낮은 권한의 에이전트 통신에 사용되는 자격 증명을 지정합니다. 이 cmdlet은 이 자격 증명을 사용하여 에이전트 가용성을 확인합니다.

User01과 같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 반환되는 것과 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 입력하라는 메시지가 표시됩니다.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

출력

Microsoft.Unix.Computer[]

이 cmdlet은 각각 컴퓨터의 업그레이드 상태를 나타내는 업그레이드 결과 컬렉션을 반환합니다. 각 결과에는 다음 정보가 포함되어야 합니다.

호스트 이름
운영 체제
이전 에이전트 버전
새 에이전트 버전
업그레이드 상태
설명

설명에는 업그레이드가 실패한 이유에 대한 세부 정보가 포함되어 있습니다.

참고

이 cmdlet은 열거형 방식으로 호스트 이름 컬렉션을 사용합니다. 모든 호스트 이름을 수집하고 파이프라인의 끝에서 전체 컬렉션을 병렬로 처리합니다.