Condividi tramite


Get-WSManInstance

Visualizza le informazioni di gestione per un'istanza di risorsa specificata da un URI di risorsa.

Sintassi

Get-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [-SelectorSet <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]
Get-WSManInstance
   [-ApplicationName <String>]
   [-BasePropertiesOnly]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Enumerate]
   [-Filter <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-Associations]
   [-ResourceURI] <Uri>
   [-ReturnType <String>]
   [-SessionOption <SessionOption>]
   [-Shallow]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Descrizione

Il Get-WSManInstance cmdlet recupera un'istanza di una risorsa di gestione specificata da un URI (Uniform Resource Identifier) della risorsa. Le informazioni recuperate possono essere un set di informazioni XML complesso, ovvero un oggetto o un valore semplice. Questo cmdlet equivale al comando Get di Servizi Web standard per la gestione (WS-Management).

Questo cmdlet usa il livello di connessione/trasporto WS-Management per recuperare informazioni.

Esempio

Esempio 1: Ottenere tutte le informazioni da WMI

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="winrm"} -ComputerName "Server01"

Questo comando restituisce tutte le informazioni esposte da Strumentazione gestione Windows (WMI) sul servizio WinRM nel computer server01 remoto.

Esempio 2: Ottenere lo stato del servizio Spooler

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"

Questo comando restituisce solo lo stato del servizio Spooler nel computer server01 remoto.

Esempio 3: Ottenere i riferimenti agli endpoint per tutti i servizi

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/win32_service -ReturnType EPR

Questo comando restituisce i riferimenti all'endpoint che corrispondono a tutti i servizi nel computer locale.

Esempio 4: Ottenere i servizi che soddisfano i criteri specificati

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from win32_service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"

Questo comando elenca tutti i servizi che soddisfano i criteri seguenti nel computer server01 remoto:

  • Il tipo di avvio del servizio è Automatic.
  • Il servizio è stato arrestato.

Esempio 5: Ottenere la configurazione del listener che corrisponde ai criteri nel computer locale

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}

Questo comando elenca la configurazione del listener di WS-Management nel computer locale per il listener che corrisponde ai criteri nel selettore impostato.

Esempio 6: Ottenere la configurazione del listener che corrisponde ai criteri in un computer remoto

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"

Questo comando elenca la configurazione del listener di WS-Management nel computer server01 remoto per il listener che corrisponde ai criteri nel selettore impostato.

Esempio 7: Ottenere istanze associate correlate a un'istanza specificata

Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

Questo comando recupera le istanze associate che sono correlate all'istanza specificata (winrm).

è necessario racchiudere il filtro tra virgolette, come illustrato nell'esempio.

Esempio 8: Ottenere istanze di associazione correlate a un'istanza specificata

Get-WSManInstance -Enumerate -Dialect Association -Associations -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

Questo comando recupera le istanze dell'associazione che sono correlate all'istanza specificata (winrm). Poiché il valore Dialect è association e viene usato il parametro Associations , questo comando restituisce istanze di associazione, non istanze associate.

è necessario racchiudere il filtro tra virgolette, come illustrato nell'esempio.

Parametri

-ApplicationName

Specifica il nome dell'applicazione nella connessione. Il valore predefinito del parametro ApplicationName è WSMAN. L'identificatore completo per l'endpoint remoto è nel formato seguente:

<transport>://<server>:<port>/<ApplicationName>

Ad esempio: http://server01:8080/WSMAN

Internet Information Services (IIS) che ospita la sessione, inoltra le richieste con questo endpoint all'applicazione specificata. Questa impostazione predefinita di WSMAN è appropriata per la maggior parte degli usi. Questo parametro è progettato per essere usato se molti computer stabiliscono connessioni remote a un computer che esegue PowerShell. In questo caso, IIS ospita WS-Management per l'efficienza.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Associations

Indica che questo cmdlet ottiene istanze di associazione, non istanze associate. È possibile usare questo parametro solo quando il parametro Dialect ha un valore Association.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Authentication

Specifica il meccanismo di autenticazione da utilizzare nel server. I valori validi per questo parametro sono:

  • Basic - Basic è uno schema in cui il nome utente e la password vengono inviati in testo non crittografato al server o al proxy.
  • Default - Usare il metodo di autenticazione implementato dal protocollo WS-Management. Si tratta dell'impostazione predefinita.
  • Digest - Digest è uno schema challenge-response che usa una stringa di dati specificata dal server per la richiesta di verifica.
  • Kerberos - Il computer client e il server si autenticano a vicenda usando i certificati Kerberos.
  • Negotiate - Negotiate è uno schema challenge-response che negozia con il server o il proxy per determinare lo schema da usare per l'autenticazione. Ad esempio, questo valore di parametro consente la negoziazione per determinare se viene usato il protocollo Kerberos o NTLM.
  • CredSSP - Usare l'autenticazione CredSSP (Credential Security Support Provider), che consente all'utente di delegare le credenziali. Questa opzione è progettata per i comandi eseguiti in un computer remoto, ma che raccolgono i dati o eseguono comandi aggiuntivi in altri computer remoti.

Attenzione

CredSSP delega le credenziali utente dal computer locale a un computer remoto. Questa pratica aumenta il rischio di sicurezza dell'operazione remota. Se il computer remoto viene compromesso, le credenziali che gli vengono passate possono essere usate per controllare la sessione di rete.

Type:AuthenticationMechanism
Aliases:auth, am
Accepted values:None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BasePropertiesOnly

Indica che questo cmdlet enumera solo le proprietà che fanno parte della classe base specificata dal parametro ResourceURI . Questo parametro non ha alcun effetto se viene specificato il parametro Shallow .

Type:SwitchParameter
Aliases:UBPO, Base
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CertificateThumbprint

Specifica il certificato di chiave pubblica digitale (X509) di un account utente con autorizzazione per l'esecuzione di questa azione. Immettere l'identificazione personale del certificato.

I certificati vengono usati nell'autenticazione basata sui certificati client. Possono essere mappati solo ad account utente locali. Non funzionano con gli account di dominio.

Per ottenere un'identificazione personale del certificato, usare il Get-Item comando o Get-ChildItem nell'unità Certificato di PowerShell: .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Specifica il computer in cui eseguire l'operazione di gestione. Il valore può essere un nome di dominio completo, un nome NetBIOS o un indirizzo IP. Usare il nome del computer locale, usare localhost o usare un punto (.) per specificare il computer locale. Il valore predefinito è il computer locale. Quando il computer remoto è in un dominio diverso dall'utente, è necessario usare un nome di dominio completo. È possibile inviare tramite pipe un valore per questo parametro al cmdlet.

Type:String
Aliases:CN
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionURI

Specifica l'endpoint della connessione. Il formato di questa stringa è il seguente:

<Transport>://<Server>:<Port>/<ApplicationName>

La stringa seguente è un valore formattato correttamente per questo parametro:

http://Server01:8080/WSMAN

L'URI deve essere completo.

Type:Uri
Aliases:CURI, CU
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifica un account utente che dispone delle autorizzazioni per eseguire questa azione. Il valore predefinito è l'utente corrente. Digitare un nome utente, ad esempio User01, Domain01\User01 o User@Domain.com. In alternativa, immettere un oggetto PSCredential , ad esempio quello restituito dal Get-Credential cmdlet . Quando si digita un nome utente, questo cmdlet richiede una password.

Type:PSCredential
Aliases:cred, c
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Dialect

Specifica il dialetto da usare nel predicato del filtro. Può trattarsi di qualsiasi dialetto supportato dal servizio remoto. È possibile usare gli alias seguenti per l'URI del dialetto:

  • WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
  • Selettore- http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
  • Associazione- http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter
Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enumerate

Indica che questo cmdlet restituisce tutte le istanze di una risorsa di gestione.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Specifica l'espressione di filtro per l'enumerazione. Se si specifica questo parametro, è necessario specificare anche Il dialetto.

I valori validi di questo parametro dipendono dal dialetto specificato in Dialetto. Ad esempio, se Dialect è WQL, il parametro Filter deve contenere una stringa e la stringa deve contenere una query WQL valida, ad esempio la query seguente:

"Select * from Win32_Service where State != Running"

Se Dialect è Association, Filter deve contenere una stringa e la stringa deve contenere un filtro valido, ad esempio il filtro seguente:

-filter:Object=EPR\[;AssociationClassName=AssocClassName\]\[;ResultClassName=ClassName\]\[;Role=RefPropertyName\]\[;ResultRole=RefPropertyName\]}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Fragment

Specifica una sezione all'interno dell'istanza che deve essere aggiornata o recuperata per l'operazione specificata. Ad esempio, per ottenere lo stato di un servizio spooler, specificare quanto segue:

-Fragment Status

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OptionSet

Specifica un set di opzioni a un servizio per modificare o perfezionare la natura della richiesta. Queste opzioni sono simili a quelle usate nelle shell della riga di comando perché sono specifiche del servizio. È possibile specificare qualsiasi numero di opzioni.

L'esempio seguente illustra la sintassi che passa i valori 1, 2 e 3 per i parametri a, b e c:

-OptionSet @{a=1;b=2;c=3}

Type:Hashtable
Aliases:OS
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Port

Specifica la porta da usare quando il client stabilisce la connessione al servizio Gestione remota Windows. Quando il trasporto è HTTP, la porta predefinita è 80. Quando il trasporto è HTTPS, la porta predefinita è 443.

Quando si usa HTTPS come trasporto, il valore del parametro ComputerName deve corrispondere al nome comune del certificato del server.When you use HTTPS as the transport, the value of the ComputerName parameter must match the server's certificate common name (CN). Tuttavia, se il parametro SkipCNCheck viene specificato come parte del parametro SessionOption , il nome comune del certificato del server non deve corrispondere al nome host del server. Il parametro SkipCNCheck deve essere utilizzato solo per i computer attendibili.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceURI

Specifica l'URI della classe di risorse o dell'istanza. L'URI identifica un tipo specifico di risorsa, ad esempio dischi o processi, in un computer.

Un URI è costituito da un prefisso e da un percorso di una risorsa. Ad esempio:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Type:Uri
Aliases:RURI
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnType

Specifica il tipo di dati da restituire. I valori validi per questo parametro sono:

  • Object
  • EPR
  • ObjectAndEPR

Il valore predefinito è Object.

Se si specifica o non si specifica Object questo parametro, questo cmdlet restituisce solo oggetti. Se si specifica il riferimento all'endpoint (EPR), questo cmdlet restituisce solo i riferimenti endpoint degli oggetti. I riferimenti all'endpoint contengono informazioni sugli URI di risorsa e sui selettori per l'istanza. Se si specifica , questo cmdlet restituisce ObjectAndEPRsia l'oggetto che i riferimenti all'endpoint associati.

Type:String
Aliases:RT
Accepted values:object, epr, objectandepr
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SelectorSet

Specifica un set di coppie valori usate per selezionare particolari istanze di risorse di gestione. Il parametro SelectorSet viene usato quando sono presenti più istanze della risorsa. Il valore del parametro SelectorSet deve essere una tabella hash.

L'esempio seguente illustra come immettere un valore per questo parametro:

-SelectorSet @{Name="WinRM";ID="yyy"}

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SessionOption

Specifica le opzioni estese per la sessione WS-Management. Immettere un oggetto SessionOption creato usando il cmdlet New-WSManSessionOption. Per altre informazioni sulle opzioni disponibili, digitare Get-Help New-WSManSessionOption.

Type:SessionOption
Aliases:SO
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Shallow

Indica che questo cmdlet restituisce solo istanze della classe base specificata nell'URI della risorsa. Se non si specifica questo parametro, questo cmdlet restituisce istanze della classe base specificata nell'URI e in tutte le relative classi derivate.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSSL

Specifica che il protocollo SSL (Secure Sockets Layer) viene usato per stabilire una connessione al computer remoto. Per impostazione predefinita SSL non viene utilizzato.

WS-Management crittografa tutto il contenuto di Windows PowerShell trasmesso in rete. Il parametro UseSSL consente di specificare la protezione aggiuntiva di HTTPS anziché HTTP. Se SSL non è disponibile sulla porta usata per la connessione e si specifica questo parametro, il comando ha esito negativo.

Type:SwitchParameter
Aliases:SSL
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

XmlElement

Questo cmdlet restituisce un oggetto XMLElement .