Install-SCOMAgent

참조

모듈:: OperationsManager

Operations Manager 에이전트를 배포합니다.

Syntax

Install-SCOMAgent
       -ActionAccount <PSCredential>
       [-AgentActionAccount <PSCredential>]
       -DNSHostName <String[]>
       -PrimaryManagementServer <ManagementServer>
       [-NoAPM]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Install-SCOMAgent cmdlet은 클라이언트 강제 설치를 사용하여 하나 이상의 System Center 2019 - Operations Manager 및 이후 제품 버전 에이전트를 배포합니다. 참고: [-NoAPM] 매개 변수는 System Center Operations Manager 1807에서 도입되었습니다(이 매개 변수는 System Center 2019 Operations Manager에서 유효하지 않음).

예제

예제 1: 서버에 에이전트 설치

PS C:\>$PrimaryMgmtServer = Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com"
PS C:\> Install-SCOMAgent -DNSHostName "server01.contoso.com" -PrimaryManagementServer $PrimaryMgmtServer

다음은 서버에 에이전트를 설치하고 에이전트에 대한 기본 관리 서버를 설정하는 예제입니다.

첫 번째 명령은 MgmtServer01.Contoso.com 관리 서버 개체를 가져오고 $PrimaryMgmtServer 변수에 개체를 저장합니다.

두 번째 명령은 Server01.Contoso.com 에이전트를 설치하고 주 관리 서버를 $PrimaryMgmtServer 저장된 관리 서버로 설정합니다.

예제 2: 작업 계정 자격 증명을 사용하여 서버에 에이전트 설치

PS C:\>$InstallAccount = Get-Credential
PS C:\> $PrimaryMgmtServer = Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com"
PS C:\> Install-SCOMAgent -DNSHostName "Server01.Contoso.com" -PrimaryManagementServer $PrimaryMgmtServer -ActionAccount $InstallAccount

다음은 사용자에게 자격 증명을 입력하라는 메시지를 표시한 다음 자격 증명을 사용하여 에이전트를 설치하는 예제입니다.

첫 번째 명령은 사용자에게 자격 증명을 묻는 메시지를 표시하고 $InstallAccount 변수에 자격 증명을 저장합니다.

두 번째 명령은 MgmtServer01.Contoso.com 명명된 관리 서버 개체를 가져오고 개체를 $PrimaryMgmtServer 변수에 저장합니다.

세 번째 명령은 $InstallAccount 저장된 자격 증명을 사용하여 Server01.Contoso.com 에이전트를 설치하고 에이전트의 기본 관리 서버를 $PrimaryMgmtServer 저장된 관리 서버로 설정합니다.

예제 3: 서버에 에이전트 설치 및 에이전트 작업 계정 설정

PS C:\>$Agents = "DC1.contoso.com","DC2.contoso.com","DC3.contoso.com"
PS C:\> $InstallAccount = Get-Credential
PS C:\> $AgentActionAccount = Get-Credential Contoso\ActionAccount
PS C:\> $PrimaryMgmtServer = Get-SCOMManagementserver -ComputerName MgmtServer01.contoso.com
PS C:\> $Install-SCOMAgent -DNSHostName $Agents -PrimaryManagementServer $PrimaryMgmtServer -ActionAccount $InstallAccount -AgentActionAccount $AgentActionAccount -Confirm

다음은 세 대의 컴퓨터에 에이전트를 설치하고 에이전트에 대한 에이전트 작업 계정을 설정하는 예제입니다.

첫 번째 명령은 세 컴퓨터의 이름을 $Agents 변수에 저장합니다.

두 번째 명령은 사용자에게 자격 증명을 묻는 메시지를 표시하고 자격 증명을 $InstallAccount 변수에 저장합니다.

세 번째 명령은 Contoso 도메인에서 ActionAccount라는 사용자 계정의 암호를 묻는 메시지를 표시하고 자격 증명을 $AgentActionAccount 변수에 저장합니다.

네 번째 명령은 MgmtServer01.Contoso.com 관리 서버 개체를 가져오고 $PrimaryMgmtServer 변수에 개체를 저장합니다.

다섯 번째 명령은 $InstallAccount 저장된 자격 증명을 사용하여 $Agents 변수에 저장된 세 대의 컴퓨터에 에이전트를 설치합니다. 이 명령은 에이전트의 기본 관리 서버를 $PrimaryMgmtServer 저장된 관리 서버로 설정하고 에이전트 작업 계정을 $AgentActionAccount 저장된 ActionAccount 사용자로 설정합니다.

매개 변수

-ActionAccount

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

이 매개 변수는 컴퓨터에 설치한 후 에이전트에서 사용하는 작업 계정을 지정하지 않습니다. 기본적으로 에이전트에서 사용하는 작업 계정은 로컬 시스템으로 설정됩니다. AgentActionAccount 매개 변수를 사용하여 에이전트에서 사용하는 작업 계정을 변경할 수 있습니다.

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

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

-AgentActionAccount

PSCredential 개체를 지정합니다. 이 매개 변수는 에이전트가 컴퓨터에 설치된 후 사용하는 작업 계정을 지정합니다. 기본적으로 에이전트에서 사용하는 작업 계정은 로컬 시스템으로 설정됩니다. PSCredential 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용을 보려면 Get-Help Get-Credential를 입력하십시오. Get-SCOMRunAsProfile cmdlet을 사용하여 작업 계정에 사용할 수 있는 실행 계정을 가져올 수 있습니다.

Type:	PSCredential
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

-DNSHostName

DNS(Domain Name System) 호스트의 이름을 지정합니다.

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

-NoAPM

System Center Operations Manager 1807에서 도입된 선택적 매개 변수입니다(이 매개 변수는 System Center 2019 Operations Manager에서는 유효하지 않음). 이 매개 변수를 사용하면 에이전트에서 APM 구성 요소의 설치를 선택할 수 있습니다. 이 매개 변수를 사용하여 에이전트에서 APM 구성 요소의 설치를 건너뜁니다.

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

-PassThru

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

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

-PrimaryManagementServer

ManagementServer 개체를 지정합니다. 이 매개 변수는 에이전트의 기본 관리 서버를 지정합니다. ManagementServer 개체를 가져오려면 Get-SCOMManagementServer cmdlet을 사용합니다.

Type:	ManagementServer
Position:	Named
Default value:	None
Required:	True
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