개요
어댑터, 팀 또는 VLAN 설정 변경
새 (빈) 팀 만들기
팀에 어댑터 추가
팀에서 어댑터 제거
팀 삭제
팀 모드 변경
팀 내의 어댑터 우선 순위 변경
어댑터 제거
VLAN 만들기
VLAN 속성 변경
VLAN 삭제
Boot Agent 업데이트
대부분의 경우 구성을 업데이트하려면 클라이언트 응용 프로그램에서 IANet_NetService 클래스의 세션 핸들을 가져와서 IWbemContext 컨텍스트 객체에 저장해야 합니다. 구성 변경은 IANet_NetService에서 Apply 메서드가 호출될 때만 발생합니다. 이 요구 사항에는 다음 몇 가지 예외가 따릅니다.
일부 작업의 경우 컨텍스트에서 PreCheck 한정자를 사용하여 해당 작업이 허용되는지 확인할 수 있습니다. 이는 필요한 경우 사용자 인터페이스에서 특정 컨트롤이나 메뉴 항목을 비활성화할 수 있도록 하기 위한 것입니다.
어댑터, 팀 또는 VLAN을 변경할 경우
어댑터, VLAN 또는 팀 설정을 변경하려면 먼저 클라이언트가 변경할 설정의 객체 경로를 가져와야 합니다. 객체의 설정을 열거한 다음 해당 설정의 __PATH 속성을 저장하는 것이 이 작업에 가장 좋은 방법입니다(위 내용 참조).
클라이언트가 가장 쉽게 설정을 업데이트할 수 있는 방법은 다음과 같습니다.
WMI Provider는 CurrentValue를 검증하고 검증이 실패한 경우 WBEM_E_FAIL을 반환합니다. 정확한 실패 이유는 IANet_ExtendedStatus 객체의 Description 속성에서 반환됩니다.
설정별 설명은 다음을 포함합니다.
마지막 설명은 IANet_SettingEnum, IANet_SettingSlider 또는 IANet_SettingMultiSelection의 현재 값이 허용되는 값 중 하나가 아닐 때 반환됩니다.
클라이언트가 변경할 수 있는 설정의 속성은 CurrentValue뿐입니다. WMI Provider는 다른 모든 값의 변경 사항을 무시합니다.
설정 클래스에 대해 지원되는 메서드가 없습니다. 설정을 변경하려면 CurrentValue 속성을 수정하고 PutInstance를 호출하십시오.
새 팀을 만들려면 IANet_TeamOfAdapters 인스턴스를 만드십시오. 즉, IWbemServices::GetObject()를 사용하여 IANet_TeamOfAdapters의 클래스 객체를 가져온 다음 IWbemServices::SpawnInstance()를 사용하여 이 객체의 인스턴스를 만드십시오.
그런 다음 IWbemClassObject::Put을 사용하여 인스턴스의 TeamMode 속성을 원하는 팀 유형(예: AFT)으로 설정하십시오. 마지막으로 IWbemServices::PutInstance()를 호출하여 팀을 만들면서 WBEM_FLAG_CREATE_ONLY 플래그를 전달하십시오.
새 팀의 객체 경로는 호출 완료 시 다시 전달되는 IWbemCallResultObject에 저장됩니다. IWbemCallResult::GetResultString 메서드는 새 객체 경로를 가져옵니다.
이 작업이 실패한 경우 클라이언트는 IANet_ExtendedStatus를 검사하여 실패 이유를 확인해야 합니다.
팀의 가상 IANet_EthernetAdapter 및 IANet_IPProtocolEndpoint 클래스는 Apply를 호출한 후에야 사용할 수 있습니다. 새 IANet_TeamOfAdapters와 연관된 IANet_Configuration 객체를 사용하여 팀 설정에 액세스할 수 있습니다.
팀에 어댑터를 추가할 경우
팀에 어댑터를 추가하려면 IANet_TeamedMemberAdapter 인스턴스를 만드십시오. 즉, IWbemServices::GetObject()를 사용하여 IANet_TeamedMemberAdapter의 클래스 객체를 가져온 다음 IWbemServices::SpawnInstance()를 사용하여 이 객체의 인스턴스를 만드십시오.
IWbemClassObject::Put()을 사용하여 객체의 다음 속성을 설정해야 합니다.
팀 내의 어댑터 우선 순위도 설정할 수 있습니다. 마지막으로, IWbemServices::PutInstance()를 호출하여 팀에 어댑터를 추가하여 WBEM_FLAG_CREATE_ONLY 플래그를 전달하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.
팀에서 어댑터를 제거할 경우
팀에서 어댑터를 제거하려면 IWbemServices::DeleteInstance()를 사용하여 어댑터를 팀에 연관시키는 IANet_TeamedMemberAdapter 인스턴스를 삭제하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.
팀을 삭제할 경우
팀을 삭제하려면 IWbemServices::DeleteInstance()를 사용하여 IANet_TeamOfAdapters 인스턴스를 삭제하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.
팀 모드를 변경할 경우
팀 모드를 변경하려면 팀의 IANet_TeamOfAdapters 인스턴스를 가져오십시오. 예를 들어, 팀의 객체 경로를 사용하는 IWbemServices::GetObject를 사용하십시오. 그런 다음 IWbemClassObject::Put을 사용하여 팀의 TeamMode 속성을 변경하십시오. 마지막으로, IWbemClassObject:: PutInstance를 호출하여 팀 모드를 변경하여 WBEM_FLAG_UPDATE_ONLY 플래그를 전달하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.
팀 내의 어댑터 우선 순위를 변경할 경우
어댑터 우선 순위를 변경하려면 먼저 클라이언트가 어댑터의 IANet_TeamedMemberAdapter 인스턴스를 가져와야 합니다. 예를 들어, 객체 경로를 사용하는 IWbemServices::GetObject를 사용하십시오. 그런 다음 클라이언트가 IWbemClassObject::Put을 사용하여 어댑터의 AdapterFunction 속성을 변경할 수 있습니다. 마지막으로 클라이언트가 IWbemClassObject:: PutInstance를 호출하여 어댑터 우선 순위를 업데이트해야 합니다. 이 작업이 실패한 경우 클라이언트는 IANet_ExtendedStatus에서 오류 코드를 검사해야 합니다.
어댑터를 제거할 경우
어댑터를 제거하려면 IWbemServices::DeleteInstance를 호출하여 제거할 어댑터의 객체 경로를 전달하십시오.
VLAN을 만들 경우
VLAN을 만들려면 VLAN이 추가될 어댑터의 IANet_802dot1QVLANService에서 CreateVLAN 메서드를 호출하십시오. 다음 인수를 메서드에 전달해야 합니다.
이 함수는 출력 매개변수 VLANpath에서 새로 만든 VLAN의 객체 경로를 반환합니다. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.
VLAN 속성을 변경할 경우
클라이언트는 VLAN의 VLANNumber 및 VLANName 속성을 변경할 수 있습니다. 어댑터 우선 순위를 변경하려면 먼저 어댑터의 IANet_VLAN 인스턴스를 가져오십시오. 예를 들어, 객체 경로를 사용하는 IWbemServices::GetObject를 사용하십시오.
그런 다음 VLANNumber 또는 VLANName을 원하는 값으로 변경하십시오. 마지막으로 IWbemClassObject:: PutInstance를 호출하여 속성을 업데이트하여 WBEM_FLAG_UPDATE_ONLY 플래그를 전달하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.
VLAN을 삭제할 경우
VLAN을 삭제하려면 IWbemServices::DeleteInstance를 호출하여 삭제할 VLAN의 객체 경로를 전달하십시오.
Boot Agent를 업데이트할 경우
클라이언트는 메서드 호출을 사용하여 Boot Agent 이미지를 업데이트할 수 있습니다. 플래시 이미지를 읽거나 쓰려면 먼저 어댑터의 IANet_BootAgent 인스턴스를 가져오십시오. 예를 들어, 객체 경로를 사용하는 IWbemServices::GetObject를 사용하십시오.
그런 다음 ReadFlash()를 실행하여 기존 플래시 부트 ROM 이미지를 읽거나 ProgramFlash()를 실행하여 플래시 부트 ROM 이미지를 업데이트하십시오. 이 작업이 실패한 경우 IANet_ExtendedStatus에서 오류 코드를 검사하십시오.
| 작업 | WMI 메서드 | 결과 | 설명 |
| 어댑터의 부트 ROM 이미지 업데이트 또는 삽입 | uint32 ProgramFlash( [IN, ValueMap {"0","1"} , Values {"Check Version", "Write Flash"}: Amended ] uint32 Action, [IN] uint8 NewFlashData[], [OUT] string strErrorMessage ); |
'버전 검사' 작업이 지정된 경우 NewFlashData[]에서 업데이트 중인 부트 ROM 이미지가 이미 NIC에 있는 이미지보다 오래된 것이면 경고 메시지가 반환됩니다. '쓰기' 작업이 지정된 경우에는 NIC에 있는 플래시 ROM이 NewFlashData[]로 업데이트됩니다. |
이 메서드는 NIC에서 플래시 ROM을 업데이트하는 데 사용됩니다. 이 메서드를 사용하면 플래시가 업데이트되는 동안 NIC와 네트워크 간의 통신이 중지됩니다. |
| 부트 ROM 이미지 읽기 | uint32 ReadFlash( [OUT] uint8 FlashData[] ); |
FlashData[]는 NIC에 있는 플래시 ROM 이미지를 포함합니다. | 이 메서드는 NIC에 있는 플래시 ROM(파일에 저장할 수 있음)을 읽습니다. |
제한 및 책임 부인을 자세히 읽어보십시오.