Partager via

New-WSManSessionOption

Module:
Microsoft.WSMan.Management Module

Crée une table de hachage d’option de session à utiliser comme paramètres d’entrée pour les applets de commande WS-Management.

Syntaxe

Default (Par défaut) 

New-WSManSessionOption
    [-ProxyAccessType <ProxyAccessType>]
    [-ProxyAuthentication <ProxyAuthentication>]
    [-ProxyCredential <PSCredential>]
    [-SkipCACheck]
    [-SkipCNCheck]
    [-SkipRevocationCheck]
    [-SPNPort <Int32>]
    [-OperationTimeout <Int32>]
    [-NoEncryption]
    [-UseUTF16]
    [<CommonParameters>]

Description

L’applet de commande New-WSManSessionOption 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 : Créer 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 serveur distant01 à 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ètre de connexion dans la variable $a. Dans ce cas, 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 transmettre les informations d’identification stockées dans la variable $a à Connect-WSMan. Ensuite, Connect-WSMan se connecte à l’ordinateur serveur distant01 à 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 à des ordinateurs distants avant de passer au 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 à distance sur HTTP.

Par défaut, le trafic non chiffré n’est pas activé. Elle doit être activée dans la configuration locale.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-OperationTimeout

Spécifie le délai d’attente, en millisecondes, pour l’opération de WS-Management.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:OperationTimeoutMSec

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ProxyAccessType

Spécifie le mécanisme par lequel se trouve le serveur proxy. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • 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ôtes localement.

La valeur par défaut est ProxyIEConfig.

Propriétés du paramètre

Type:ProxyAccessType
Valeur par défaut:None
Valeurs acceptées:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ProxyAuthentication

Spécifie la méthode d’authentification à utiliser sur le proxy. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • 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 réponse aux défis 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. Par exemple, le protocole Kerberos et NTLM.

La valeur par défaut est Negotiate.

Propriétés du paramètre

Type:ProxyAuthentication
Valeur par défaut:None
Valeurs acceptées:Negotiate, Basic, Digest
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ProxyCredential

Spécifie un compte d’utilisateur autorisé à accéder via un proxy web intermédiaire.

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 que l’ordinateur distant est répertorié comme hôte approuvé dans la configuration WS-Management.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SkipCNCheck

Spécifie que le nom commun du certificat du serveur n’a pas besoin de correspondre au nom d’hôte du serveur. Cela est utilisé uniquement dans les opérations distantes à l’aide du protocole HTTPS. Cette option ne doit être utilisée que pour les ordinateurs approuvés.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SkipRevocationCheck

Indique que la connexion ne valide pas l’état de révocation sur le certificat de serveur.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SPNPort

Spécifie un numéro de port à ajouter au nom du principal du service de connexion (SPN) du serveur distant. Un SPN est utilisé lorsque le mécanisme d’authentification est Kerberos ou Negotiate.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Sorties

SessionOption

Cette applet de commande retourne l’option de session WSMan créée en tant qu’objet SessionOption.