다음을 통해 공유

Rename-Computer

  • 참조
모듈:
Microsoft.PowerShell.Management

컴퓨터의 이름을 바꿉니다.

구문

Rename-Computer
      [-ComputerName <String>]
      [-PassThru]
      [-DomainCredential <PSCredential>]
      [-LocalCredential <PSCredential>]
      [-NewName] <String>
      [-Force]
      [-Restart]
      [-WsmanAuthentication <String>]
      [-Protocol <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Rename-Computer cmdlet은 로컬 컴퓨터 또는 원격 컴퓨터의 이름을 바꿉니다. 각 명령에서 하나의 컴퓨터 이름을 바꿉니다.

이 cmdlet은 Windows PowerShell 3.0에서 도입되었습니다.

예제

예제 1: 로컬 컴퓨터 이름 바꾸기

이 명령은 로컬 컴퓨터의 이름을 Server044 이름을 바꾼 다음 다시 시작하여 변경 사항을 적용합니다.

Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart

예제 2: 원격 컴퓨터 이름 바꾸기

이 명령은 Srv01 컴퓨터의 이름을 Server001. 컴퓨터를 다시 시작하지 않습니다.

DomainCredential 매개 변수는 도메인에서 컴퓨터 이름을 바꿀 수 있는 권한이 있는 사용자의 자격 증명을 지정합니다.

Force 매개 변수는 확인 프롬프트를 표시하지 않습니다.

Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force

매개 변수

-ComputerName

지정된 원격 컴퓨터의 이름을 바꿉니다. 기본값은 로컬 컴퓨터입니다.

원격 컴퓨터의 NetBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, 점(.) 또는 localhost입력합니다.

이 매개 변수는 PowerShell 원격을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 Rename-ComputerComputerName 매개 변수를 사용할 수 있습니다.

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

-Confirm

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

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

-DomainCredential

도메인에 연결할 수 있는 권한이 있는 사용자 계정을 지정합니다. 도메인에 가입된 컴퓨터의 이름을 바꾸려면 명시적 자격 증명이 필요합니다.

User01 또는 Domain01\User01같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 생성된 것과 같은 PSCredential 개체를 입력합니다.

사용자 이름을 입력하는 경우 이 cmdlet은 암호를 묻는 메시지를 표시합니다.

ComputerName 매개 변수로 지정된 컴퓨터에 연결할 수 있는 권한이 있는 사용자 계정을 지정하려면 LocalCredential 매개 변수를 사용합니다.

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

-Force

사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.

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

-LocalCredential

ComputerName 매개 변수로 지정된 컴퓨터에 연결할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.

User01 또는 Domain01\User01같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 생성된 것과 같은 PSCredential 개체를 입력합니다.

사용자 이름을 입력하는 경우 이 cmdlet은 암호를 묻는 메시지를 표시합니다.

도메인에 연결할 권한이 있는 사용자 계정을 지정하려면 DomainCredential 매개 변수를 사용합니다.

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

-NewName

컴퓨터의 새 이름을 지정합니다. 이 매개 변수는 필수입니다.

표준 이름에는 문자(a-z), (A-Z), 숫자(0-9), 하이픈(-)이 포함될 수 있지만 공백이나 마침표(.)는 포함되지 않습니다. 이름은 완전히 숫자로 구성되지 않을 수 있으며 63자보다 길지 않을 수 있습니다.

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

-PassThru

명령의 결과를 반환합니다. 그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.

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

-Protocol

컴퓨터 이름을 바꾸는 데 사용할 프로토콜을 지정합니다. 이 매개 변수에 허용되는 값은 WSMan 및 DCOM입니다. 기본값은 DCOM입니다.

이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.

형식:String
허용되는 값:DCOM, WSMan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Restart

이 cmdlet이 이름이 바뀐 컴퓨터를 다시 시작했음을 나타냅니다. 변경을 적용하려면 다시 시작해야 하는 경우가 많습니다.

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

-WhatIf

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

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

-WsmanAuthentication

이 cmdlet에서 WSMan 프로토콜을 사용할 때 사용자 자격 증명을 인증하는 데 사용되는 메커니즘을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 기본
  • credSSP
  • 기본
  • 다이제스트
  • Kerberos
  • 협상

기본값은 Default.

이 매개 변수의 값에 대한 자세한 내용은 AuthenticationMechanism 열거형참조하세요.

경고

인증할 원격 컴퓨터에 사용자 자격 증명이 전달되는 CredSSP(자격 증명 보안 서비스 공급자) 인증은 원격 네트워크 공유 액세스와 같이 둘 이상의 리소스에 대한 인증이 필요한 명령을 위해 설계되었습니다. 이 메커니즘은 원격 작업의 보안 위험을 높입니다. 원격 컴퓨터가 손상된 경우 이 컴퓨터에 전달된 자격 증명을 사용하여 네트워크 세션 > 제어할 수 있습니다.

이 매개 변수는 Windows PowerShell 3.0에서 도입되었습니다.

형식:String
허용되는 값:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

None

이 cmdlet에는 값으로 입력하는 매개 변수가 없습니다. 그러나 ComputerName 값을 파이프하고 개체의 newName 속성을 이 cmdlet에 수 있습니다.

출력

ComputerChangeInfo

이 cmdlet은 PassThru 매개 변수를 지정하는 경우 ComputerChangeInfo 개체를 반환합니다. 그렇지 않으면 출력을 반환하지 않습니다.