다음을 통해 공유


PowerShell 명령에 승인된 동사

PowerShell은 cmdlet의 이름과 파생된 .NET 클래스에 동사-명사 쌍을 사용합니다. 이름의 동사 부분은 cmdlet이 수행하는 작업을 식별합니다. 이름의 명사 부분은 작업이 수행되는 엔터티를 식별합니다. 예를 들어 Get-Command cmdlet은 PowerShell에 등록된 모든 명령을 검색합니다.

비고

PowerShell은 동사 용어를 사용하여 해당 단어가 영어의 표준 동사가 아니더라도 작업을 의미하는 단어를 설명합니다. 예를 들어 New 용어는 영어의 동사가 아니더라도 작업을 의미하기 때문에 유효한 PowerShell 동사 이름입니다.

승인된 각 동사에는 정의된 해당 별칭 접두사가 있습니다. 이 별칭 접두사는 해당 동사를 사용하는 명령에 별칭으로 사용합니다. 예를 들어 Import 별칭 접두사는 ipImport-Module 별칭은 ipmo. 권장 사항이지만 규칙이 아닙니다. 특히 다른 환경에서 잘 알려진 명령을 모방하는 명령 별칭을 사용할 필요는 없습니다.

동사 명명 권장 사항

다음 권장 사항은 사용자가 만든 cmdlet, PowerShell에서 제공하는 cmdlet 및 다른 사용자가 디자인한 cmdlet 간의 일관성을 보장하기 위해 cmdlet에 적합한 동사를 선택하는 데 도움이 됩니다.

  • PowerShell에서 제공하는 미리 정의된 동사 이름 중 하나를 사용합니다.
  • 동사를 사용하여 작업의 일반적인 범위를 설명하고 매개 변수를 사용하여 cmdlet의 동작을 추가로 구체화합니다.
  • 승인된 동사의 동의어를 사용하지 마세요. 예를 들어 항상 Remove사용하고 Delete 또는 Eliminate사용하지 마세요.
  • 이 항목에 나열된 각 동사의 형식만 사용합니다. 예를 들어 Get사용하지만 Getting 또는 Gets사용하지 마세요.
  • 다음과 같은 예약된 동사 또는 별칭을 사용하지 마세요. PowerShell 언어와 드문 몇 cmdlet은 예외적인 상황에서 이러한 동사를 사용합니다.
    • ForEach(foreach)
    • Ping(pi)
    • 정렬(sr)
    • 티(te)
    • Where(wh)

Get-Verb cmdlet을 사용하여 동사의 전체 목록을 가져올 수 있습니다.

다른 작업에 대한 유사한 동사

다음 유사한 동사는 다른 작업을 나타냅니다.

새로 만들기 및 추가

New 동사를 사용하여 새 리소스를 만듭니다. Add 사용하여 기존 컨테이너 또는 리소스에 항목을 추가합니다. 예를 들어 Add-Content 기존 파일에 출력을 추가합니다.

새로 만들기 및 설정

New 동사를 사용하여 새 리소스를 만듭니다. Set 동사를 사용하여 기존 리소스를 수정하고, Set-Variable cmdlet과 같이 기존 리소스가 없는 경우 선택적으로 만듭니다.

Find 동사를 사용하여 개체를 찾습니다. Search 동사를 사용하여 컨테이너의 리소스에 대한 참조를 만듭니다.

가져오기 및 읽기

Get 동사를 사용하여 리소스에 대한 정보(예: 파일)를 가져오거나 나중에 리소스에 액세스할 수 있는 개체를 가져옵니다. Read 동사를 사용하여 리소스를 열고 포함된 정보를 추출합니다.

호출 및 시작

Invoke 동사를 사용하여 명령 실행 및 종료 대기와 같은 동기 작업을 수행합니다. Start 동사를 사용하여 자율 프로세스 시작과 같은 비동기 작업을 시작합니다.

Ping 및 테스트

Test 동사를 사용합니다.

공통 동사

PowerShell은 System.Management.Automation.VerbsCommon 열거형 클래스를 사용하여 거의 모든 cmdlet에 적용할 수 있는 제네릭 작업을 정의합니다. 다음 표에서는 정의된 대부분의 동사를 나열합니다.

동사(별칭) 조치 피해야 할 동의어
추가(a) 컨테이너에 리소스를 추가하거나 항목을 다른 항목에 연결합니다. 예를 들어 Add-Content cmdlet은 파일에 콘텐츠를 추가합니다. 이 동사는 Remove. 추가, 연결, 연결, 삽입
지우기(cl) 컨테이너에서 모든 리소스를 제거하지만 컨테이너는 삭제하지 않습니다. 예를 들어 Clear-Content cmdlet은 파일의 내용을 제거하지만 파일을 삭제하지는 않습니다. 플러시, 지우기, 해제, 표시 취소, 설정 취소, Nullify
닫기(cs) 리소스의 상태를 변경하여 액세스할 수 없거나, 사용할 수 없거나, 사용할 수 없도록 합니다. 이 동사는 Open.
복사(cp) 리소스를 다른 이름 또는 다른 컨테이너에 복사합니다. 예를 들어 Copy-Item cmdlet은 데이터 저장소의 한 위치에서 다른 위치로 항목(예: 파일)을 복사합니다. 복제, 복제, 복제, 동기화
입력(et) 사용자가 리소스로 이동할 수 있도록 하는 작업을 지정합니다. 예를 들어 Enter-PSSession cmdlet은 사용자를 대화형 세션에 배치합니다. 이 동사는 Exit. 푸시, 인
종료(예) 현재 환경 또는 컨텍스트를 가장 최근에 사용한 컨텍스트로 설정합니다. 예를 들어 Exit-PSSession cmdlet은 대화형 세션을 시작하는 데 사용된 세션에 사용자를 배치합니다. 이 동사는 Enter. Pop, Out
찾기(fd) 알 수 없거나, 암시적이거나, 선택적이거나, 지정된 컨테이너에서 개체를 찾습니다. 검색
서식(f) 개체를 지정된 폼이나 레이아웃으로 정렬합니다.
가져오기(g) 리소스를 검색하는 작업을 지정합니다. 이 동사는 Set. 읽기, 열기, 고양이, 유형, Dir, 가져오기, 덤프, 획득, 검사, 찾기, 검색
숨기기(h) 리소스를 감지할 수 없게 만듭니다. 예를 들어 이름에 동사 숨기기가 포함된 cmdlet은 사용자의 서비스를 숨길 수 있습니다. 이 동사는 Show. 차단
조인(j) 리소스를 하나의 리소스로 결합합니다. 예를 들어 Join-Path cmdlet은 경로를 자식 경로 중 하나와 결합하여 단일 경로를 만듭니다. 이 동사는 Split. 결합, 결합, 연결, 연결
잠금(lk) 리소스를 보호합니다. 이 동사는 Unlock. Restrict, Secure
이동(m) 리소스를 한 위치에서 다른 위치로 이동합니다. 예를 들어 Move-Item cmdlet은 데이터 저장소의 한 위치에서 다른 위치로 항목을 이동합니다. 전송, 이름, 마이그레이션
(n) 리소스를 만듭니다. (Set 동사는 Set-Variable cmdlet과 같은 데이터를 포함하는 리소스를 만들 때도 사용할 수 있습니다.) 만들기, 생성, 빌드, 만들기, 할당
열기(op) 리소스의 상태를 변경하여 액세스 가능하거나, 사용 가능하거나, 사용할 수 있도록 합니다. 이 동사는 Close.
최적화(om) 리소스의 효율성을 높입니다.
Pop(pop) 스택의 맨 위에서 항목을 제거합니다. 예를 들어 Pop-Location cmdlet은 현재 위치를 스택에 가장 최근에 푸시된 위치로 변경합니다.
푸시(pu) 스택의 맨 위에 항목을 추가합니다. 예를 들어 Push-Location cmdlet은 현재 위치를 스택에 푸시합니다.
다시 실행(다시) 리소스를 실행 취소된 상태로 다시 설정합니다.
제거(r) 컨테이너에서 리소스를 삭제합니다. 예를 들어 Remove-Variable cmdlet은 변수와 해당 값을 삭제합니다. 이 동사는 Add. 지우기, 잘라내기, 삭제, 지우기
이름 바꾸기(rn) 리소스의 이름을 변경합니다. 예를 들어 저장된 데이터에 액세스하는 데 사용되는 Rename-Item cmdlet은 데이터 저장소의 항목 이름을 변경합니다. 변화
다시 설정(rs) 리소스를 원래 상태로 다시 설정합니다.
크기 조정(rz) 리소스의 크기를 변경합니다.
검색(sr) 컨테이너의 리소스에 대한 참조를 만듭니다. 찾기, 찾기
선택(sc) 컨테이너에서 리소스를 찾습니다. 예를 들어 Select-String cmdlet은 문자열 및 파일에서 텍스트를 찾습니다. 찾기, 찾기
설정 기존 리소스의 데이터를 대체하거나 일부 데이터가 포함된 리소스를 만듭니다. 예를 들어 Set-Date cmdlet은 로컬 컴퓨터의 시스템 시간을 변경합니다. (New 동사를 사용하여 리소스를 만들 수도 있습니다.) 이 동사는 Get. 쓰기, 다시 설정, 할당, 구성, 업데이트
표시(sh) 리소스를 사용자에게 표시합니다. 이 동사는 Hide. 표시, 생성
건너뛰기(sk) 시퀀스에서 하나 이상의 리소스 또는 지점을 바이패스합니다. 바이패스, 점프
분할(sl) 리소스의 일부를 구분합니다. 예를 들어 Split-Path cmdlet은 경로의 다른 부분을 반환합니다. 이 동사는 Join. 가르다
단계(st) 순서대로 다음 지점 또는 리소스로 이동합니다.
스위치(sw) 두 위치, 책임 또는 상태 간에 변경하는 것과 같이 두 리소스를 번갈아 사용하는 작업을 지정합니다.
실행 취소(un) 리소스를 이전 상태로 설정합니다.
잠금 해제(영국) 잠긴 리소스를 해제합니다. 이 동사는 Lock. 릴리스, 불안, 안전하지 않음
조사식(wc) 리소스에서 변경 내용을 지속적으로 검사하거나 모니터링합니다.

통신 동사

PowerShell은 System.Management.Automation.VerbsCommunications 클래스를 사용하여 통신에 적용되는 작업을 정의합니다. 다음 표에서는 정의된 대부분의 동사를 나열합니다.

동사(별칭) 조치 피해야 할 동의어
연결(참조) 원본과 대상 간에 링크를 만듭니다. 이 동사는 Disconnect. 조인, 텔넷, 로그인
연결 끊기(dc) 원본과 대상 간의 연결을 끊습니다. 이 동사는 Connect. 중단, 로그오프
읽기(rd) 원본에서 정보를 가져옵니다. 이 동사는 Write. 획득, 프롬프트, 가져오기
수신(rc) 원본에서 보낸 정보를 수락합니다. 이 동사는 Send. 읽기, 수락, 피킹
보내기(sd) 대상에 정보를 전달합니다. 이 동사는 Receive. Put, Broadcast, Mail, Fax
쓰기(wr) 대상에 정보를 추가합니다. 이 동사는 Read. Put, Print

데이터 동사

PowerShell은 System.Management.Automation.VerbsData 클래스를 사용하여 데이터 처리에 적용되는 작업을 정의합니다. 다음 표에서는 정의된 대부분의 동사를 나열합니다.

동사 이름(별칭) 조치 피해야 할 동의어
Backup(ba) 데이터를 복제하여 저장합니다. 저장, 굽기, 복제, 동기화
검사점(ch) 데이터 또는 해당 구성의 현재 상태에 대한 스냅샷을 만듭니다. 차이점
비교(cr) 한 리소스의 데이터를 다른 리소스의 데이터에 대해 평가합니다. 차이점
압축(cm) 리소스의 데이터를 압축합니다. Expand. 소형
변환(cv) cmdlet이 양방향 변환을 지원하거나 cmdlet이 여러 데이터 형식 간의 변환을 지원하는 경우 한 표현에서 다른 표현으로 데이터를 변경합니다. 변경, 크기 조정, 다시 샘플
ConvertFrom(cf) 하나의 기본 입력 형식(cmdlet 명사에서 입력을 나타낸다)을 하나 이상의 지원되는 출력 형식으로 변환합니다. 내보내기, 출력, 출력
ConvertTo(ct) 하나 이상의 입력 형식에서 기본 출력 형식으로 변환합니다(cmdlet 명사에서 출력 형식을 나타낸다). Import, Input, In
분리(dm) 위치에서 명명된 엔터티를 분리합니다. 이 동사는 Mount. 분리, 연결 해제
편집(ed) 콘텐츠를 추가하거나 제거하여 기존 데이터를 수정합니다. 변경, 업데이트, 수정
확장(en) 원래 상태로 압축된 리소스의 데이터를 복원합니다. 이 동사는 Compress. 폭발, 압축 해제
내보내기(ep) 기본 입력을 파일과 같은 영구 데이터 저장소 또는 교환 형식으로 캡슐화합니다. 이 동사는 Import. 추출, 백업
그룹(gp) 하나 이상의 리소스를 정렬하거나 연결합니다.
가져오기(ip) 영구 데이터 저장소(예: 파일) 또는 교환 형식으로 저장된 데이터에서 리소스를 만듭니다. 예를 들어 Import-Csv cmdlet은 CSV(쉼표로 구분된 값) 파일에서 다른 cmdlet에서 사용할 수 있는 개체로 데이터를 가져옵니다. 이 동사는 Export. BulkLoad, Load
초기화(in) 사용할 리소스를 준비하고 기본 상태로 설정합니다. 지우기, 초기화, 갱신, 다시 빌드, 다시 초기화, 설정
제한(l) 리소스에 제약 조건을 적용합니다. 할당량
병합(mg) 여러 리소스에서 단일 리소스를 만듭니다. 결합, 조인
마운트(mt) 명명된 엔터티를 위치에 연결합니다. 이 동사는 Dismount. 연결
Out(o) 환경에서 데이터를 보냅니다. 예를 들어 Out-Printer cmdlet은 데이터를 프린터로 보냅니다.
게시(pb) 다른 사용자가 리소스를 사용할 수 있도록 합니다. 이 동사는 Unpublish. 배포, 릴리스, 설치
복원(rr) 리소스를 Checkpoint설정된 상태와 같이 미리 정의된 상태로 설정합니다. 예를 들어 Restore-Computer cmdlet은 로컬 컴퓨터에서 시스템 복원을 시작합니다. 복구, 반환, 실행 취소, 수정
저장(sv) 손실을 방지하기 위해 데이터를 유지합니다.
동기화(sy) 둘 이상의 리소스가 동일한 상태에 있는지 확인합니다. 복제, 강제 변환, 일치
게시 취소(ub) 다른 사용자가 리소스를 사용할 수 없게 만듭니다. 이 동사는 Publish. 제거, 되돌리기, 숨기기
업데이트(ud) 상태, 정확도, 규칙 또는 규정 준수를 유지하기 위해 리소스 up-to-date를 제공합니다. 예를 들어 Update-FormatData cmdlet은 현재 PowerShell 콘솔에 서식 파일을 업데이트하고 추가합니다. 새로 고침, 갱신, 다시 계산, 다시 인덱스

진단 동사

PowerShell은 System.Management.Automation.VerbsDiagnostic 클래스를 사용하여 진단에 적용되는 작업을 정의합니다. 다음 표에서는 정의된 대부분의 동사를 나열합니다.

동사(별칭) 조치 피해야 할 동의어
디버그(db) 리소스를 검사하여 운영 문제를 진단합니다. 진단하다
측정값(ms) 지정된 작업에서 사용되는 리소스를 식별하거나 리소스에 대한 통계를 검색합니다. 계산, 결정, 분석
Ping(pi) 사용되지 않음 - 테스트 동사를 대신 사용합니다.
복구(rp) 리소스를 사용 가능한 조건으로 복원합니다. 수정, 복원
해결(rv) 리소스의 약식 표현을 보다 완전한 표현으로 매핑합니다. 확장, 확인
테스트(t) 리소스의 작업 또는 일관성을 확인합니다. 진단, 분석, 인양, 확인
추적(tr) 리소스의 활동을 추적합니다. 추적, 팔로우, 검사, 발굴

수명 주기 동사

PowerShell은 System.Management.Automation.VerbsLifecycle 클래스를 사용하여 리소스의 수명 주기에 적용되는 작업을 정의합니다. 다음 표에서는 정의된 대부분의 동사를 나열합니다.

동사(별칭) 조치 피해야 할 동의어
승인(ap) 리소스 또는 프로세스의 상태를 확인하거나 동의합니다.
어설션(as) 리소스의 상태를 확인합니다. Certify
빌드(bd) 일부 입력 파일 집합(일반적으로 소스 코드 또는 선언적 문서)에서 아티팩트(일반적으로 이진 또는 문서)를 만듭니다. 이 동사는 PowerShell 6에 추가되었습니다.
완료(cp) 작업을 완료합니다.
확인(cn) 리소스 또는 프로세스의 상태를 확인, 확인 또는 유효성을 검사합니다. 승인, 동의, 인증, 유효성 검사, 확인
거부(dn) 리소스 또는 프로세스의 상태를 거부, 개체, 차단 또는 반대합니다. Block, Object, Reject, Reject
배포(dp) 배포가 완료된 후 해당 솔루션의 소비자가 액세스할 수 있는 방식으로 애플리케이션, 웹 사이트 또는 솔루션을 원격 대상에 보냅니다. 이 동사는 PowerShell 6에 추가되었습니다.
사용 안 함(d) 리소스를 사용할 수 없거나 비활성 상태로 구성합니다. 예를 들어 Disable-PSBreakpoint cmdlet은 중단점을 비활성 상태로 만듭니다. 이 동사는 Enable. 중지, 숨기기
사용(e) 리소스를 사용 가능 또는 활성 상태로 구성합니다. 예를 들어 Enable-PSBreakpoint cmdlet은 중단점을 활성으로 만듭니다. 이 동사는 Disable. 시작, 시작
설치(is) 위치에 리소스를 배치하고 필요에 따라 초기화합니다. 이 동사는 Uninstall. 설치
호출(i) 명령 또는 메서드 실행과 같은 작업을 수행합니다. 실행, 시작
등록(rg) 데이터베이스와 같은 리포지토리에서 리소스에 대한 항목을 만듭니다. 이 동사는 Unregister.
요청(rq) 리소스를 요청하거나 사용 권한을 요청합니다.
다시 시작(rt) 작업을 중지한 다음 다시 시작합니다. 예를 들어 Restart-Service cmdlet이 중지된 다음 서비스를 시작합니다. 재순환시키다
다시 시작(ru) 일시 중단된 작업을 시작합니다. 예를 들어 Resume-Service cmdlet은 일시 중단된 서비스를 시작합니다. 이 동사는 Suspend.
시작(sa) 작업을 시작합니다. 예를 들어 Start-Service cmdlet은 서비스를 시작합니다. 이 동사는 Stop. 시작, 시작, 부팅
중지(sp) 활동을 중단합니다. 이 동사는 Start. 종료, 종료, 종료, 취소
제출(sb) 승인을 위한 리소스를 제공합니다. 올리기
일시 중단(ss) 활동을 일시 중지합니다. 예를 들어 Suspend-Service cmdlet은 서비스를 일시 중지합니다. 이 동사는 Resume. 일시 중지
제거(당사) 지정된 위치에서 리소스를 제거합니다. 이 동사는 Install.
등록 취소(사용자) 리포지토리에서 리소스에 대한 항목을 제거합니다. 이 동사는 Register. 제거하십시오
대기(w) 지정된 이벤트가 발생할 때까지 작업을 일시 중지합니다. 예를 들어 Wait-Job cmdlet은 하나 이상의 백그라운드 작업이 완료될 때까지 작업을 일시 중지합니다. 절전 모드, 일시 중지

보안 동사

PowerShell은 System.Management.Automation.VerbsSecurity 클래스를 사용하여 보안에 적용되는 작업을 정의합니다. 다음 표에서는 정의된 대부분의 동사를 나열합니다.

동사(별칭) 조치 피해야 할 동의어
블록(bl) 리소스에 대한 액세스를 제한합니다. 이 동사는 Unblock. 방지, 제한, 거부
권한 부여(gr) 리소스에 대한 액세스를 허용합니다. 이 동사는 Revoke. 허용, 사용
보호(pt) 공격 또는 손실로부터 리소스를 보호합니다. 이 동사는 Unprotect. 암호화, 보호, 봉인
해지(rk) 리소스에 대한 액세스를 허용하지 않는 작업을 지정합니다. 이 동사는 Grant. 제거, 사용 안 함
차단 해제(ul) 리소스에 대한 제한을 제거합니다. 이 동사는 Block. 지우기, 허용
보호 해제(위쪽) 공격 또는 손실을 방지하기 위해 추가된 리소스에서 보호 장치를 제거합니다. 이 동사는 Protect. 암호 해독, 봉인 해제

기타 동사

PowerShell은 System.Management.Automation.VerbsOther 클래스를 사용하여 일반, 통신, 데이터, 수명 주기 또는 보안 동사 이름 동사와 같은 특정 동사 이름 범주에 맞지 않는 정식 동사 이름을 정의합니다.

동사(별칭) 조치 피해야 할 동의어
사용(u) 작업을 수행할 리소스를 사용하거나 포함합니다.

또한 참조하십시오

  • system.Management.Automation.VerbsCommon
  • System.Management.Automation.VerbsCommunications
  • System.Management.Automation.VerbsData
  • system.Management.Automation.VerbsDiagnostic
  • System.Management.Automation.VerbsLifecycle
  • System.Management.Automation.VerbsSecurity
  • System.Management.Automation.VerbsOther
  • Cmdlet 선언
  • Windows PowerShell 프로그래머 가이드
  • windows PowerShell Shell SDK