New-CimSession

Modul:: CimCmdlets Module

Vytvoří relaci CIM.

Syntax

CredentialParameterSet (Výchozí)

New-CimSession
    [[-Credential] <PSCredential>]
    [[-ComputerName] <String[]>]
    [-Authentication <PasswordAuthenticationMechanism>]
    [-Name <String>]
    [-OperationTimeoutSec <UInt32>]
    [-SkipTestConnection]
    [-Port <UInt32>]
    [-SessionOption <CimSessionOptions>]
    [<CommonParameters>]

CertificateParameterSet

New-CimSession
    [[-ComputerName] <String[]>]
    [-CertificateThumbprint <String>]
    [-Name <String>]
    [-OperationTimeoutSec <UInt32>]
    [-SkipTestConnection]
    [-Port <UInt32>]
    [-SessionOption <CimSessionOptions>]
    [<CommonParameters>]

Description

Cmdlet New-CimSession vytvoří relaci CIM. Session CIM je objekt na straně klienta, který reprezentuje připojení k místnímu nebo vzdálenému počítači. Relace CIM obsahuje informace o připojení, například ComputerName, protokol použitý pro připojení, ID relace a ID instance.

Tato rutina vrátí objekt relace CIM, který může používat všechny ostatní rutiny CIM.

Příklady

Příklad 1: Vytvoření relace CIM s výchozími možnostmi

New-CimSession

Tento příkaz vytvoří místní relaci CIM s výchozími možnostmi. Pokud není zadán ComputerName, New-CimSession vytvoří relaci DCOM na místním počítači.

Příklad 2: Vytvoření relace CIM pro konkrétní počítač

New-CimSession -ComputerName Server01

Tento příkaz vytvoří relaci CIM k počítači určenému ComputerName. Ve výchozím nastavení New-CimSession vytvoří relaci WsMan při ComputerName je zadán.

Příklad 3: Vytvoření relace CIM pro více počítačů

New-CimSession -ComputerName Server01,Server02,Server03

Tento příkaz vytvoří relaci CIM pro každý počítač určený ComputerNamev seznamu odděleném čárkami.

Příklad 4: Vytvoření relace CIM s přátelským názvem

Popisný název relace CIM můžete použít k snadnému odkazování na relaci v jiných rutinách CIM, například Get-CimSession.

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

Tento příkaz vytvoří vzdálenou relaci CIM pro všechny počítače určené ComputerName, v seznamu odděleném čárkami a přiřadí popisný název k novým relacím zadáním Název.

Příklad 5: Vytvoření relace CIM k počítači pomocí objektu PSCredential

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

Tento příkaz vytvoří relaci CIM k počítači určenému ComputerNamepomocí objektu PSCredential určenéhopřihlašovacích údajů a typ ověřování zadaný Ověřování.

Objekt PSCredential můžete vytvořit pomocí rutiny Get-Credential.

Příklad 6: Vytvoření relace CIM pro počítač pomocí konkrétního portu

New-CimSession -ComputerName Server01 -Port 1234

Tento příkaz vytvoří relaci CIM k počítači určenému ComputerName pomocí portu TCP určeného Port.

Příklad 7: Vytvoření relace CIM pomocí modelu DCOM

$SessionOption = New-CimSessionOption -Protocol DCOM

New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Tento příkaz vytvoří relaci CIM pomocí protokolu DCOM (Distributed COM) místo WSMan.

Parametry

-Authentication

Určuje typ ověřování, který se používá pro přihlašovací údaje uživatele. Přijatelné hodnoty pro tento parametr jsou:

Výchozí
Přehled
Vyjednávat
Basic
Kerberos
NtlmDomain
CredSsp

Typ ověřování NtlmDomain nelze použít pro připojení k místnímu počítači. Ověřování CredSSP je k dispozici pouze v systémech Windows Vista, Windows Server 2008 a novějších verzích systému Windows.

Upozornění: Ověřování zprostředkovatele služby CredSSP (Credential Security Service Provider), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači, který se má ověřit, je určený pro příkazy, které vyžadují ověření u více než jednoho prostředku, například pro přístup ke vzdálené síťové sdílené složce. Tento mechanismus zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, dají se k řízení síťové relace použít přihlašovací údaje, které jsou mu předány.

Vlastnosti parametru

Typ:	PasswordAuthenticationMechanism
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

CredentialParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-CertificateThumbprint

Určuje certifikát digitálního veřejného klíče (X.509) uživatelského účtu, který má oprávnění k provedení této akce. Zadejte kryptografický otisk certifikátu.

Certifikáty se používají při ověřování na základě klientských certifikátů. Mohou být mapovány pouze na místní uživatelské účty; nefungují s doménovými účty.

Pokud chcete získat kryptografický otisk certifikátu, použijte rutiny Get-Item nebo Get-ChildItem ve zprostředkovateli certifikátu PowerShellu. Další informace o použití zprostředkovatele certifikátu PowerShellu, typ nebo naleznete v tématuzprostředkovatel certifikátu .

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

CertificateParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ComputerName

Určuje název počítače, do kterého se má vytvořit relace CIM. Zadejte název jednoho počítače nebo několik názvů počítačů oddělených čárkou.

Pokud není zadaný ComputerName, vytvoří se relace CIM k místnímu počítači.

Hodnotu názvu počítače můžete zadat v jednom z následujících formátů:

Jeden nebo více názvů rozhraní NetBIOS
Jedna nebo více IP adres
Jeden nebo více plně kvalifikovaných názvů domén.

Pokud je počítač v jiné doméně než uživatel, musíte zadat plně kvalifikovaný název domény.

Můžete také předat název počítače (v uvozovkách) New-CimSession pomocí kanálu.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Čína, Název serveru

Sady parametrů

(All)

Position:	1
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Pokud není specifikováno Credential, použije se aktuální uživatelský účet.

Zadejte hodnotu přihlašovacích údajů pomocí jednoho z následujících formátů:

Uživatelské jméno: User01
Název domény a uživatelské jméno: Domain01\User01
Hlavní název uživatele: "User@Domain.com"
Objekt PSCredential, například objekt vrácený rutinou Get-Credential.

Když zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

CredentialParameterSet

Position:	2
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Určuje přátelský název relace CIM.

Název můžete použít k odkazu na relaci CIM při použití jiných rutin, jako je například rutina Get-CimSession. Název nemusí být jedinečný pro počítač nebo současné sezení.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-OperationTimeoutSec

Doba trvání, po kterou rutina čeká na odpověď ze serveru.

Ve výchozím nastavení je hodnota tohoto parametru 0, což znamená, že rutina používá výchozí hodnotu časového limitu pro server.

Pokud je parametr OperationTimeoutSec nastaven na hodnotu menší než robustní časový limit opakování připojení 3 minuty, selhání sítě, která trvala více než hodnota parametru OperationTimeoutSec, není možné obnovit, protože operace na serveru vyprší, než se klient může znovu připojit.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	OT

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Port

Určuje síťový port na vzdáleném počítači, který se používá pro toto připojení. Pokud se chcete připojit ke vzdálenému počítači, musí vzdálený počítač naslouchat na portu, který připojení používá. Výchozí porty jsou 5985 (port WinRM pro HTTP) a 5986 (port WinRM pro HTTPS).

Před použitím alternativního portu musíte nakonfigurovat naslouchací proces WinRM na vzdáleném počítači tak, aby naslouchal na tomto portu. Ke konfiguraci naslouchacího procesu použijte následující příkazy:

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

Nepoužívejte parametr Port, pokud není nutné. Nastavení portu v příkazu platí pro všechny počítače nebo relace, na kterých se příkaz spouští. Alternativní nastavení portu může zabránit spuštění příkazu na všech počítačích.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SessionOption

Nastaví pokročilé možnosti pro novou relaci CIM. Zadejte název objektu CimSessionOption vytvořeného pomocí rutiny New-CimSessionOption.

Vlastnosti parametru

Typ:	CimSessionOptions
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SkipTestConnection

Rutina New-CimSession ve výchozím nastavení vytvoří připojení ke vzdálenému koncovému bodu WS-Management ze dvou důvodů: ověření, že vzdálený server naslouchá na čísle portu zadaném pomocí parametru Port a ověření zadaných přihlašovacích údajů účtu. Ověření se provádí pomocí standardní operace WS-Identity. Parametr přepínače SkipTestConnection můžete přidat, pokud vzdálený koncový bod WS-Management nemůže použít WS-Identify nebo pokud chcete zkrátit dobu přenosu dat.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Sdílet prostřednictvím

New-CimSession

Syntax

CredentialParameterSet (Výchozí)

CertificateParameterSet

Description

Příklady

Příklad 1: Vytvoření relace CIM s výchozími možnostmi

Příklad 2: Vytvoření relace CIM pro konkrétní počítač

Příklad 3: Vytvoření relace CIM pro více počítačů

Příklad 4: Vytvoření relace CIM s přátelským názvem

Příklad 5: Vytvoření relace CIM k počítači pomocí objektu PSCredential

Příklad 6: Vytvoření relace CIM pro počítač pomocí konkrétního portu

Příklad 7: Vytvoření relace CIM pomocí modelu DCOM

Parametry

-Authentication

Vlastnosti parametru

Sady parametrů

-CertificateThumbprint

Vlastnosti parametru

Sady parametrů

-ComputerName

Vlastnosti parametru

Sady parametrů

-Credential

Vlastnosti parametru

Sady parametrů

-Name

Vlastnosti parametru

Sady parametrů

-OperationTimeoutSec

Vlastnosti parametru

Sady parametrů

-Port

Vlastnosti parametru

Sady parametrů

-SessionOption

Vlastnosti parametru

Sady parametrů

-SkipTestConnection

Vlastnosti parametru

Sady parametrů

CommonParameters

Vstupy

None

Výstupy

CimSession

Související odkazy