다음을 통해 공유

Set-CimInstance

  • 참조
모듈:
CimCmdlets

CIM 클래스의 ModifyInstance 메서드를 호출하여 CIM 서버에서 CIM 인스턴스를 수정합니다.

구문

Set-CimInstance
   [-ComputerName <String[]>]
   [-ResourceUri <Uri>]
   [-OperationTimeoutSec <UInt32>]
   [-InputObject] <CimInstance>
   [-Property <IDictionary>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CimInstance
   -CimSession <CimSession[]>
   [-ResourceUri <Uri>]
   [-OperationTimeoutSec <UInt32>]
   [-InputObject] <CimInstance>
   [-Property <IDictionary>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CimInstance
   -CimSession <CimSession[]>
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-Query] <String>
   [-QueryDialect <String>]
   -Property <IDictionary>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CimInstance
   [-ComputerName <String[]>]
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-Query] <String>
   [-QueryDialect <String>]
   -Property <IDictionary>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

이 cmdlet은 CIM 서버에서 CIM 인스턴스를 수정합니다.

InputObject 매개 변수를 지정하지 않은 경우 cmdlet은 다음 방법 중 하나로 작동합니다.

  • ComputerName 매개 변수와 CimSession 매개 변수가 모두 지정되지 않은 경우 이 cmdlet은 COM(구성 요소 개체 모델) 세션을 사용하여 로컬 WMI(Windows Management Instrumentation)에서 작동합니다.
  • ComputerName 매개 변수 또는 CimSession 매개 변수가 지정된 경우 이 cmdlet은 ComputerName 매개 변수 또는 CimSession 매개 변수로 지정된 CIM 서버에 대해 작동합니다.

InputObject 매개 변수가 지정된 경우 cmdlet은 다음 방법 중 하나로 작동합니다.

  • ComputerName 매개 변수나 CimSession 매개 변수를 지정하지 않은 경우 이 cmdlet은 입력 개체의 CIM 세션 또는 컴퓨터 이름을 사용합니다.
  • ComputerName 매개 변수 또는 CimSession 매개 변수가 지정된 경우 이 cmdlet은 CimSession 매개 변수 값 또는 ComputerName 매개 변수 값을 사용합니다. 이것은 매우 일반적이지 않습니다.

예제

예제 1: CIM 인스턴스 설정

다음은 Query 매개 변수를 사용하여 VariableValue 속성의 값을 abcd로 설정하는 예제입니다. WQL(Windows Management Instrumentation Query Language) 쿼리와 일치하는 인스턴스를 수정할 수 있습니다.

Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"}

예제 2: 파이프라인을 사용하여 CIM 인스턴스 속성 설정

이 예제에서는 cmdlet을 사용하여 Query 매개 변수로 필터링된 CIM 인스턴스 개체를 Get-CimInstance 검색합니다. cmdlet은 Set-CimInstance VariableValue 속성 값을 abcd로 수정합니다.

Get-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' |
  Set-CimInstance -Property @{VariableValue="abcd"}

예제 3: 입력 개체를 사용하여 CIM 인스턴스 속성 설정

$x = Get-CimInstance -Query 'Select * from Win32_Environment where Name="testvar"'
Set-CimInstance -InputObject $x -Property @{VariableValue="somevalue"} -PassThru

이 예제에서는 쿼리 매개 변수로 필터링된 CIM 인스턴스 개체를 사용하여 Get-CimInstance변수 $x 로 검색한 다음 변수의 내용을 cmdlet에 Set-CimInstance 전달합니다. Set-CimInstance그런 다음 VariableValue 속성을 somevalue로 수정합니다. PassThru 매개 변수가 사용되므로 이 예제에서는 수정된 CIM 인스턴스 개체를 반환합니다.

예제 4: CIM 인스턴스 속성 설정

다음은 Query 매개 변수에 지정된 CIM 인스턴스 개체를 cmdlet을 사용하여 Get-CimInstance 변수 $x 로 검색하고 개체의 VariableValue 속성 값을 변경하여 변경하는 예제입니다. CIM 인스턴스 개체는 cmdlet을 Set-CimInstance 사용하여 저장됩니다. PassThru 매개 변수가 사용되므로 이 예제에서는 수정된 CIM 인스턴스 개체를 반환합니다.

$x = Get-CimInstance -Query 'Select * from Win32_Environment where name="testvar"'
$x.VariableValue = "Change"
Set-CimInstance -CimInstance $x -PassThru

예제 5: WhatIf를 사용하여 수정할 CIM 인스턴스 목록 표시

이 예제에서는 일반 매개 변수 WhatIf 를 사용하여 수정을 수행하지 않도록 지정하지만, 수행된 경우 발생하는 작업만 출력합니다.

Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -WhatIf

예제 6: 사용자의 확인 후 CIM 인스턴스 설정

이 예제에서는 일반 매개 변수 Confirm 를 사용하여 사용자의 확인 후에만 수정을 수행하도록 지정합니다.

Set-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"' -Property @{VariableValue="abcd"} -Confirm

예제 7: 만든 CIM 인스턴스 설정

다음은 cmdlet을 사용하여 지정된 속성을 사용하여 CIM 인스턴스를 New-CimInstance 만들고 해당 내용을 변수 $x로 검색하는 예제입니다. 그런 다음 변수가 cmdlet에 Set-CimInstance 전달되어 VariableValue 속성 값을 somevalue로 수정합니다. PassThru 매개 변수가 사용되므로 이 예제에서는 수정된 CIM 인스턴스 개체를 반환합니다.

$x = New-CimInstance -ClassName Win32_Environment -Property @{Name="testvar";UserName="domain\user"} -Key Name,UserName -ClientOnly
Set-CimInstance -CimInstance $x -Property @{VariableValue="somevalue"} -PassThru

매개 변수

-CimSession

원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름 또는 세션 개체(예: a 또는 Get-CimSession cmdlet의 출력)를 New-CimSession 입력합니다.

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

-ComputerName

CIM 작업을 실행할 컴퓨터의 이름을 지정합니다. FQDN(정규화된 도메인 이름) 또는 NetBIOS 이름을 지정할 수 있습니다.

이 매개 변수를 지정하지 않으면 cmdlet은 COM(구성 요소 개체 모델)을 사용하여 로컬 컴퓨터에서 작업을 수행합니다.

이 매개 변수를 지정하는 경우 cmdlet은 WsMan 프로토콜을 사용하여 지정된 컴퓨터에 임시 세션을 만듭니다.

동일한 컴퓨터에서 여러 작업을 수행하는 경우 CIM 세션을 사용하여 연결하면 성능이 향상됩니다.

형식:String[]
별칭:CN, ServerName
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

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

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

-InputObject

입력으로 사용할 CIM 인스턴스 개체를 지정합니다.

InputObject 매개 변수는 컬렉션에 대해 열거되지 않습니다. 컬렉션이 전달되면 오류가 throw됩니다. 컬렉션을 사용할 때 입력을 파이프하여 값을 열거합니다.

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

-Namespace

CIM 작업의 네임스페이스를 지정합니다. 기본 네임스페이스는 root/cimv2입니다. PowerShell은 네임스페이스 목록을 제공하기 위해 로컬 WMI 서버에서 네임스페이스 목록을 가져오므로 탭 완성을 사용하여 네임스페이스 목록을 찾아볼 수 있습니다.

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

-OperationTimeoutSec

cmdlet이 컴퓨터의 응답을 기다리는 시간을 지정합니다. 기본적으로 이 매개 변수의 값은 0입니다. 즉, cmdlet은 서버에 대한 기본 시간 제한 값을 사용합니다.

OperationTimeoutSec 매개 변수가 3분의 강력한 연결 재시도 시간 제한보다 작은 값으로 설정된 경우 클라이언트가 다시 연결하기 전에 서버의 작업이 시간 초과되므로 OperationTimeoutSec 매개 변수 값보다 더 많이 지속되는 네트워크 오류는 복구할 수 없습니다.

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

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

-Property

CIM 인스턴스의 속성을 해시 테이블로 지정합니다(이름-값 쌍 사용). 이 매개 변수를 사용하여 지정된 속성만 변경됩니다. CIM 인스턴스의 다른 속성은 변경되지 않습니다.

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

-Query

cmdlet을 실행할 CIM 인스턴스를 검색하기 위해 CIM 서버에서 실행할 쿼리를 지정합니다. QueryDialect 매개 변수를 사용하여 쿼리 방언을 지정할 수 있습니다.

지정된 값에 큰따옴표("), 작은따옴표(') 또는 백슬래시(\)가 포함된 경우 백슬래시(\) 문자로 접두사를 지정하여 해당 문자를 이스케이프해야 합니다. 지정된 값이 WQL LIKE 연산자를 사용하는 경우 다음 문자를 대괄호(%) (), 밑_줄(%) 또는 여는 대괄호([][)로 묶어 이스케이프해야 합니다.

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

-QueryDialect

쿼리 매개 변수에 사용되는 쿼리 언어를 지정합니다. 이 매개 변수에 허용되는 값은 WQL 또는 CQL입니다. 기본값은 WQL입니다.

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

-ResourceUri

리소스 클래스 또는 인스턴스의 리소스 URI(Uniform Resource Identifier)를 지정합니다. URI는 컴퓨터에서 디스크 또는 프로세스와 같은 특정 유형의 리소스를 식별하는 데 사용됩니다.

URI는 접두사와 리소스 경로로 구성됩니다. 예시:

  • http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
  • http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

기본적으로 이 매개 변수를 지정하지 않으면 DMTF 표준 리소스 URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ 가 사용되고 클래스 이름이 추가됩니다.

ResourceURI는 WSMan 프로토콜을 사용하여 만든 CIM 세션이나 WSMan을 사용하여 CIM 세션을 만드는 ComputerName 매개 변수를 지정할 때만 사용할 수 있습니다. ComputerName 매개 변수를 지정하지 않고 이 매개 변수를 지정하거나 DCOM 프로토콜을 사용하여 만든 CIM 세션을 지정하는 경우 DCOM 프로토콜이 ResourceURI 매개 변수를 지원하지 않으므로 오류가 발생합니다.

ResourceUri 매개 변수와 Filter 매개 변수를 모두 지정하면 Filter 매개 변수가 무시됩니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

CimInstance

출력

None

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

CimInstance

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 수정된 CIM 인스턴스 개체를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Set-CimInstance

  • Windows:
    • scim

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.