Leggere in inglese

Condividi tramite


Gestione remota Windows

Panoramica della tecnologia Gestione remota Windows.

Per sviluppare Gestione remota Windows, sono necessarie queste intestazioni:

Per indicazioni sulla programmazione per questa tecnologia, vedere:

Enumerazioni

 
WSManAuthenticationFlags

Determina il metodo di autenticazione per l'operazione.
WSManCallbackFlags

Definisce un set di flag utilizzati da tutte le funzioni di callback.
WSManDataType

Specifica il tipo di dati corrente dell'unione nella struttura WSMAN_DATA.
WSManProxyAccessType

Definisce il tipo di accesso proxy.
WSManProxyAccessTypeFlags

Definisce i flag del tipo di accesso proxy.
WSManProxyAuthenticationFlags

Determina il meccanismo di autenticazione proxy.
WSManSessionOption

Definisce un set di opzioni estese per la sessione. Queste opzioni vengono usate con il metodo WSManSetSessionOption.

Funzioni

 
AddOption

Aggiunge i dati necessari per elaborare la richiesta. Ad esempio, alcuni provider WMI possono richiedere un oggetto IWbemContext o SWbemNamedValueSet con informazioni specifiche del provider.
AddSelector

Aggiunge un selettore all'oggetto ResourceLocator. Il selettore specifica una particolare istanza di una risorsa.
ClearOptions

Rimuove tutte le opzioni dall'oggetto ResourceLocator.
ClearSelectors

Rimuove tutti i selettori da un oggetto ResourceLocator. È possibile specificare un oggetto ResourceLocator anziché specificare un URI di risorsa nelle operazioni sugli oggetti IWSManSession, ad esempio Get, Put o Enumerate.
Creare

Crea una nuova istanza di una risorsa e restituisce il riferimento all'endpoint (EPR) del nuovo oggetto.
CreateConnectionOptions

Crea un oggetto IWSManConnectionOptions che specifica il nome utente e la password utilizzati durante la creazione di una sessione.
CreateResourceLocator

Crea un oggetto ResourceLocator che può essere utilizzato invece di un URI di risorsa nelle operazioni dell'oggetto Session, ad esempio IWSManSession.Get, IWSManSession.Put o Session.Enumerate.
CreateSession

Crea un oggetto Session che può quindi essere utilizzato per le operazioni di rete successive.
Elimina

Elimina la risorsa specificata nell'URI della risorsa.
Enumerazione

Enumera una tabella, una raccolta di dati o una risorsa di log.
EnumerationFlagHierarchyDeep

Restituisce il valore della costante di enumerazione EnumerationFlagHierarchyDeep da utilizzare nel parametro flags del metodo IWSManSession::Enumerate.
EnumerationFlagHierarchyDeepBasePropsOnly

Restituisce il valore della costante di enumerazione EnumerationFlagHierarchyDeepBasePropsOnly da utilizzare nel parametro flags del metodo IWSManSession::Enumerate.
EnumerationFlagHierarchyShallow

Restituisce il valore della costante di enumerazione EnumerationFlagHierarchyShallow da utilizzare nel parametro flags del metodo IWSManSession::Enumerate.
EnumerationFlagNonXmlText

Restituisce il valore della costante di enumerazione WSManFlagNonXmlText da utilizzare nel parametro flags del metodo IWSManSession::Enumerate.
EnumerationFlagReturnEPR

Restituisce il valore della costante di enumerazione EnumerationFlagReturnEPR da utilizzare nel parametro flags del metodo IWSManSession::Enumerate.
EnumerationFlagReturnObject

Restituisce il valore della costante di enumerazione EnumerationFlagReturnObject da utilizzare nel parametro flags del metodo IWSManSession::Enumerate.
EnumerationFlagReturnObjectAndEPR

Restituisce il valore della costante di enumerazione EnumerationFlagReturnObjectAndEPR da utilizzare nel parametro flags del metodo IWSManSession::Enumerate.
Recupero

Recupera la risorsa specificata dall'URI e restituisce una rappresentazione XML dell'istanza corrente della risorsa.
get_AtEndOfStream

Indica che la fine degli elementi nell'oggetto IWSManEnumerator è stata raggiunta dalle chiamate a IWSManEnumerator::ReadItem.
get_BatchItems

Imposta e ottiene il numero di elementi in ogni batch di enumerazione. (Get)
get_CertificateThumbprint

Imposta o ottiene l'identificazione personale del certificato da usare per l'autenticazione tramite l'autenticazione del certificato client. (Get)
get_CommandLine

Ottiene la riga di comando del processo che carica il componente di automazione.
get_Error

Ottiene informazioni aggiuntive sull'errore, in un flusso XML, per la chiamata precedente a un metodo IWSMan se il servizio Gestione remota Windows non è riuscito a creare un oggetto IWSManSession, un oggetto IWSManConnectionOptions o un oggetto IWSManResourceLocator.
get_Error

Ottiene una rappresentazione XML di informazioni aggiuntive sull'errore. (IWSManEnumerator.get_Error)
get_Error

Ottiene una rappresentazione XML di informazioni aggiuntive sull'errore. (IWSManResourceLocator.get_Error)
get_Error

Ottiene informazioni aggiuntive sull'errore in un flusso XML per la chiamata precedente a un metodo di oggetto IWSManSession.
get_FragmentDialect

Ottiene o imposta il dialetto linguistico per un dialetto del frammento di risorse quando IWSManResourceLocator viene utilizzato nei metodi di oggetto IWSManSession, ad esempio Get, Put o Enumerate. (Get)
get_FragmentPath

Ottiene o imposta il percorso di un frammento di risorsa o di una proprietà quando ResourceLocator viene utilizzato nei metodi dell'oggetto IWSManSession, ad esempio Get, Put o Enumerate. (Get)
get_MustUnderstandOptions

Ottiene o imposta il valore MustUnderstandOptions per l'oggetto ResourceLocator. (Get)
get_ResourceURI

URI della risorsa richiesta. Questa proprietà può contenere solo il percorso, non una stringa di query per istanze specifiche. (Get)
get_Timeout

Imposta e ottiene la quantità massima di tempo, in millisecondi, che l'applicazione client attende il completamento delle operazioni da parte dell'applicazione client. (Get)
get_UserName

Imposta e ottiene il nome utente di un account locale o di un account di dominio nel computer remoto. Questa proprietà determina il nome utente per l'autenticazione. (Get)
GetErrorMessage

Restituisce una stringa formattata contenente il testo di un numero di errore.
Identificare

Esegue query su un computer remoto per determinare se supporta il protocollo di WS-Management.
Invoke

Richiama un metodo e restituisce i risultati della chiamata del metodo.
ProxyAuthenticationUseBasic

Restituisce il valore del flag di autenticazione proxy WSManFlagProxyAuthenticationUseBasic da usare nel parametro authenticationMechanism del metodo IWSManConnectionOptionsEx2::SetProxy.
ProxyAuthenticationUseDigest

Restituisce il valore del flag di autenticazione proxy WSManFlagProxyAuthenticationUseDigest da usare nel parametro authenticationMechanism del metodo IWSManConnectionOptionsEx2::SetProxy.
ProxyAuthenticationUseNegotiate

Restituisce il valore del flag di autenticazione proxy WSManFlagProxyAuthenticationUseNegotiate per l'uso nel parametro authenticationMechanism del metodo IWSManConnectionOptionsEx2::SetProxy.
ProxyAutoDetect

Restituisce il valore del flag di tipo di accesso proxy WSManProxyAutoDetect da usare nel parametro accessType del metodo IWSManConnectionOptionsEx2::SetProxy.
ProxyIEConfig

Restituisce il valore del flag di tipo di accesso proxy WSManProxyIEConfig da usare nel parametro accessType del metodo IWSManConnectionOptionsEx2::SetProxy.
ProxyNoProxyServer

Restituisce il valore del flag del tipo di accesso proxy WSManProxyNoProxyServer da usare nel parametro accessType del metodo IWSManConnectionOptionsEx2::SetProxy.
ProxyWinHttpConfig

Restituisce il valore del flag di tipo di accesso proxy WSManProxyWinHttpConfig da usare nel parametro accessType del metodo IWSManConnectionOptionsEx2::SetProxy.
Mettere

Aggiorna una risorsa.
put_BatchItems

Imposta e ottiene il numero di elementi in ogni batch di enumerazione. (Put)
put_CertificateThumbprint

Imposta o ottiene l'identificazione personale del certificato da usare durante l'autenticazione tramite l'autenticazione del certificato client. (Put)
put_FragmentDialect

Ottiene o imposta il dialetto della lingua per un dialetto del frammento di risorse quando IWSManResourceLocator viene usato nei metodi degli oggetti IWSManSession, ad esempio Get, Put o Enumerate. (Put)
put_FragmentPath

Ottiene o imposta il percorso per un frammento di risorsa o una proprietà quando ResourceLocator viene usato nei metodi dell'oggetto IWSManSession, ad esempio Get, Put o Enumerate. (Put)
put_MustUnderstandOptions

Ottiene o imposta il valore MustUnderstandOptions per l'oggetto ResourceLocator. (Put)
put_Password

Imposta la password di un account locale o di un dominio nel computer remoto.
put_ResourceURI

URI della risorsa richiesta. Questa proprietà può contenere solo il percorso, non una stringa di query per istanze specifiche. (Put)
put_Timeout

Imposta e ottiene la quantità massima di tempo, in millisecondi, che l'applicazione client attende il completamento delle operazioni da parte dell'applicazione client. (Put)
put_UserName

Imposta e ottiene il nome utente di un account locale o di un account di dominio nel computer remoto. Questa proprietà determina il nome utente per l'autenticazione. (Put)
ReadItem

Recupera un elemento dalla risorsa e restituisce una rappresentazione XML dell'elemento.
SessionFlagCredUsernamePassword

Restituisce il valore del flag di autenticazione WSManFlagCredUsernamePassword da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagEnableSPNServerPort

Restituisce il valore del flag di autenticazione WSManFlagEnableSPNServerPort da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagNoEncryption

Restituisce il valore del flag di autenticazione WSManFlagNoEncryption da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagSkipCACheck

Restituisce il valore del flag di autenticazione WSManFlagSkipCACheck da usare nel parametro flag del metodo IWSMan::CreateSession.
SessionFlagSkipCNCheck

Restituisce il valore del flag di autenticazione WSManFlagSkipCNCheck da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagUseBasic

Restituisce il valore del flag di autenticazione WSManFlagUseBasic da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagUseClientCertificate

Restituisce il valore del flag di autenticazione WSManFlagUseClientCertificate da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagUseCredSsp

Restituisce il valore del flag di autenticazione WSManFlagUseCredSsp da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagUseDigest

Restituisce il valore del flag di autenticazione WSManFlagUseDigest da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagUseKerberos

Restituisce il valore del flag di autenticazione WSManFlagUseKerberos da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagUseNegotiate

Restituisce il valore del flag di autenticazione WSManFlagUseNegotiate da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagUseNoAuthentication

Restituisce il valore del flag di autenticazione WSManFlagUseNoAuthentication da usare nel parametro flag di IWSMan::CreateSession.
SessionFlagUTF8

Restituisce il valore del flag di autenticazione WSManFlagUTF8 da usare nel parametro flag di IWSMan::CreateSession.
SetProxy

Imposta le informazioni del proxy per la sessione.
WSMAN_PLUGIN_AUTHORIZE_OPERATION

Autorizza un'operazione specifica.
WSMAN_PLUGIN_AUTHORIZE_QUERY_QUOTA

Recupera le informazioni sulla quota per l'utente dopo l'autorizzazione di una connessione.
WSMAN_PLUGIN_AUTHORIZE_RELEASE_CONTEXT

Rilascia il contesto in cui un plug-in segnala da WSManPluginAuthzUserComplete o WSManPluginAuthzOperationComplete.
WSMAN_PLUGIN_AUTHORIZE_USER

Autorizza una connessione.
WSMAN_PLUGIN_COMMAND

Definisce il callback del comando per un plug-in.
WSMAN_PLUGIN_CONNECT

Definisce il callback di connessione per un plug-in.
WSMAN_PLUGIN_RECEIVE

Definisce il callback di ricezione per un plug-in.
WSMAN_PLUGIN_RELEASE_COMMAND_CONTEXT

Definisce il callback del comando di rilascio per il plug-in.
WSMAN_PLUGIN_RELEASE_SHELL_CONTEXT

Definisce il callback della shell di versione per il plug-in.
WSMAN_PLUGIN_SEND

Definisce il callback di invio per un plug-in.
WSMAN_PLUGIN_SHELL

Definisce il callback della shell per un plug-in.
WSMAN_PLUGIN_SHUTDOWN

Definisce il callback di arresto per il plug-in.
WSMAN_PLUGIN_SIGNAL

Definisce il callback del segnale per un plug-in.
WSMAN_PLUGIN_STARTUP

Definisce il callback di avvio per il plug-in.
WSMAN_SHELL_COMPLETION_FUNCTION

Funzione di callback chiamata per le operazioni della shell, che generano una richiesta remota.
WSManCloseCommand

Elimina un comando e libera le risorse associate.
WSManCloseOperation

Annulla o chiude un'operazione asincrona.
WSManCloseSession

Chiude un oggetto sessione.
WSManCloseShell

Elimina un oggetto shell e libera le risorse associate alla shell.
WSManConnectShell

Si connette a una sessione del server esistente.
WSManConnectShellCommand

Connette a un comando esistente in esecuzione in una shell.
WSManCreateSession

Crea un oggetto sessione.
WSManCreateShell

Crea un oggetto shell.
WSManCreateShellEx

Crea un oggetto shell usando la stessa funzionalità della funzione WSManCreateShell, con l'aggiunta di un ID shell specificato dal client.
WSManDeinitialize

Deinitialize lo stack client di gestione remota Windows.
WSManDisconnectShell

Disconnette la connessione di rete di una shell attiva e i relativi comandi associati.
WSManGetErrorMessage

Recupera i messaggi di errore associati a un determinato codice di errore e lingua.
WSManGetSessionOptionAsDword

Ottiene il valore di un'opzione di sessione. (WSManGetSessionOptionAsDword)
WSManGetSessionOptionAsString

Ottiene il valore di un'opzione di sessione. (WSManGetSessionOptionAsString)
WSManInitialize

Inizializza l'API client di gestione remota Windows.
WSManPluginAuthzOperationComplete

Segnala un'autorizzazione riuscita o non riuscita per un'operazione utente.
WSManPluginAuthzQueryQuotaComplete

Chiamato dal punto di ingresso WSManPluginAuthzQueryQuota e deve essere chiamato se il plug-in può eseguire la richiesta.
WSManPluginAuthzUserComplete

Segnala un'autorizzazione di connessione utente riuscita o non riuscita.
WSManPluginFreeRequestDetails

Rilascia la memoria allocata per la struttura WSMAN_PLUGIN_REQUEST, che viene passata ai punti di ingresso del plug-in dell'operazione.
WSManPluginGetOperationParameters

Ottiene informazioni operative per elementi quali timeout e restrizioni dei dati associate all'operazione.
WSManPluginOperationComplete

Segnala il completamento di un'operazione da tutti i punti di ingresso dell'operazione, ad eccezione dei metodi WSManPluginStartup e WSManPluginShutdown.
WSManPluginReceiveResult

Segnala i risultati per la chiamata di plug-in WSMAN_PLUGIN_RECEIVE e viene usato dalla maggior parte dei plug-in della shell che restituiscono risultati.
WSManPluginReportContext

Segnala la shell e il contesto di comando all'infrastruttura gestione remota Windows (WinRM) in modo che sia possibile eseguire ulteriori operazioni sulla shell e/o sul comando.
WSManReceiveShellOutput

Recupera l'output da un comando in esecuzione o dalla shell.
WSManReconnectShell

Riconnette una sessione shell disconnessa in precedenza. Per riconnettere i comandi associati della sessione della shell, usare WSManReconnectShellCommand.
WSManReconnectShellCommand

Riconnette un comando disconnesso in precedenza.
WSManRunShellCommand

Avvia l'esecuzione di un comando all'interno di una shell esistente e non attende il completamento del comando.
WSManRunShellCommandEx

Fornisce la stessa funzionalità della funzione WSManRunShellCommand, con l'aggiunta di un'opzione ID comando.
WSManSendShellInput

Ipa il flusso di input a un comando in esecuzione o alla shell.
WSManSetSessionOption

Imposta un set esteso di opzioni per la sessione.
WSManSignalShell

Invia un codice di controllo a un comando esistente o alla shell stessa.

Interfacce

 
IWSMan

Fornisce metodi e proprietà utilizzati per creare una sessione, rappresentata da un oggetto Session.
IWSManConnectionOptions

L'oggetto IWSManConnectionOptions viene passato al metodo IWSMan::CreateSession per fornire il nome utente e la password associati all'account locale nel computer remoto.
IWSManConnectionOptionsEx

L'oggetto IWSManConnectionOptionsEx viene passato al metodo IWSMan::CreateSession per fornire l'identificazione personale del certificato client usato per l'autenticazione.
IWSManConnectionOptionsEx2

L'oggetto IWSManConnectionOptionsEx2 viene passato al metodo IWSMan::CreateSession per fornire il meccanismo di autenticazione, il tipo di accesso e le credenziali per la connessione a un server proxy.
IWSManEnumerator

Rappresenta un flusso di risultati restituiti da operazioni quali un'operazione WS-Enumeration:Enumerate del protocollo WS-Management.
IWSManEx

Estende i metodi e le proprietà dell'interfaccia IWSMan per includere la creazione di oggetti IWSManResourceLocator, metodi che restituiscono valori di enumerazione e flag di sessione e un metodo per ottenere informazioni sugli errori estese.
IWSManEx2

Estende i metodi e le proprietà dell'interfaccia IWSManEx per includere un metodo che restituisce un valore del flag di sessione correlato all'autenticazione tramite certificati client.
IWSManEx3

Estende i metodi e le proprietà dell'interfaccia IWSManEx per includere un metodo che restituisce un valore del flag di sessione correlato all'autenticazione tramite il provider di supporto per la sicurezza delle credenziali (CredSSP).
IWSManResourceLocator

Fornisce il percorso di una risorsa. È possibile utilizzare un oggetto IWSManResourceLocator anziché un URI di risorsa nelle operazioni degli oggetti IWSManSession, ad esempio IWSManSession.Get, IWSManSession.Put o IWSManSession.Enumerate.
IWSManSession

Definisce le operazioni e le impostazioni di sessione.

Strutture

 
WSMAN_AUTHENTICATION_CREDENTIALS

Definisce il metodo di autenticazione e le credenziali usate per l'autenticazione del server o del proxy.
WSMAN_AUTHZ_QUOTA

Segnala le informazioni sulla quota per utente per i plug-in di autorizzazione.
WSMAN_CERTIFICATE_DETAILS

Archivia le informazioni client per una richiesta in ingresso inviata con un certificato client.
WSMAN_COMMAND_ARG_SET

Rappresenta il set di argomenti passati alla riga di comando.
WSMAN_DATA

Contiene i dati in ingresso e in uscita usati nell'API Gestione remota Windows (WinRM).
WSMAN_DATA_BINARY

Contiene dati binari da usare con varie funzioni di gestione remota di Windows.
WSMAN_DATA_TEXT

Contiene dati testuali da usare con varie funzioni di gestione remota Di Windows.
WSMAN_ENVIRONMENT_VARIABLE

Definisce una singola variabile di ambiente usando una coppia nome e valore.
WSMAN_ENVIRONMENT_VARIABLE_SET

Definisce una matrice di variabili di ambiente.
WSMAN_ERROR

Contiene informazioni sugli errori restituite da un client Di gestione remota Windows (WinRM).
WSMAN_FILTER

WSMAN_FILTER è riservato per uso futuro.
WSMAN_FRAGMENT

WSMAN_FRAGMENT è riservato per uso futuro.
WSMAN_KEY

Rappresenta una coppia chiave e valore all'interno di un set di selettori e viene utilizzata per identificare una determinata risorsa.
WSMAN_OPERATION_INFO

Rappresenta un endpoint di risorsa specifico per il quale il plug-in deve eseguire la richiesta.
WSMAN_OPTION

Rappresenta una coppia nome e valore di opzione specifica.
WSMAN_OPTION_SET

Rappresenta un set di opzioni.
WSMAN_PLUGIN_REQUEST

Specifica le informazioni per una richiesta di plug-in.
WSMAN_PROXY_INFO

Specifica le informazioni sul proxy.
WSMAN_RECEIVE_DATA_RESULT

Rappresenta i dati di output ricevuti da un metodo WSManReceiveShellOutput.
WSMAN_RESPONSE_DATA

Rappresenta i dati di output ricevuti da un'operazione WSMan.
WSMAN_SELECTOR_SET

Definisce un set di chiavi che rappresentano l'identità di una risorsa.
WSMAN_SENDER_DETAILS

Specifica i dettagli del client per ogni richiesta in ingresso.
WSMAN_SHELL_ASYNC

Definisce una struttura asincrona da passare a tutte le operazioni della shell.
WSMAN_SHELL_DISCONNECT_INFO

Specifica la durata massima, in millisecondi, la shell rimarrà aperta dopo la disconnessione del client.
WSMAN_SHELL_STARTUP_INFO_V10

La struttura WSMAN_SHELL_STARTUP_INFO_V10 (wsman.h) definisce i parametri di avvio della shell da usare con la funzione WSManCreateShell.
WSMAN_SHELL_STARTUP_INFO_V11

La struttura WSMAN_SHELL_STARTUP_INFO_V11 (wsman.h) definisce i parametri di avvio della shell da usare con la funzione WSManCreateShell.
WSMAN_STREAM_ID_SET

Elenca tutti i flussi usati per l'input o l'output per la shell e i comandi.
WSMAN_USERNAME_PASSWORD_CREDS

Definisce le credenziali usate per l'autenticazione.