New-WSManSessionOption
Crée une table de hachage d’option de session à utiliser comme paramètres d’entrée pour WS-Management applets de commande.
Syntax
New-WSManSessionOption
[-ProxyAccessType <ProxyAccessType>]
[-ProxyAuthentication <ProxyAuthentication>]
[-ProxyCredential <PSCredential>]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-SPNPort <Int32>]
[-OperationTimeout <Int32>]
[-NoEncryption]
[-UseUTF16]
[<CommonParameters>]
Description
Cette applet de commande est disponible uniquement sur la plateforme Windows.
L’applet New-WSManSessionOption
de commande crée une table de hachage d’option de session WSMan qui peut être transmise aux applets de commande WSMan :
Get-WSManInstance
Set-WSManInstance
Invoke-WSManAction
Connect-WSMan
Exemples
Exemple 1 : Create une connexion qui utilise des options de connexion
PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir
WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName Type
------------ ----
localhost Container
server01 Container
Cet exemple crée une connexion à l’ordinateur distant server01 à l’aide des options de connexion définies par New-WSManSessionOption
.
La première commande utilise New-WSManSessionOption
pour stocker un ensemble d’options de paramètres de connexion dans la $a
variable. Dans cet exemple, les options de session définissent un délai de connexion de 30 secondes (30 000 millisecondes).
La deuxième commande utilise le paramètre SessionOption pour passer les informations d’identification stockées dans la $a
variable à Connect-WSMan
. Ensuite, Connect-WSMan
se connecte à l’ordinateur distant server01 à l’aide des options de session spécifiées.
Connect-WSMan
est généralement utilisé dans le contexte du fournisseur WSMan pour se connecter à un ordinateur distant, dans ce cas l’ordinateur server01. Toutefois, vous pouvez utiliser l'applet de commande pour établir des connexions aux ordinateurs distants avant de choisir le fournisseur WSMan. Ces connexions apparaissent dans la liste ComputerName .
Paramètres
-NoEncryption
Indique que la connexion n’utilise pas le chiffrement pour les opérations distantes via HTTP.
Par défaut, le trafic non chiffré n’est pas activé. Il doit être activé dans la configuration locale.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OperationTimeout
Spécifie le délai d’attente, en millisecondes, pour l’opération de WS-Management.
Type: | Int32 |
Aliases: | OperationTimeoutMSec |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAccessType
Spécifie le mécanisme par lequel le serveur proxy est trouvé. Les valeurs valides pour ce paramètre sont :
ProxyIEConfig
- Utilisez la configuration du proxy Internet Explorer pour l’utilisateur actuel.ProxyWinHttpConfig
- Le client WSMan utilise les paramètres de proxy configurés pour WinHTTP, à l’aide de l’utilitaire ProxyCfg.exe.ProxyAutoDetect
- Forcer la détection automatique d’un serveur proxy.ProxyNoProxyServer
- N’utilisez pas de serveur proxy. Résolvez tous les noms d’hôte localement.
La valeur par défaut est ProxyIEConfig.
Type: | ProxyAccessType |
Accepted values: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAuthentication
Spécifie la méthode d'authentification à utiliser au niveau du proxy. Les valeurs valides pour ce paramètre sont :
Basic
- De base est un schéma dans lequel le nom d’utilisateur et le mot de passe sont envoyés en texte clair au serveur ou au proxy.Digest
- Digest est un schéma de défi-réponse qui utilise une chaîne de données spécifiée par le serveur pour le défi.Negotiate
- Négocier est un schéma de réponse aux défis qui négocie avec le serveur ou le proxy pour déterminer le schéma à utiliser pour l’authentification. Le protocole Kerberos et NTLM en sont des exemples.
La valeur par défaut est Negotiate.
Type: | ProxyAuthentication |
Accepted values: | Negotiate, Basic, Digest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyCredential
Spécifie un compte d’utilisateur qui a l’autorisation d’accéder via un proxy web intermédiaire.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipCACheck
Spécifie que, lorsqu’il se connecte via HTTPS, le client ne valide pas que le certificat de serveur est signé par une autorité de certification approuvée. Utilisez cette option uniquement lorsque l’ordinateur distant est approuvé par une autre méthode, par exemple, si l’ordinateur distant fait partie d’un réseau physiquement sécurisé et isolé ou si l’ordinateur distant est répertorié en tant qu’hôte approuvé dans la configuration WS-Management.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipCNCheck
Spécifie que le nom commun du certificat (CN) du serveur n’a pas besoin de correspondre au nom d’hôte du serveur. Ce paramètre est utilisé uniquement dans les opérations à distance avec HTTPS. Cette option ne doit être utilisée que pour les ordinateurs approuvés.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipRevocationCheck
Indique que la connexion ne valide pas la révocation status sur le certificat de serveur.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SPNPort
Spécifie un numéro de port à ajouter au nom du principal du service de connexion (SPN) du serveur distant. Un nom SPN est utilisé quand le mécanisme d'authentification est Kerberos ou par négociation.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUTF16
Indique que la connexion encode la requête au format UTF16 au lieu du format UTF8. La valeur par défaut est l'encodage UTF8.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Sorties
Cette applet de commande retourne l’option de session WSMan créée en tant qu’objet SessionOption .