다음을 통해 공유

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

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

이 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 원격을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 ComputerName 매개 변수 Rename-Computer 를 사용할 수 있습니다.

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

-Confirm

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

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

-DomainCredential

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

사용자 이름(예: User01 cmdlet에서 생성된 개체)을 입력하거나 Domain01\User01PSCredential 개체를 Get-Credential 입력합니다.

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

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

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

-Force

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

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

-LocalCredential

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

사용자 이름(예: User01 cmdlet에서 생성된 개체)을 입력하거나 Domain01\User01PSCredential 개체를 Get-Credential 입력합니다.

사용자 이름을 입력하는 경우 이 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 열거형을 참조 하세요.

Warning

인증할 원격 컴퓨터에 사용자 자격 증명이 전달되는 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으로 파이프할 수 있습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

RenameComputerChangeInfo

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 RenameComputerChangeInfo 개체를 반환합니다.