New-CimSessionOption

Syntaxis

ProtocolTypeSet (Standaard)

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

Voorbeelden

Voorbeeld 1: Een CIM-sessieoptiesobject maken voor DCOM

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

Voorbeeld 2: Een CIM-sessieoptiesobject maken voor WsMan

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

Voorbeeld 3: Een CIM-sessieoptiesobject maken met de opgegeven cultuur

New-CimSessionOption -Culture fr-FR -Protocol Wsman

Parameters

-Culture

Specificeer de cultuur van de gebruikersinterface voor de CIM-sessie. Geef de waarde voor deze parameter op met een van de volgende notaties:

• Een cultuurnaam in <languagecode2>-<country/regioncode2> indeling, zoals 'en-US'.
• Een variabele die een CultureInfo-object bevat.
• Een opdracht waarmee een CultureInfo--object wordt opgehaald, zoals Get-Culture-

Parametereigenschappen

Parametersets

-EncodePortInServicePrincipalName

Geeft aan dat de Kerberos-verbinding verbinding maakt met een service waarvan de SPN (Service Principal Name) het servicepoortnummer bevat. Dit type verbinding is niet gebruikelijk.

Parametereigenschappen

Parametersets

-Encoding

Hiermee geeft u de codering die wordt gebruikt voor het WsMan-protocol. De acceptabele waarden voor deze parameter zijn: Default, Utf8of Utf16.

Parametereigenschappen

Parametersets

-HttpPrefix

Hiermee geeft u het deel van de HTTP-URL na de computernaam en het poortnummer. Het is niet gebruikelijk om dit te veranderen. De waarde van deze parameter is standaard /wsman.

Parametereigenschappen

Parametersets

-Impersonation

Hiermee maakt u een DCOM-sessie voor Windows Management Instrumentation (WMI) met behulp van imitatie.

Geldige waarden voor deze parameter zijn:

• Standaard: DCOM kan het imitatieniveau kiezen met behulp van het normale algoritme voor beveiligingsonderhandeling.
• Geen: De client is anoniem voor de server. Het serverproces kan de client imiteren, maar het imitatietoken bevat geen informatie en kan niet worden gebruikt.
• Identificeren: Hiermee kunnen objecten query's uitvoeren op de referenties van de aanroeper.
• Impersoneren: Hiermee kunnen objecten de referenties van de aanroeper gebruiken.
• Gemachtigde: Hiermee kunnen objecten andere objecten toestaan om de referenties van de aanroeper te gebruiken.

Als Individuatie niet is opgegeven, gebruikt cmdlet New-CimSession de waarde van de individuatie .

Parametereigenschappen

Parametersets

-MaxEnvelopeSizeKB

Hiermee geeft u de groottelimiet van WsMan XML-berichten voor beide richtingen.

Parametereigenschappen

Parametersets

-NoEncryption

Hiermee geeft u op dat gegevensversleuteling is uitgeschakeld.

Parametereigenschappen

Parametersets

-PacketIntegrity

Hiermee geeft u op dat de DCOM-sessie die is gemaakt voor WMI gebruikmaakt van com (Component Object Model) PacketIntegrity functionaliteit. Standaard zijn voor alle CIM-sessies die zijn gemaakt met DCOM de parameter PacketIntegrity ingesteld op True.

Parametereigenschappen

Parametersets

-PacketPrivacy

Maakt een DCOM-sessie voor WMI met de COM PacketPrivacy. Standaard zijn voor alle CIM-sessies die zijn gemaakt met DCOM de parameter PacketPrivacy ingesteld op true.

Parametereigenschappen

Parametersets

-Protocol

Geeft het protocol op dat moet worden gebruikt. De acceptabele waarden voor deze parameter zijn: Dcom, Defaultof Wsman.

Parametereigenschappen

Parametersets

-ProxyAuthentication

Hiermee geeft u de verificatiemethode op die gebruikt moet worden voor proxyresolutie. De acceptabele waarden voor deze parameter zijn: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomainof CredSsp.

Parametereigenschappen

Parametersets

-ProxyCertificateThumbprint

Hiermee specificeert u het (x.509) digitale openbare sleutelcertificaat van een gebruikersaccount voor proxy-authenticatie. Voer de vingerafdruk van het certificaat in. Certificaten worden gebruikt in verificatie op basis van clientcertificaten. Ze kunnen alleen worden toegewezen aan lokale gebruikersaccounts en ze werken niet met domeinaccounts.

Als u een certificaatvingerafdruk wilt ophalen, gebruikt u de Get-Item- of Get-ChildItem-cmdlets in de PowerShell Cert: drive.

Parametereigenschappen

Parametersets

-ProxyCredential

Hiermee specificeert u de inloggegevens die moeten worden gebruikt voor proxyverificatie. Voer een van de volgende handelingen in:

• Een variabele die een PSCredential-object bevat.
• Een opdracht waarmee een PSCredential-object wordt opgehaald, zoals Get-Credential

Als deze optie niet is ingesteld, kunt u geen referenties opgeven.

Parametereigenschappen

Parametersets

-ProxyType

Specificeert het te gebruiken mechanisme voor hostnaamomzetting. De acceptabele waarden voor deze parameter zijn: None, WinHttp, Autoof InternetExplorer.

De standaardwaarde van deze parameter is InternetExplorer-.

Parametereigenschappen

Parametersets

-SkipCACheck

Geeft aan dat bij het maken van verbinding via HTTPS de client niet valideert dat het servercertificaat is ondertekend door een vertrouwde certificeringsinstantie (CA).

Gebruik deze parameter alleen als de externe computer wordt vertrouwd met een ander mechanisme, zoals wanneer de externe computer deel uitmaakt van een netwerk dat fysiek veilig en geïsoleerd is, of wanneer de externe computer wordt vermeld als een vertrouwde host in een WinRM-configuratie.

Parametereigenschappen

Parametersets

-SkipCNCheck

Geeft aan dat de algemene naam van het certificaat (CN) van de server niet hoeft overeen te komen met de hostnaam van de server. Gebruik deze parameter alleen voor externe bewerkingen met vertrouwde computers die gebruikmaken van het HTTPS-protocol.

Parametereigenschappen

Parametersets

-SkipRevocationCheck

Geeft aan dat de intrekkingscontrole voor servercertificaten wordt overgeslagen. Gebruik deze parameter alleen voor vertrouwde computers.

Parametereigenschappen

Parametersets

-UICulture

Specificeer de cultuur van de gebruikersinterface voor de CIM-sessie. Geef de waarde voor deze parameter op met een van de volgende notaties:

• Een cultuurnaam in <languagecode2>-<country/regioncode2> indeling, zoals 'en-US'.
• Een variabele die een CultureInfo-object bevat.
• Een opdracht waarmee een CultureInfo-object wordt opgehaald, zoals Get-Culture.

Parametereigenschappen

Parametersets

-UseSsl

Geeft aan dat SSL moet worden gebruikt om een verbinding tot stand te brengen met de externe computer. SSL wordt standaard niet gebruikt. WsMan versleutelt alle inhoud die via het netwerk wordt verzonden, zelfs wanneer http wordt gebruikt.

Met deze parameter kunt u de extra beveiliging van HTTPS opgeven in plaats van HTTP. Als SSL niet beschikbaar is op de poort die wordt gebruikt voor de verbinding en u deze parameter opgeeft, mislukt de opdracht.

Het wordt aanbevolen deze parameter alleen te gebruiken wanneer de parameter PacketPrivacy niet is opgegeven.

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

None

Uitvoerwaarden

CimSessionOptions

Notities

Verwante koppelingen

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