Remove-SCXAgent

관리 그룹에서 대상 관리 UNIX 및 Linux 컴퓨터를 제거합니다.

Syntax

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

Description

Remove-SCXAgent cmdlet은 관리 그룹에서 대상 관리 UNIX 및 Linux 컴퓨터를 제거합니다. 관리되는 UNIX 및 Linux 컴퓨터는 UNIX 및 Linux 컴퓨터 개체의 배열로 Remove-SCXAgent cmdlet에 전달됩니다.

관리되는 UNIX 및 Linux 컴퓨터를 검색하는 방법에 대한 자세한 내용은 Get-SCXAgent cmdlet을 참조하세요.

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

예제

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

PS C:\>$Agents = Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com"
PS C:\> Remove-SCXAgent -Agent $Agents

첫 번째 명령은 Get-SCXAgent cmdlet을 사용하여 지정된 이름과 일치하는 관리되는 Linux 또는 UNIX 컴퓨터에 대한 에이전트를 가져옵니다. 명령은 결과를 $Agents 배열 변수에 저장합니다.

마지막 명령은 $Agents 에이전트를 제거합니다.

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

PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent

이 명령은 Get-SCXAgent를 사용하여 지정된 이름과 일치하는 관리되는 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

연결 개체의 배열을 지정합니다. 연결 개체를 얻으려면 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

-WhatIf

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

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

출력

이 cmdlet은 어떠한 출력도 생성하지 않습니다. Remove-SCXAgent cmdlet에 대한 오류 사례는 없습니다.