Rinominare il metodo della classe Win32_ComputerSystem
Il metodo Rename rinomina un computer.
In questo argomento viene utilizzata la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 Rename(
[in] string Name,
[in] string Password,
[in] string UserName
);
Parametri
-
Nome [in]
-
Nuovo nome computer. Il valore di questo parametro non può includere caratteri di controllo, spazi iniziali o finali o uno dei caratteri seguenti: / \\ [ ].
-
Password [in]
-
Password da utilizzare per la connessione al controller di dominio se il parametro UserName specifica un nome account. In caso contrario, questo parametro deve essere NULL. Per altre informazioni sui parametri Password e UserName , vedere la sezione Osservazioni di questo argomento.
-
UserName [in]
-
Stringa che specifica il nome dell'account da utilizzare per la connessione al controller di dominio. La stringa deve essere con terminazione Null e deve specificare un nome NetBIOS di dominio e un account utente, ad esempio "DOMAINNAME\username" o "someone@domainname.com", ovvero un nome dell'entità utente (UPN). Se il parametro UserName è NULL, WMI usa il contesto del chiamante. Per altre informazioni sui parametri Password e UserName , vedere la sezione Osservazioni di questo argomento.
Valore restituito
Restituisce un valore 0 (zero) se ha esito positivo. Un valore restituito diverso da zero indica un errore. In caso di esito positivo, è necessario un riavvio. Per altri codici di errore, vedere Costanti di errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.
-
Operazione riuscita (0)
-
Altro (1 4294967295)
Commenti
È possibile utilizzare il metodo Rename per rinominare un computer se si è membri del gruppo di amministratori locali. Tuttavia, non è possibile usare il metodo in remoto per i computer di dominio.
Se vengono specificati i parametri Password e UserName , la connessione a WMI deve usare il livello di autenticazione di RPC_C_AUTHN_LEVEL_PKT_PRIVACY (wbemAuthenticationLevelPktPrivacy per script e Visual Basic (VB).)
Per connettersi a un computer remoto e specificare le credenziali, usare la connessione all'oggetto localizzatore, ovvero IWbemLocator per C++, e SWbemLocator per script e VB. Non usare la connessione moniker.
Per connettersi a un computer locale, non è possibile specificare una password o un'autorità di autenticazione, ad esempio Kerberos. È possibile specificare solo la password e l'autorità nelle connessioni ai computer remoti.
Se il livello di autenticazione è troppo basso quando si specifica password eUserName , WMI restituisce l'errore di WBEM_E_ENCRYPTED_CONNECTION_REQUIRED per C/C++e wbemErrEncryptedConnectionRequired per script e VB.
Per altre informazioni, vedere SWbemLocator_ConnectServer,IWbemLocator::ConnectServer e Costruzione di una stringa moniker.
Esempio
Lo script seguente illustra come rinominare un computer locale.
Name = "name"
Password = "password"
Username = "username"
Set objWMIService = GetObject("Winmgmts:root\cimv2")
' Call always gets only one Win32_ComputerSystem object.
For Each objComputer in _
objWMIService.InstancesOf("Win32_ComputerSystem")
Return = objComputer.rename(Name,Password,Username)
If Return <> 0 Then
WScript.Echo "Rename failed. Error = " & Err.Number
Else
WScript.Echo "Rename succeeded." & _
" Reboot for new name to go into effect"
End If
Next
Nell'esempio di codice C++ seguente viene rinominato un sistema computer.
int set_computer_name(const string &newname/*, const string &username, const string &password*/)
{
HRESULT hres;
// Step 1: --------------------------------------------------
// Initialize COM. ------------------------------------------
hres = CoInitializeEx(0, COINIT_MULTITHREADED);
if (FAILED(hres))
{
cout << "Failed to initialize COM library. Error code = 0x"
<< hex << hres << endl;
return 1; // Program has failed.
}
// Step 2: --------------------------------------------------
// Set general COM security levels --------------------------
// Note: If you are using Windows 2000, you need to specify -
// the default authentication credentials for a user by using
// a SOLE_AUTHENTICATION_LIST structure in the pAuthList ----
// parameter of CoInitializeSecurity ------------------------
hres = CoInitializeSecurity(
NULL,
-1, // COM authentication
NULL, // Authentication services
NULL, // Reserved
RPC_C_AUTHN_LEVEL_DEFAULT, // Default authentication
RPC_C_IMP_LEVEL_IMPERSONATE, // Default Impersonation
NULL, // Authentication info
EOAC_NONE, // Additional capabilities
NULL // Reserved
);
if (FAILED(hres))
{
cout << "Failed to initialize security. Error code = 0x"
<< hex << hres << endl;
CoUninitialize();
return 1; // Program has failed.
}
// Step 3: ---------------------------------------------------
// Obtain the initial locator to WMI -------------------------
IWbemLocator *pLoc = NULL;
hres = CoCreateInstance(
CLSID_WbemLocator,
0,
CLSCTX_INPROC_SERVER,
IID_IWbemLocator, (LPVOID *) &pLoc);
if (FAILED(hres))
{
cout << "Failed to create IWbemLocator object."
<< " Err code = 0x"
<< hex << hres << endl;
CoUninitialize();
return 1; // Program has failed.
}
// Step 4: -----------------------------------------------------
// Connect to WMI through the IWbemLocator::ConnectServer method
IWbemServices *pSvc = NULL;
// Connect to the root\cimv2 namespace with
// the current user and obtain pointer pSvc
// to make IWbemServices calls.
hres = pLoc->ConnectServer(
_bstr_t(L"ROOT\\CIMV2"), // Object path of WMI namespace
NULL, // User name. NULL = current user
NULL, // User password. NULL = current
0, // Locale. NULL indicates current
NULL, // Security flags.
0, // Authority (e.g. Kerberos)
0, // Context object
&pSvc // pointer to IWbemServices proxy
);
if (FAILED(hres))
{
cout << "Could not connect. Error code = 0x"
<< hex << hres << endl;
pLoc->Release();
CoUninitialize();
return 1; // Program has failed.
}
/*cout << "Connected to ROOT\\CIMV2 WMI namespace" << endl;*/
// Step 5: --------------------------------------------------
// Set security levels on the proxy -------------------------
hres = CoSetProxyBlanket(
pSvc, // Indicates the proxy to set
RPC_C_AUTHN_WINNT, // RPC_C_AUTHN_xxx
RPC_C_AUTHZ_NONE, // RPC_C_AUTHZ_xxx
NULL, // Server principal name
RPC_C_AUTHN_LEVEL_CALL, // RPC_C_AUTHN_LEVEL_xxx
RPC_C_IMP_LEVEL_IMPERSONATE, // RPC_C_IMP_LEVEL_xxx
NULL, // client identity
EOAC_NONE // proxy capabilities
);
if (FAILED(hres))
{
cout << "Could not set proxy blanket. Error code = 0x"
<< hex << hres << endl;
pSvc->Release();
pLoc->Release();
CoUninitialize();
return 1; // Program has failed.
}
// Step 6: --------------------------------------------------
// Use the IWbemServices pointer to make requests of WMI ----
// For example, get the name of the operating system
IEnumWbemClassObject* pEnumerator = NULL;
hres = pSvc->ExecQuery(
bstr_t("WQL"),
bstr_t("SELECT * FROM Win32_ComputerSystem"),
WBEM_FLAG_FORWARD_ONLY | WBEM_FLAG_RETURN_IMMEDIATELY,
NULL,
&pEnumerator);
if (FAILED(hres))
{
cout << "Query for operating system name failed."
<< " Error code = 0x"
<< hex << hres << endl;
pSvc->Release();
pLoc->Release();
CoUninitialize();
return 1; // Program has failed.
}
// Step 7: -------------------------------------------------
// Get the data from the query in step 6 -------------------
IWbemClassObject *pclsObj;
ULONG uReturn = 0;
while (pEnumerator)
{
HRESULT hr = pEnumerator->Next(WBEM_INFINITE, 1,
&pclsObj, &uReturn);
if(0 == uReturn)
{
break;
}
// set up to call the Win32_ComputerSystem::Rename method
BSTR MethodName = SysAllocString(L"Rename");
BSTR ClassName = SysAllocString(L"Win32_ComputerSystem");
IWbemClassObject* pClass = NULL;
hres = pSvc->GetObject(ClassName, 0, NULL, &pClass, NULL);
IWbemClassObject* pInParamsDefinition = NULL;
hres = pClass->GetMethod(MethodName, 0,
&pInParamsDefinition, NULL);
IWbemClassObject* pClassInstance = NULL;
hres = pInParamsDefinition->SpawnInstance(0, &pClassInstance);
// Create the values for the in parameters
wstring val;
BSTR NewName;
val.assign(newname.begin(), newname.end());
NewName = SysAllocString(val.c_str());
VARIANT varName;
varName.vt = VT_BSTR;
varName.bstrVal = NewName;
// Store the value for the in parameters
hres = pClassInstance->Put(L"Name", 0,
&varName, 0);
wprintf(L"Set computer name to %s\n", V_BSTR(&varName));
VARIANT var;
CIMTYPE pType;
LONG pFlavor;
pclsObj->Get(L"__PATH",0,&var,&pType,&pFlavor);
// Execute Method
IWbemClassObject* pOutParams = NULL;
hres = pSvc->ExecMethod(var.bstrVal, MethodName, 0,
NULL, pClassInstance, &pOutParams, NULL);
if (FAILED(hres))
{
cout << "Could not execute method. Error code = 0x"
<< hex << hres << endl;
VariantClear(&varName);
SysFreeString(ClassName);
SysFreeString(MethodName);
SysFreeString(NewName);
pClass->Release();
pInParamsDefinition->Release();
pOutParams->Release();
return 1; // Program has failed.
}
// To see what the method returned,
// use the following code. The return value will
// be in &varReturnValue
VARIANT varReturnValue;
hres = pOutParams->Get(_bstr_t(L"ReturnValue"), 0,
&varReturnValue, NULL, 0);
// Clean up
//--------------------------
VariantClear(&varName);
VariantClear(&varReturnValue);
SysFreeString(ClassName);
SysFreeString(MethodName);
SysFreeString(NewName);
pClass->Release();
pInParamsDefinition->Release();
pOutParams->Release();
return 0;
}
// Cleanup
// ========
pSvc->Release();
pLoc->Release();
pEnumerator->Release();
pclsObj->Release();
CoUninitialize();
return 0; // Program successfully completed.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per