New-CimSessionOption

Hiermee geeft u geavanceerde opties voor de New-CimSession cmdlet.

Syntax

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De New-CimSessionOption cmdlet maakt een exemplaar van een CIM-sessieoptiesobject. U gebruikt een CIM-sessieoptiesobject als invoer voor de New-CimSession cmdlet om de opties voor een CIM-sessie op te geven.

Deze cmdlet heeft twee parametersets, één voor WsMan-opties en één voor DCOM-opties (Distributed Component Object Model). Afhankelijk van de parameters die u gebruikt, retourneert de cmdlet een exemplaar van DCOM-sessieopties of retourneert WsMan-sessieopties.

Voorbeelden

Voorbeeld 1: Een CIM-sessieoptiesobject maken voor DCOM

In dit voorbeeld wordt een CIM-sessieoptiesobject voor het DCOM-protocol gemaakt en opgeslagen in een variabele met de naam $so. De inhoud van de variabele wordt vervolgens doorgegeven aan de New-CimSession cmdlet. New-CimSession maakt vervolgens een nieuwe CIM-sessie met de externe server met de naam Server01, met behulp van de opties die in de variabele zijn gedefinieerd.

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

Voorbeeld 2: Een CIM-sessieoptiesobject maken voor WsMan

In dit voorbeeld wordt een CIM-sessieoptiesobject gemaakt voor het WsMan-protocol. Het object bevat configuratie voor de verificatiemodus van Kerberos die is opgegeven door de parameter ProxyAuthentication , de referenties die zijn opgegeven door de parameter ProxyCredential , en geeft aan dat de opdracht is om de CA-controle over te slaan, de CN-controle over te slaan en SSL te gebruiken.

$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

In dit voorbeeld wordt de cultuur opgegeven die wordt gebruikt voor de CIM-sessie. Standaard wordt de cultuur van de client gebruikt bij het uitvoeren van bewerkingen. De standaardcultuur kan echter worden overschreven met behulp van de parameter Culture .

Parameters

-Culture

Hiermee geeft u de cultuur van de gebruikersinterface die moet worden gebruikt 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

Type:CultureInfo
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-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

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Encoding

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

Parametereigenschappen

Type:PacketEncoding
Default value:None
Geaccepteerde waarden:Default, Utf8, Utf16
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-HttpPrefix

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

Parametereigenschappen

Type:Uri
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Impersonation

Hiermee maakt u een DCOM-sessie voor Windows WMI (Management Instrumentation) 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.
  • Imitatie: 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 imitatie niet is opgegeven, gebruikt de New-CimSession cmdlet de waarde van imitatie.

Parametereigenschappen

Type:ImpersonationType
Default value:None
Geaccepteerde waarden:Default, None, Identify, Impersonate, Delegate
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DcomParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MaxEnvelopeSizeKB

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

Parametereigenschappen

Type:UInt32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-NoEncryption

Hiermee geeft u op dat gegevensversleuteling is uitgeschakeld.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PacketIntegrity

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DcomParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PacketPrivacy

Hiermee maakt u een DCOM-sessie naar WMI met behulp van de COM PacketPrivacy. Standaard is voor alle CIM-sessies die zijn gemaakt met DCOM de parameter PacketPrivacy ingesteld op true.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DcomParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Protocol

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

Parametereigenschappen

Type:ProtocolType
Default value:None
Geaccepteerde waarden:Dcom, Default, Wsman
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ProtocolTypeSet
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ProxyAuthentication

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

Parametereigenschappen

Type:PasswordAuthenticationMechanism
Default value:None
Geaccepteerde waarden:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ProxyCertificateThumbprint

Hiermee geeft u het (x.509) digitale openbare sleutelcertificaat van een gebruikersaccount voor proxyverificatie. 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 vingerafdruk van een certificaat wilt ophalen, gebruikt u de Get-Item of Get-ChildItem cmdlets in het PowerShell-station Cert: .

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-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

Type:PSCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ProxyType

Hiermee geeft u het mechanisme voor hostnaamomzetting te gebruiken. De acceptabele waarden voor deze parameter zijn: None, WinHttp, Auto of InternetExplorer.

De standaardwaarde van deze parameter is InternetExplorer.

Parametereigenschappen

Type:ProxyType
Default value:InternetExplorer
Geaccepteerde waarden:None, WinHttp, Auto, InternetExplorer
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-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

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-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

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-SkipRevocationCheck

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-UICulture

Hiermee geeft u de cultuur van de gebruikersinterface die moet worden gebruikt 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

Type:CultureInfo
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-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

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

WSManParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

CimSessionOptions

Met deze cmdlet wordt een object geretourneerd dat informatie over CIM-sessieopties bevat.

Notities

PowerShell bevat de volgende aliassen voor New-CimSessionOption:

  • Windows:
    • ncso

Deze cmdlet is alleen beschikbaar op Windows-platforms.