New-CimSessionOption

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

Exemples

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

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

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

$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

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

Jeux de paramètres

-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

Jeux de paramètres

-Encoding

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

Propriétés du paramètre

Jeux de paramètres

-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

Jeux de paramètres

-Impersonation

Crée une session DCOM vers Windows Management Instrumentation (WMI) en utilisant l’usurpation d’identité.

Les valeurs valides pour ce paramètre sont les suivantes :

• 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, tandis que le jeton d'imitation ne contient aucune information et ne peut pas être utilisé.
• Identifier : permet aux objets d’interroger les informations d’identification de l’appelant.
• Impersonate : Permet aux objets d’utiliser les identifiants de l’appelant.
• Délégué : permet aux objets d’autoriser d’autres objets à utiliser les informations d’identification de l’appelant.

Si Impersonation n’est pas spécifié, le cmdlet New-CimSession utilise la valeur de Impersonate.

Propriétés du paramètre

Jeux de paramètres

-MaxEnvelopeSizeKB

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

Propriétés du paramètre

Jeux de paramètres

-NoEncryption

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

Propriétés du paramètre

Jeux de paramètres

-PacketIntegrity

Spécifie que la session DCOM créée pour WMI utilise le modèle d'objet de composant (COM) et la fonctionnalité PacketIntegrity . 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

Jeux de paramètres

-PacketPrivacy

Crée une session DCOM vers WMI en utilisant le 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

Jeux de paramètres

-Protocol

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

Propriétés du paramètre

Jeux de paramètres

-ProxyAuthentication

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

Propriétés du paramètre

Jeux de paramètres

-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 l’empreinte d’un certificat, utilisez les cmdlets Get-Item ou Get-ChildItem dans le lecteur PowerShell Cert:.

Propriétés du paramètre

Jeux de paramètres

-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

Jeux de paramètres

-ProxyType

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

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

Propriétés du paramètre

Jeux de paramètres

-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

Jeux de paramètres

-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

Jeux de paramètres

-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

Jeux de paramètres

-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

Jeux de paramètres

-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

Jeux de paramètres

CommonParameters

Entrées

None

Sorties

CimSessionOptions

Notes

Liens associés

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