New-CimSessionOption

Module:

CimCmdlets Module

Spécifie les options avancées de l’applet de commande New-CimSession.

Syntaxe

ProtocolTypeSet (Par défaut)

New-CimSessionOption
    [-Protocol] <ProtocolType>
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

WSManParameterSet

New-CimSessionOption
    [-NoEncryption]
    [-SkipCACheck]
    [-SkipCNCheck]
    [-SkipRevocationCheck]
    [-EncodePortInServicePrincipalName]
    [-Encoding <PacketEncoding>]
    [-HttpPrefix <Uri>]
    [-MaxEnvelopeSizeKB <UInt32>]
    [-ProxyAuthentication <PasswordAuthenticationMechanism>]
    [-ProxyCertificateThumbprint <String>]
    [-ProxyCredential <PSCredential>]
    [-ProxyType <ProxyType>]
    [-UseSsl]
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

DcomParameterSet

New-CimSessionOption
    [-Impersonation <ImpersonationType>]
    [-PacketIntegrity]
    [-PacketPrivacy]
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

Description

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet New-CimSessionOption de commande crée une instance d’un objet d’options de session CIM. Vous utilisez un objet d’options de session CIM comme entrée à l’applet New-CimSession de commande pour spécifier les options d’une session CIM.

Cette applet de commande a deux jeux de paramètres, un pour les options WsMan et un pour les options DCOM (Distributed Component Object Model). Selon les paramètres que vous utilisez, l’applet de commande retourne une instance d’options de session DCOM ou retourne les options de session WsMan.

Exemples

Exemple 1 : Créer un objet d’options de session CIM pour DCOM

Cet exemple crée un objet d’options de session CIM pour le protocole DCOM et le stocke dans une variable nommée $so. Le contenu de la variable est ensuite transmis à l’applet New-CimSession de commande. New-CimSession crée ensuite une session CIM avec le serveur distant nommé Server01, à l’aide des options définies dans la variable.

$so = New-CimSessionOption -Protocol Dcom
New-CimSession -ComputerName Server01 -SessionOption $so

Exemple 2 : Créer un objet d’options de session CIM pour WsMan

Cet exemple crée un objet d’options de session CIM pour le protocole WsMan. L’objet contient la configuration du mode d’authentification Kerberos spécifié par le paramètre ProxyAuthentication , les informations d’identification spécifiées par le paramètre ProxyCredential et spécifie que la commande consiste à ignorer la vérification de l’autorité de certification, à ignorer la vérification CN et à utiliser SSL.

$option = @{
    ProxyAuthentication = 'Kerberos'
    ProxyCredential = $cred
    SkipCACheck = $true
    SkipCNCheck = $true
    UseSsl = $true
}
New-CimSessionOption @option

Exemple 3 : Créer un objet d’options de session CIM avec la culture spécifiée

New-CimSessionOption -Culture fr-FR -Protocol Wsman

Cet exemple spécifie la culture utilisée pour la session CIM. Par défaut, la culture du client est utilisée lors de l’exécution d’opérations. Toutefois, la culture par défaut peut être remplacée à l’aide du paramètre Culture .

Paramètres

-Culture

Spécifie la culture de l’interface utilisateur à utiliser pour la session CIM. Spécifiez la valeur de ce paramètre à l’aide de l’un des formats suivants :

• Un nom de culture au <languagecode2>-<country/regioncode2> format tel que «en-US».
• Variable qui contient un objet CultureInfo .
• Commande qui obtient un objet CultureInfo , tel que Get-Culture

Propriétés du paramètre

Type:	CultureInfo
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é:	True
Valeur des arguments restants:	False

-EncodePortInServicePrincipalName

Indique que la connexion Kerberos se connecte à un service dont le nom de principal de service (SPN) inclut le numéro de port du service. Ce type de connexion n’est pas courant.

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

WSManParameterSet

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

-Encoding

Spécifie l’encodage utilisé pour le protocole WsMan. Les valeurs acceptables pour ce paramètre sont : Par défaut, Utf8 ou Utf16.

Propriétés du paramètre

Type:	PacketEncoding
Valeur par défaut:	None
Valeurs acceptées:	Default, Utf8, Utf16
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

WSManParameterSet

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

-HttpPrefix

Spécifie la partie de l’URL HTTP après le nom de l’ordinateur et le numéro de port. Le changement n’est pas courant. Par défaut, la valeur de ce paramètre est /wsman.

Propriétés du paramètre

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

Jeux de paramètres

WSManParameterSet

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

-Impersonation

Crée une session DCOM pour Windows Management Instrumentation (WMI) à l’aide de l’emprunt d’identité.

Le paramètre PasswordQuality indique le niveau de qualité minimal imposé aux mots de passe des appareils. La qualité des mots de passe est une échelle numérique qui indique le niveau de sécurité et de complexité du mot de passe. Plus la valeur de qualité est élevée, plus le mot de passe est sécurisé.

• Par défaut : DCOM peut choisir le niveau d’emprunt d’identité à l’aide de son algorithme de négociation de sécurité normal.
• Aucun : le client est anonyme sur le serveur. Le processus serveur peut emprunter l’identité du client, mais le jeton d’emprunt d’identité ne contient aucune information et ne peut pas être utilisé.
• Identifier : permet aux objets d’interroger les informations d’identification de l’appelant.
• Emprunt d’identité : permet aux objets d’utiliser les informations d’identification de l’appelant.
• Délégué : permet aux objets d’autoriser d’autres objets à utiliser les informations d’identification de l’appelant.

Si l’emprunt d’identité n’est pas spécifié, l’applet New-CimSession de commande utilise la valeur d’emprunt d’identité.

Propriétés du paramètre

Type:	ImpersonationType
Valeur par défaut:	None
Valeurs acceptées:	Default, None, Identify, Impersonate, Delegate
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

DcomParameterSet

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

-MaxEnvelopeSizeKB

Spécifie la limite de taille des messages XML WsMan pour les deux directions.

Propriétés du paramètre

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

Jeux de paramètres

WSManParameterSet

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

-NoEncryption

Spécifie que le chiffrement des données est désactivé.

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

WSManParameterSet

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

-PacketIntegrity

Spécifie que la session DCOM créée dans WMI utilise la fonctionnalité PacketIntegrity (Component Object Model) (COM). Par défaut, toutes les sessions CIM créées à l’aide de DCOM ont le paramètre PacketIntegrity défini sur True.

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

DcomParameterSet

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

-PacketPrivacy

Crée une session DCOM sur WMI à l’aide de COM PacketPrivacy. Par défaut, toutes les sessions CIM créées à l’aide de DCOM ont le paramètre PacketPrivacy défini sur true.

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

DcomParameterSet

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

-Protocol

Spécifie le protocole à utiliser. Les valeurs acceptables pour ce paramètre sont : Dcom, Default ou Wsman.

Propriétés du paramètre

Type:	ProtocolType
Valeur par défaut:	None
Valeurs acceptées:	Dcom, Default, Wsman
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ProtocolTypeSet

Position:	1
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-ProxyAuthentication

Spécifie la méthode d’authentification à utiliser pour la résolution de proxy. Les valeurs acceptables pour ce paramètre sont : Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain ou CredSsp.

Propriétés du paramètre

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

Jeux de paramètres

WSManParameterSet

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

-ProxyCertificateThumbprint

Spécifie le certificat de clé publique numérique (x.509) d’un compte d’utilisateur pour l’authentification proxy. Entrez l’empreinte numérique du certificat. Les certificats sont utilisés dans l’authentification basée sur les certificats client. Ils ne peuvent être mappés qu’à des comptes d’utilisateur locaux et ne fonctionnent pas avec des comptes de domaine.

Pour obtenir une empreinte numérique de certificat, utilisez les applets de commande ou Get-Item les Get-ChildItem applets de commande dans le lecteur PowerShellCert:.

Propriétés du paramètre

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

Jeux de paramètres

WSManParameterSet

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

-ProxyCredential

Spécifie les informations d’identification à utiliser pour l’authentification proxy. Entrez l’une des options suivantes :

• Variable qui contient un objet PSCredential.
• Commande qui obtient un objet PSCredential, tel que Get-Credential

Si cette option n’est pas définie, vous ne pouvez pas spécifier d’informations d’identification.

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

WSManParameterSet

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

-ProxyType

Spécifie le mécanisme de résolution de noms d’hôte à utiliser. Les valeurs acceptables pour ce paramètre sont : None, WinHttp, Auto ou InternetExplorer.

La valeur par défaut de ce paramètre est InternetExplorer.

Propriétés du paramètre

Type:	ProxyType
Valeur par défaut:	InternetExplorer
Valeurs acceptées:	None, WinHttp, Auto, InternetExplorer
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

WSManParameterSet

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

-SkipCACheck

Indique 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 ce paramètre uniquement lorsque l’ordinateur distant est approuvé à l’aide d’un autre mécanisme, par exemple lorsque l’ordinateur distant fait partie d’un réseau physiquement sécurisé et isolé, ou lorsque l’ordinateur distant est répertorié comme hôte approuvé dans une configuration WinRM.

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

WSManParameterSet

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

-SkipCNCheck

Indique que le nom commun du certificat du serveur n’a pas besoin de correspondre au nom d’hôte du serveur. Utilisez ce paramètre pour les opérations à distance uniquement avec les ordinateurs approuvés qui utilisent le protocole HTTPS.

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

WSManParameterSet

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

-SkipRevocationCheck

Indique que la vérification de révocation des certificats de serveur est ignorée. Utilisez ce paramètre uniquement 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

WSManParameterSet

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

-UICulture

Spécifie la culture de l’interface utilisateur à utiliser pour la session CIM. Spécifiez la valeur de ce paramètre à l’aide de l’un des formats suivants :

• Un nom de culture au <languagecode2>-<country/regioncode2> format tel que «en-US».
• Variable qui contient un objet CultureInfo.
• Commande qui obtient un objet CultureInfo, tel que Get-Culture.

Propriétés du paramètre

Type:	CultureInfo
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é:	True
Valeur des arguments restants:	False

-UseSsl

Indique que SSL doit être utilisé pour établir une connexion à l’ordinateur distant. Par défaut, SSL n’est pas utilisé. WsMan chiffre tout le contenu transmis sur le réseau, même lors de l’utilisation de HTTP.

Ce paramètre vous permet de spécifier la protection supplémentaire du protocole HTTPS au lieu de HTTP. Si SSL n’est pas disponible sur le port utilisé pour la connexion et que vous spécifiez ce paramètre, la commande échoue.

Il est recommandé d’utiliser ce paramètre uniquement lorsque le paramètre PacketPrivacy n’est pas spécifié.

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

WSManParameterSet

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
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.

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

CimSessionOptions

Cette applet de commande retourne un objet qui contient des informations sur les options de session CIM.

Notes

PowerShell inclut les alias suivants pour New-CimSessionOption:

• Windows :
  • ncso

Cette applet de commande est disponible uniquement sur les plateformes Windows.

Liens associés

• Get-ChildItem
• Get-Credential
• Get-Culture
• Get-Item
• New-CimSession