New-CimSession
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
Tato rutina je dostupná jenom na platformě Windows.
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í, jako je ComputerName, použitý protokol nebo různé identifikátory.
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
Tento příklad 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.
New-CimSession
Příklad 2: Vytvoření relace CIM pro konkrétní počítač
Tento příklad vytvoří relaci CIM s počítačem určeným jako ComputerName.
Ve výchozím nastavení New-CimSession vytvoří relaci WSMan při zadání Název_počítače.
New-CimSession -ComputerName Server01
Příklad 3: Vytvoření relace CIM pro více počítačů
Tento příklad vytvoří relaci CIM pro každý z počítačů určených ComputerName, v seznamu odděleném čárkami.
New-CimSession -ComputerName Server01,Server02,Server03
Příklad 4: Vytvoření relace CIM s přátelským názvem
Tento příklad vytvoří vzdálenou relaci CIM pro každý z počítačů uvedených v seznamu odděleném čárkami podle ComputerNamea přiřadí popisný název novým relacím zadáním Název.
New-CimSession -ComputerName Server01,Server02 -Name FileServers
Get-CimSession -Name File*
Popisný název relace CIM můžete použít k odkazování na relaci v jiných rutinách CIM, například Get-CimSession.
Příklad 5: Vytvoření relace CIM k počítači pomocí objektu PSCredential
Tento příklad vytvoří relaci CIM k počítači určenému ComputerNamepomocí objektu PSCredential zadanými přihlašovacími údaji Credentiala typ ověřování zadaný Authentication.
New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate
Pomocí rutiny můžete vytvořit objekt Get-Credential.
Příklad 6: Vytvoření relace CIM pro počítač pomocí konkrétního portu
Tento příklad vytvoří relaci CIM k počítači určenému jako ComputerName, za použití portu TCP specifikovaného jako Port.
New-CimSession -ComputerName Server01 -Port 1234
Příklad 7: Vytvoření relace CIM pomocí modelu DCOM
Tento příklad vytvoří relaci CIM pomocí protokolu DCOM (Distributed COM) místo WSMan.
$SessionOption = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server1 -SessionOption $SessionOption
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
Pro připojení k místnímu počítači nelze použít typ ověřování NtlmDomain. Ověřování CredSSP je k dispozici pouze v systémech Windows Vista, Windows Server 2008 a v novějších verzích systému Windows.
Upozornění
Ověřování CredSSP (Credential Security Service Provider, poskytovatel zabezpečených služeb ověřování) je určeno pro příkazy, které vyžadují ověřování 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 |
| Přípustné hodnoty: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
| 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 naleznete v tématu about_Certificate_Provider.
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.
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 odkazování na relaci CIM při použití jiných rutin, například rutiny 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ý 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
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.
Vstupy
None
Tato rutina nepřijímá žádné vstupy.