Set-WSManInstance
Modifica le informazioni di gestione correlate a una risorsa.
Sintassi
ComputerName (Impostazione predefinita)
Set-WSManInstance
[-ResourceURI] <Uri>
[[-SelectorSet] <Hashtable>]
[-ApplicationName <String>]
[-ComputerName <String>]
[-Dialect <Uri>]
[-FilePath <String>]
[-Fragment <String>]
[-OptionSet <Hashtable>]
[-Port <Int32>]
[-SessionOption <SessionOption>]
[-UseSSL]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
URI
Set-WSManInstance
[-ResourceURI] <Uri>
[[-SelectorSet] <Hashtable>]
[-ConnectionURI <Uri>]
[-Dialect <Uri>]
[-FilePath <String>]
[-Fragment <String>]
[-OptionSet <Hashtable>]
[-SessionOption <SessionOption>]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Descrizione
Il cmdlet Set-WSManInstance modifica le informazioni di gestione correlate a una risorsa.
Questo cmdlet usa il livello di connessione/trasporto WinRM per modificare le informazioni.
Esempio
Esempio 1: Disabilitare un listener nel computer locale
Set-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}
cfg : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi : http://www.w3.org/2001/XMLSchema-instance
lang : en-US
Address : *
Transport : HTTPS
Port : 443
Hostname :
Enabled : false
URLPrefix : wsman
CertificateThumbprint :
ListeningOn : {127.0.0.1, 172.30.168.171, ::1, 2001:4898:0:fff:0:5efe:172.30.168.171...}
Questo comando disabilita il listener https nel computer locale.
Importante: Il parametro ValueSet fa distinzione tra maiuscole e minuscole quando corrisponde alle proprietà specificate.
Ad esempio, in questo comando,
Questo errore ha esito negativo: -ValueSet @{enabled="False"}
L'operazione ha esito positivo: -ValueSet @{Enabled="False"}
Esempio 2: Impostare le dimensioni massime della busta nel computer locale
Set-WSManInstance -ResourceURI winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}
cfg : https://schemas.microsoft.com/wbem/wsman/1/config
lang : en-US
MaxEnvelopeSizekb : 200
MaxTimeoutms : 60000
MaxBatchItems : 32000
MaxProviderRequests : 4294967295
Client : Client
Service : Service
Winrs : Winrs
Questo comando imposta il valore MaxEnvelopeSizekb su 200 nel computer locale.
Importante: Il parametro ValueSet fa distinzione tra maiuscole e minuscole quando corrisponde alle proprietà specificate.
Ad esempio, usando il comando precedente.
L'operazione non riesce: -ValueSet @{MaxEnvelopeSizeKB ="200"}
Questo riesce: -ValueSet @{MaxEnvelopeSizekb ="200"}
Esempio 3: Disabilitare un listener in un computer remoto
Set-WSManInstance -ResourceURI winrm/config/listener -ComputerName SERVER02 -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}
cfg : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi : http://www.w3.org/2001/XMLSchema-instance
lang : en-US
Address : *
Transport : HTTPS
Port : 443
Hostname :
Enabled : false
URLPrefix : wsman
CertificateThumbprint :
ListeningOn : {127.0.0.1, 172.30.168.172, ::1, 2001:4898:0:fff:0:5efe:172.30.168.172...}
Questo comando disabilita il listener https sul computer remoto SERVER02.
Importante: Il parametro ValueSet fa distinzione tra maiuscole e minuscole quando corrisponde alle proprietà specificate.
Ad esempio, usando il comando precedente.
Questo fallisce: -ValueSet @{enabled="False"}
Questo riesce: -ValueSet @{Enabled="False"}
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:
< >di trasporto ://<server>:<porta>/<ApplicationName>
Per 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 quando numerosi computer stabiliscono connessioni remote a un computer che esegue Windows PowerShell. In questo caso, IIS ospita i servizi Web per la gestione (WS-Management ) per garantire l'efficienza.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | Wsman |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Authentication
Specifica il meccanismo di autenticazione da utilizzare nel server. I valori possibili sono:
- Basic: Basic è uno schema in cui il nome utente e la password vengono inviati in testo non crittografato al server o al proxy.
- Impostazione predefinita: 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 di risposta di verifica 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 raccolgono dati da o eseguono comandi aggiuntivi in altri computer remoti.
Attenzione: CredSSP delega le credenziali dell'utente dal computer locale a un computer remoto. Questa procedura aumenta il rischio di sicurezza dell'operazione remota. Se il computer remoto viene compromesso, quando vengono passate le credenziali, è possibile usare le credenziali per controllare la sessione di rete.
Proprietà dei parametri
| Tipo: | AuthenticationMechanism |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | autenticazione, am |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CertificateThumbprint
Specifica il certificato di chiave pubblica digitale (X509) di un account utente che dispone dell'autorizzazione per eseguire questa azione. Immettere l'impronta digitale del certificato.
I certificati vengono usati nell'autenticazione basata su certificati client. Possono essere mappati solo agli account utente locali; non funzionano con gli account di dominio.
Per ottenere un'identificazione personale del certificato, usare il comando Get-Item o Get-ChildItem nell'unità Cert di Windows PowerShell: .
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ComputerName
Specifica il computer in cui si desidera 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 computer locale è l'impostazione predefinita. Quando il computer remoto si trova in un dominio diverso dall'utente, è necessario usare un nome di dominio completo. È possibile inviare tramite pipe un valore per questo parametro al cmdlet .
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | Localhost |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Cina |
Set di parametri
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConnectionURI
Specifica l'endpoint di connessione. Il formato di questa stringa è:
<Trasporto>://<Server>:<Porta>/<Nome Applicazione>
La stringa seguente è un valore formattato correttamente per questo parametro:
http://Server01:8080/WSMAN
L'URI deve essere completo.
Proprietà dei parametri
| Tipo: | Uri |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
URI
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Credential
Specifica un account utente autorizzato a 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 cmdlet Get-Credential. Quando si digita un nome utente, verrà richiesta una password.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cred, c |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Dialect
Specifica il dialetto da utilizzare nel predicato del filtro. Può trattarsi di qualsiasi dialetto supportato dal servizio remoto. Gli alias seguenti possono essere usati per l'URI di dialetto:
- WQL:
https://schemas.microsoft.com/wbem/wsman/1/WQL - Selettore:
https://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter - Associazione:
http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter
Proprietà dei parametri
| Tipo: | Uri |
| Valore predefinito: | Http://schemas.microsoft.com/wbem/wsman/1/WQL |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-FilePath
Specifica il percorso di un file utilizzato per aggiornare una risorsa di gestione. Per specificare la risorsa di gestione, utilizzare i parametri ResourceURI e SelectorSet. Ad esempio, il comando seguente usa il parametro FilePath:
Invoke-WSManAction -action StopService -resourceuri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:c:\input.xml -authentication default
Questo comando chiama il metodo StopService sul servizio Spooler utilizzando l'input da un file. Il file, Input.xml, contiene il seguente contenuto:
<p:StopService_INPUT xmlns:p="https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Fragment
Specifica una sezione all'interno dell'istanza da aggiornare o recuperare per l'operazione specificata. Ad esempio, per ottenere lo stato di un servizio spooler, specificare "-Fragment Status".
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OptionSet
Passa un set di opzioni a un servizio per modificare o perfezionare la natura della richiesta. Queste opzioni sono simili alle opzioni usate nelle shell della riga di comando perché sono specifiche del servizio. È possibile specificare un numero qualsiasi di opzioni.
Nell'esempio seguente viene illustrata la sintassi che passa i valori 1, 2 e 3 per i parametri a, b e c:
-OptionSet @{a=1; b=2; c=3}
Proprietà dei parametri
| Tipo: | Hashtable |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | os |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Port
Specifica la porta da usare quando il client si connette al servizio WinRM. 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.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ResourceURI
Contiene l'URI (Uniform Resource Identifier) della classe di risorse o dell'istanza di . L'URI viene usato per identificare 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. Per esempio:
https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
Proprietà dei parametri
| Tipo: | Uri |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | ruri |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SelectorSet
Specifica un set di coppie valore utilizzate per selezionare determinate istanze di risorse di gestione. Il parametro SelectorSet viene utilizzato quando esistono più istanze della risorsa. Il valore del parametro SelectorSet deve essere una tabella hash. Nell'esempio seguente viene illustrato come immettere un valore per questo parametro:
-SelectorSet @{Name="WinRM";ID="yyy"}
Proprietà dei parametri
| Tipo: | Hashtable |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-SessionOption
Definisce un set di opzioni estese per la sessione di WS-Management. Immettere un oggetto SessionOption creato utilizzando il cmdlet New-WSManSessionOption. Per ulteriori informazioni sulle opzioni disponibili, vedere New-WSManSessionOption.
Proprietà dei parametri
| Tipo: | SessionOption |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | so |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UseSSL
Specifica che il protocollo SSL (Secure Sockets Layer) deve essere usato per stabilire una connessione al computer remoto. Per impostazione predefinita, SSL non viene usato.
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | ssl |
Set di parametri
ComputerName
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ValueSet
Specifica una tabella hash che consente di modificare una risorsa di gestione. Specificare la risorsa di gestione usando il parametro ResourceURI e il parametro SelectorSet. Il valore del parametro ValueSet deve essere una tabella hash.
Proprietà dei parametri
| Tipo: | Hashtable |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Questo cmdlet non accetta alcun input.
Output
None
Questo cmdlet non genera alcun output.