Uninstall-SCXAgent

모듈:

OperationsManager

지정된 관리되는 UNIX 및 Linux 컴퓨터에서 관리 에이전트를 제거합니다.

Syntax

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

Description

Uninstall-SCXAgent cmdlet은 지정된 UNIX 및 Linux 컴퓨터에서 관리 에이전트를 제거합니다.

필요한 에이전트 매개 변수는 제거할 대상 관리 UNIX 또는 Linux 컴퓨터를 지정하며 UNIX 또는 Linux 컴퓨터 개체가 필요합니다. 관리되는 UNIX 또는 Linux 컴퓨터를 검색하는 방법에 대한 자세한 내용은 Get-SCXAgent cmdlet을 참조하세요. 선택적 SSHCredential 매개 변수를 지정하여 관리 에이전트를 제거하는 데 사용되는 권한 있는 자격 증명을 식별할 수 있습니다. SSHCredential을 지정하지 않으면 cmdlet은 에이전트에 대해 정의된 권한 있는 실행 계정을 사용하려고 시도합니다.

이 cmdlet은 어떠한 출력도 반환되지 않습니다.

예제

예제 1: 관리 에이전트 제거

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Uninstall-SCXAgent -SSHCredential $SSHCredential -Agent $Agent01

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

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

최종 명령은 지정된 SSH 자격 증명을 사용하여 $Agent 01에서 관리 에이전트를 제거합니다.

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

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Uninstall-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

에이전트 유지 관리 작업을 수행하는 데 사용되는 권한 있는 SSH 자격 증명을 지정합니다. 이 매개 변수를 지정하지 않으면 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

출력

이 cmdlet은 컴퓨터의 제거 상태를 나타내는 결과를 반환합니다. 결과에는 다음 정보가 포함됩니다.

• 호스트 이름
• 제거 상태
• 설명

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

관련 링크

• Get-SCXAgent
• Install-SCXAgent
• Remove-SCXAgent
• Update-SCXAgent