New-CimSessionOption
Hiermee geeft u geavanceerde opties voor de cmdlet New-CimSession.
Syntax
New-CimSessionOption
[-Protocol] <ProtocolType>
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
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>]
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 de WsMan-sessieopties.
Voorbeelden
Voorbeeld 1: Creatie een CIM-sessieoptiesobject 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 zijn gedefinieerd in de variabele.
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so
Voorbeeld 2: Creatie een CIM-sessieoptiesobject 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.
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl
Voorbeeld 3: Creatie een CIM-sessieoptiesobject 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 Cultuur .
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 indelingen:
- Een cultuurnaam in
<languagecode2>-<country/regioncode2>
de indeling 'EN-US'. - Een variabele die een CultureInfo-object bevat.
- Een opdracht waarmee een CultureInfo-object wordt opgehaald, zoals Get-Culture
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Encoding
Hiermee geeft u de codering die wordt gebruikt voor het WsMan-protocol. De acceptabele waarden voor deze parameter zijn: Standaard, Utf8 of Utf16.
Type: | PacketEncoding |
Accepted values: | Default, Utf8, Utf16 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HttpPrefix
Hiermee geeft u het deel van de HTTP-URL na de computernaam en poortnummer. Dit is niet gebruikelijk. Standaard is de waarde van deze parameter /wsman.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Impersonation
Hiermee maakt u een DCOM-sessie naar Windows Management Instrumentation (WMI) met behulp van imitatie.
Geldige waarden voor deze parameter zijn:
- Standaardinstelling: 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.
- Imiteren: hiermee kunnen objecten de referenties van de aanroeper gebruiken.
- Delegeren: hiermee kunnen objecten toestaan dat andere objecten de referenties van de aanroeper gebruiken.
Als imitatie niet is opgegeven, gebruikt de New-CimSession
cmdlet de waarde Imiteren.
Type: | ImpersonationType |
Accepted values: | Default, None, Identify, Impersonate, Delegate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxEnvelopeSizeKB
Hiermee geeft u de groottelimiet van WsMan XML-berichten voor beide richtingen.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoEncryption
Hiermee geeft u op dat gegevensversleuteling is uitgeschakeld.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 met DCOM zijn gemaakt, de parameter PacketIntegrity ingesteld op True.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PacketPrivacy
Hiermee maakt u een DCOM-sessie naar WMI met behulp van de COM PacketPrivacy. Standaard is voor alle CIM-sessies die met DCOM zijn gemaakt, de parameter PacketPrivacy ingesteld op true.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
Hiermee geeft u het protocol te gebruiken. De acceptabele waarden voor deze parameter zijn: DCOM, Default of Wsman.
Type: | ProtocolType |
Accepted values: | Dcom, Default, Wsman |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyAuthentication
Hiermee geeft u de verificatiemethode die moet worden gebruikt voor proxyomzetting. De acceptabele waarden voor deze parameter zijn: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain of CredSsp.
Type: | PasswordAuthenticationMechanism |
Accepted values: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
cmdlets of Get-ChildItem
in het PowerShell-certificaat: station.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Hiermee geeft u de referenties die moeten worden gebruikt voor proxyverificatie. Voer een van de volgende opties 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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | ProxyType |
Accepted values: | None, WinHttp, Auto, InternetExplorer |
Position: | Named |
Default value: | InternetExplorer |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 wanneer de externe computer wordt vertrouwd met behulp van 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 voor externe bewerkingen alleen met vertrouwde computers die gebruikmaken van het HTTPS-protocol.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipRevocationCheck
Geeft aan dat de intrekkingscontrole voor servercertificaten is overgeslagen. Gebruik deze parameter alleen voor vertrouwde computers.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 indelingen:
- Een cultuurnaam in
<languagecode2>-<country/regioncode2>
de indeling 'EN-US'. - Een variabele die een CultureInfo-object bevat.
- Een opdracht waarmee een CultureInfo-object wordt opgehaald, zoals
Get-Culture
.
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseSsl
Geeft aan dat SSL moet worden gebruikt om een verbinding met de externe computer tot stand te brengen. Standaard wordt SSL 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 in plaats van HTTP opgeven. Als SSL niet beschikbaar is op de poort die wordt gebruikt voor de verbinding en u deze parameter opgeeft, mislukt de opdracht.
U wordt aangeraden deze parameter alleen te gebruiken wanneer de parameter PacketPrivacy niet is opgegeven.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Invoerwaarden
None
U kunt geen objecten doorspezen naar deze cmdlet.
Uitvoerwaarden
Deze cmdlet retourneert een object 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.