Partager via


New-PSSessionOption

Crée un objet qui contient les options avancées d'une session PSSession.

Syntaxe

New-PSSessionOption [-ApplicationArguments <PSPrimitiveDictionary>] [-CancelTimeOut <int>] [-Culture <CultureInfo>] [-IdleTimeOut <int>] [-MaximumReceivedDataSizePerCommand <int>] [-MaximumReceivedObjectSize <int>] [-MaximumRedirection <int>] [-NoCompression] [-NoEncryption] [-NoMachineProfile] [-OpenTimeOut <int>] [-OperationTimeOut <int>] [-ProxyAccessType {<None> | <IEConfig> | <WinHttpConfig> | <AutoDetect> | <NoProxyServer>}] [-ProxyAuthentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-ProxyCredential <PSCredential>] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck] [-UICulture <CultureInfo>] [-UseUTF16] [<CommonParameters>]

Description

L'applet de commande New-PSSessionOption crée un objet qui contient les options avancées d'une session PSSession. Vous pouvez utiliser l'objet comme valeur du paramètre SessionOption des applets de commande qui créent une session PSSession, telles que New-PSSession, Enter-PSSession et Invoke-Command.

Sans paramètres, New-PSSessionOption génère un objet qui contient les valeurs par défaut de toutes les options. Étant donné que toutes les propriétés peuvent être modifiées, vous pouvez utiliser l'objet résultant comme modèle et créer des objets d'option standard pour votre entreprise.

Paramètres

-ApplicationArguments <PSPrimitiveDictionary>

Spécifie une table de hachage envoyée directement à la configuration de session sans interprétation. Cette table de hachage est disponible pour la configuration de session en tant que propriété de la classe PSSenderInfo.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-CancelTimeOut <int>

Détermine le délai pendant lequel Windows PowerShell attend qu'une opération d'annulation (CTRL + C) s'exécute avant d'y mettre fin. Entrez une valeur en millisecondes.

La valeur par défaut est 60000 (1 minute). La valeur 0 (zéro) indique qu'aucun délai d'attente n'est défini ; la commande se poursuit indéfiniment.

Obligatoire ?

false

Position ?

named

Valeur par défaut

60000

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Culture <CultureInfo>

Spécifie la culture à utiliser pour la session PSSession. Entrez un nom de culture au format <code_langue2>-<code_pays/région2>, tel que « ja-jP », une variable contenant un objet CultureInfo ou une commande permettant d'obtenir un objet CultureInfo, telle que « get-culture ».

La valeur par défaut est $null et la culture qui est définie dans le système d'exploitation lors de la création de la session PSSession est utilisée dans cette dernière.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Current culture

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-IdleTimeOut <int>

Détermine le délai pendant lequel la session PSSession reste ouverte si l'ordinateur distant ne reçoit pas de communication en provenance de l'ordinateur local, telle que le signal de pulsation. Lorsque ce délai expire, la session PSSession se ferme.

Entrez une valeur en millisecondes. La valeur par défaut est 240000 secondes (4 minutes). La valeur minimale est 60000 (1 minute).

Si à la fois les ordinateurs locaux et distants spécifient une valeur de délai d'inactivité, la session PSSession utilise la valeur de délai la plus courte. L'ordinateur local peut configurer une valeur de délai d'inactivité en utilisant ce paramètre ou en définissant un délai d'inactivité dans la variable de préférence $PSSessionOption. L'ordinateur distant peut spécifier une valeur de délai d'inactivité dans la configuration du service Gestion des services Web (WSMAN:\localhost\shell\idletimeout).

Obligatoire ?

false

Position ?

named

Valeur par défaut

240000

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-MaximumReceivedDataSizePerCommand <int>

Spécifie le nombre maximal d'octets que l'ordinateur local peut recevoir en provenance de l'ordinateur distant dans une seule commande. Entrez une valeur en octets. Par défaut, il n'existe aucune limite pour la taille des données.

Cette option est conçue pour protéger les ressources présentes sur l'ordinateur client.

Obligatoire ?

false

Position ?

named

Valeur par défaut

No limit

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-MaximumReceivedObjectSize <int>

Spécifie la taille maximale des objets que l'ordinateur local peut recevoir en provenance de l'ordinateur distant. Entrez une valeur en octets. Par défaut, il n'existe aucune limite pour la taille des données.

Cette option est conçue pour protéger les ressources présentes sur l'ordinateur client.

Obligatoire ?

false

Position ?

named

Valeur par défaut

No limit

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-MaximumRedirection <int>

Détermine le nombre de fois où Windows PowerShell redirige une connexion vers un autre URI (Uniform Resource Identifier) avant que la connexion échoue. La valeur par défaut est 5. La valeur 0 (zéro) empêche toute redirection.

Cette option est utilisée dans la session PSSession uniquement lorsque le paramètre AllowRedirection est employé dans la commande qui crée cette session.

Obligatoire ?

false

Position ?

named

Valeur par défaut

5

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-NoCompression

Désactive la compression de paquets dans la session PSSession. La compression utilise un plus grand nombre de cycles processeur, mais accélère la transmission.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-NoEncryption

Désactive le chiffrement de données.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-NoMachineProfile

Empêche le chargement du profil utilisateur Windows. Par conséquent, la session PSSession peut être créée plus rapidement, mais les paramètres de Registre spécifiques à l'utilisateur, les éléments tels que les variables d'environnement et les certificats ne sont pas disponibles dans cette session.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-OpenTimeOut <int>

Détermine le délai pendant lequel l'ordinateur client attend l'établissement de la connexion de session. Lorsque le délai expire, la commande permettant d'établir la connexion échoue. Entrez une valeur en millisecondes.

La valeur par défaut est 180000 secondes (3 minutes). La valeur 0 (zéro) indique qu'aucun délai d'attente n'est défini ; la commande se poursuit indéfiniment.

Obligatoire ?

false

Position ?

named

Valeur par défaut

180000

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-OperationTimeOut <int>

Détermine le délai maximum pendant lequel toute opération de la session PSSession peut s'exécuter. Lorsque le délai expire, l'opération échoue. Entrez une valeur en millisecondes.

La valeur par défaut est 180000 secondes (3 minutes). La valeur 0 (zéro) indique qu'aucun délai d'attente n'est défini ; l'opération se poursuit indéfiniment.

Obligatoire ?

false

Position ?

named

Valeur par défaut

180000

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ProxyAccessType <ProxyAccessType>

Détermine le mécanisme utilisé pour la résolution du nom d'hôte. Les valeurs valides sont IEConfig, WinHttpConfig, AutoDetect, NoProxyServer et None. La valeur par défaut est None.

Pour plus d'informations sur les valeurs de ce paramètre, consultez la description de l'énumération System.Management.Automation.Remoting.ProxyAccessType dans la bibliothèque MSDN (Microsoft Developer Network) à l'adresse https://go.microsoft.com/fwlink/?LinkId=144756.

Obligatoire ?

false

Position ?

named

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ProxyAuthentication <AuthenticationMechanism>

Spécifie la méthode d'authentification utilisée pour la résolution de proxy. Les valeurs valides sont Basic, Digest et Negociate. La valeur par défaut est Negotiate.

Pour plus d'informations sur les valeurs de ce paramètre, consultez la description de l'énumération System.Management.Automation.Runspaces.AuthenticationMechanism dans la bibliothèque MSDN (Microsoft Developer Network) à l'adresse https://go.microsoft.com/fwlink/?LinkID=144382.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Negotiate

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ProxyCredential <PSCredential>

Spécifie les informations d'identification à utiliser pour l'authentification de proxy. Entrez une variable qui contient un objet PSCredential ou une commande permettant d'obtenir un objet PSCredential, telle que Get-Credential. Si cette option n'est pas définie, aucune information d'identification n'est spécifiée.

Obligatoire ?

false

Position ?

named

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-SkipCACheck

Spécifie que, lors de la connexion 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 un autre mécanisme, par exemple si l'ordinateur distant fait partie d'un réseau qui est physiquement sécurisé et isolé, ou s'il est répertorié comme hôte approuvé dans une configuration du service Gestion à distance de Windows (WinRM).

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-SkipCNCheck

Indique que le nom commun de certificat du serveur ne doit pas nécessairement correspondre au nom d'hôte du serveur. Cette option est utilisée uniquement dans les opérations distantes qui font appel au protocole HTTPS.

Employez-la seulement pour les ordinateurs approuvés.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-SkipRevocationCheck

Ne valide pas l'état de révocation du certificat de serveur.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-UICulture <CultureInfo>

Spécifie la culture d'interface utilisateur à employer pour la session PSSession.

Entrez un nom de culture au format <code_langue2>-<code_pays/région2>, tel que « ja-jP », une variable contenant un objet CultureInfo ou une commande permettant d'obtenir un objet CultureInfo, telle que Get-Culture.

La valeur par défaut est $null et la culture d'interface utilisateur qui est définie dans le système d'exploitation lors de la création de la session PSSession est utilisée dans cette dernière.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Current UI culture

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-UseUTF16

Encode la demande au format UTF16, et non pas UTF8.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False (UTF8 encoding)

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

Aucun

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

System.Management.Automation.Remoting.PSSessionOption

Remarques

Si le paramètre SessionOption n'est pas utilisé dans une commande pour créer une session PSSession, les options de session sont déterminées par les valeurs de propriété de la variable de préférence $PSSessionOption, si elle est définie. Pour plus d'informations sur la variable $PSSessionOption, consultez about_Preference_Variables.

Exemple 1

C:\PS>New-PSSessionOption


MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Description
-----------
Cette commande crée un objet d'option de session avec toutes les valeurs par défaut.





Exemple 2

C:\PS>$pso = new-pssessionoption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB

C:\PS> new-pssession -computerName Server01 -SessionOption $pso

Description
-----------
Cet exemple indique comment utiliser un objet d'option de session pour configurer une session.

La première commande crée un nouvel objet d'option de session et l'enregistre dans la valeur de la variable $pso.

La deuxième commande fait appel à l'applet de commande New-PSSession pour créer une session PSSession sur l'ordinateur distant Server01. Elle utilise l'objet d'option de session dans la valeur de la variable $pso comme valeur du paramètre SessionOption.





Exemple 3

C:\PS>enter-pssession -computername Server01 -sessionOption (new-pssessionoption -noEncryption -noCompression)

Description
-----------
Cette commande utilise l'applet de commande Enter-PSSession pour démarrer une session interactive avec l'ordinateur Server01. La valeur du paramètre SessionOption correspond à une commande New-PSSessionOption associée aux paramètres booléens NoEncryption et NoCompression.

La commande New-PSSessionOption est placée entre parenthèses de façon à être exécutée avant la commande Enter-PSSession.





Exemple 4

C:\PS>$a = new-pssessionoption


MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

C:\PS> $a.UICulture = (get-UICulture)
C:\PS> $a.OpenTimeout = (new-timespan -minutes 4)
C:\PS> $a.MaximumConnectionRedirectionCount = 1

C:\PS> $a

MaximumConnectionRedirectionCount : 1
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         : en-US
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:04:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Description
-----------
Cet exemple montre que vous pouvez modifier l'objet d'option de session. Toutes les propriétés ont des valeurs en lecture/écriture.

Utilisez cette méthode afin de créer un objet session standard pour votre entreprise, puis des versions personnalisées de cet objet pour des usages particuliers.





Exemple 5

C:\PS>$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Description
-----------
Cette commande crée un variable de préférence $PSSessionOption. 

Lorsque la variable de préférence $PSSessionOption existe dans la session, elle établit des valeurs par défaut pour les options des sessions PSSession créées à l'aide des applets de commande New-PSSession, Enter-PSSession et Invoke-Command.

Pour que la variable $PSSessionOption soit disponible dans toutes les sessions, ajoutez-la à votre session et votre profil Windows PowerShell.

Pour plus d'informations sur la variable $PSSessionOption, consultez about_Preference_Variables. Pour plus d'informations sur les profils, consultez about_Profiles.





Exemple 6

C:\PS>$skipCN = new-pssessionoption -SkipCNCheck

C:\PS> new-pssession -computername 171.09.21.207 -UseSSL -credential domain01\user01 -sessionOption $skipCN

Description
-----------
Cet exemple indique comment utiliser un objet SessionOption afin de remplir les conditions requises pour une configuration de session à distance.

La première commande utilise l'applet de commande New-PSSessionOption pour créer un objet d'option de session avec la propriété SkipCNCheck. Elle enregistre l'objet de session résultant dans la variable $skipCN.

La deuxième commande fait appel à l'applet de commande New-PSSession pour créer une nouvelle session PSSession sur un ordinateur distant. La variable de contrôle $skipCN est employée dans la valeur du paramètre SessionOption. 

Étant donné que l'ordinateur est identifié par son adresse IP, la valeur du paramètre ComputerName ne correspond à aucun nom commun figurant dans le certificat utilisé pour SSL (Secure Sockets Layer). Par conséquent, l'option SkipCNCheck est obligatoire.





Voir aussi

Concepts

Enter-PSSession
New-PSSession
Invoke-Command