다음을 통해 공유

Uninstall-SCOMAgent

  • 참조
모듈:
OperationsManager

에이전트 관리 컴퓨터에서 에이전트를 제거합니다.

구문

Uninstall-SCOMAgent
         [-ActionAccount <PSCredential>]
         -Agent <AgentManagedComputer[]>
         [-PassThru]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

Uninstall-SCOMAgent cmdlet은 에이전트 관리 컴퓨터에서 에이전트를 제거합니다. 에이전트를 제거하기 전에 관리 그룹에서 AD DS(Active Directory Domain Services) 에이전트 할당을 제거해야 합니다. Remove-SCOMADAgentAssignment cmdet을 사용하여 관리 그룹에서 AD DS 에이전트 할당을 제거할 수 있습니다.

예제

예제 1: 에이전트 제거

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent

첫 번째 명령은 server01.contoso.com 라는 Operations Manager 에이전트 개체를 가져오고 파이프라인 연산자를 사용하여 Uninstall-SCOMAgent cmdlet에 전달합니다. 두 번째 명령은 server01.contoso.com 에이전트를 제거합니다.

예제 2: 개체 변수를 사용하여 에이전트 제거

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent

이 예제에서는 에이전트 관리 컴퓨터에서 Operations Manager 에이전트를 제거합니다.

첫 번째 명령은 server01.contoso.com 에이전트 관리 컴퓨터 개체를 가져오고 개체를 $Agent 변수에 저장합니다.

두 번째 명령은 $Agent 저장된 에이전트를 제거합니다.

예제 3: 작업 계정을 사용하여 에이전트 제거

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)

이 예제에서는 사용자가 Operations Manager에서 에이전트를 제거하는 데 필요한 자격 증명을 입력한 후 에이전트 관리 컴퓨터에서 Operations Manager 에이전트를 제거합니다.

첫 번째 명령은 server01.contoso.com 에이전트 개체를 가져오고 개체를 $Agent 변수에 저장합니다.

두 번째 명령은 Operations Manager가 에이전트를 제거하는 데 사용하는 자격 증명을 입력하라는 메시지를 사용자에게 표시합니다. 그런 다음 명령은 $Agent 저장된 에이전트를 제거합니다.

매개 변수

-ActionAccount

PSCredential 개체를 지정합니다. 이 매개 변수는 Operations Manager가 배포 작업을 실행하는 데 사용하는 자격 증명을 지정합니다. 이 매개 변수를 지정하지 않거나 null 값을 지정하는 경우 Operations Manager는 에이전트에 대한 관리 서버의 기본 작업 계정을 사용합니다.

PSCredential 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용은 Get-Help Get-Credential입력합니다.

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Agent

AgentManagedComputer 개체의 배열을 지정합니다. 이 매개 변수는 제거할 Operations Manager 에이전트를 지정합니다. AgentManagedComputer 개체를 가져오려면 Get-SCOMADAgent cmdlet을 사용합니다.

형식:AgentManagedComputer[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

cmdlet이 명령이 파이프라인에서 사용할 수 있는 개체를 만들거나 수정한다는 것을 나타냅니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

출력

Microsoft.EnterpriseManagement.Administration.AgentTaskResult