New-CimSession

Модуль:

CimCmdlets Module

Создает сеанс CIM.

Синтаксис

CredentialParameterSet (По умолчанию)

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>]

Описание

Командлет New-CimSession создает сеанс CIM. Сеанс CIM — это клиентский объект, представляющий подключение к локальному компьютеру или удаленному компьютеру. Сеанс CIM содержит сведения о подключении, например Имя_компьютера, используемый протокол или различные идентификаторы.

Этот командлет возвращает объект сеанса CIM, который можно использовать всеми другими командлетами CIM.

Примеры

Пример 1. Создание сеанса CIM с параметрами по умолчанию

В этом примере создается локальный сеанс CIM с параметрами по умолчанию. Если Имя_компьютера не задано, New-CimSession создает сеанс DCOM на локальном компьютере.

New-CimSession

Пример 2. Создание сеанса CIM на определенном компьютере

В этом примере создается сеанс CIM на компьютере, указанном ComputerName. По умолчанию New-CimSession создает сеанс WSMan при указании ComputerName.

New-CimSession -ComputerName Server01

Пример 3. Создание сеанса CIM на нескольких компьютерах

В этом примере создается сеанс CIM для каждого компьютера, указанного ComputerName, в разделенном запятыми списке.

New-CimSession -ComputerName Server01, Server02, Server03

Пример 4. Создание сеанса CIM с понятным именем

В этом примере создается удаленный сеанс CIM для каждого из компьютеров, указанных в списке, разделенном запятыми, с использованием ComputerName, и сеансам присваивается понятное имя, используя Имя.

New-CimSession -ComputerName Server01, Server02 -Name FileServers
Get-CimSession -Name File*

Понятное имя сеанса CIM можно использовать для ссылки на сеанс в других командлетах CIM, например Get-CimSession.

Пример 5. Создание сеанса CIM на компьютере с помощью объекта PSCredential

В этом примере создается сеанс CIM на компьютере, указанном в ComputerName, используя объект PSCredential, указанный в учетных данных, и тип аутентификации, указанный в аутентификации.

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

Можно создать объект PSCredential с помощью командлета Get-Credential.

Пример 6. Создание сеанса CIM на компьютере с помощью определенного порта

В этом примере создается сеанс CIM для компьютера, указанного ComputerName, с использованием TCP-порта, указанного Port.

New-CimSession -ComputerName Server01 -Port 1234

Пример 7. Создание сеанса CIM с помощью DCOM

В этом примере создается сеанс CIM с помощью протокола распределенного COM (DCOM) вместо WSMan.

$SessionOption = New-CimSessionOption -Protocol Dcom
New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Параметры

-Authentication

Указывает тип проверки подлинности, используемый для учетных данных пользователя. Допустимые значения для этого параметра:

• По умолчанию
• дайджест
• Вести переговоры
• Базовый
• Kerberos
• NtlmDomain
• CredSsp

Для подключения к локальному компьютеру нельзя использовать тип проверки подлинности NtlmDomain. CredSSP проверка подлинности доступна только в Windows Vista, Windows Server 2008 и более поздних версиях Windows.

Осторожность

Проверка подлинности поставщика служб безопасности учетных данных (CredSSP) предназначена для команд, требующих проверки подлинности на нескольких ресурсах, таких как доступ к удаленному сетевому ресурсу. Этот механизм повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, учетные данные, передаваемые ему, можно использовать для управления сетевым сеансом.

Свойства параметров

Тип:	PasswordAuthenticationMechanism
Default value:	None
Допустимые значения:	Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

CredentialParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-CertificateThumbprint

Указывает сертификат цифрового открытого ключа (X.509) учетной записи пользователя, которая имеет разрешение на выполнение этого действия. Введите отпечаток пальца сертификата.

Сертификаты используются в аутентификации, основанной на клиентских сертификатах. Их можно сопоставить только с локальными учетными записями пользователей; Они не работают с учетными записями домена.

Чтобы получить отпечаток сертификата, используйте командлеты Get-Item или Get-ChildItem в поставщике сертификатов PowerShell.

Для получения дополнительной информации см. about_Certificate_Provider.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

CertificateParameterSet

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ComputerName

Указывает имя компьютера, на котором создается сеанс CIM. Укажите имя одного компьютера или несколько имен компьютеров, разделенных запятой.

Если параметр ComputerName не указан, создается сеанс CIM на локальном компьютере. Можно указать значение имени компьютера в одном из следующих форматов:

• Одно или несколько имен NetBIOS
• Один или несколько IP-адресов
• Одно или несколько полностью определённых доменных имен.

Если компьютер находится в домене, отличном от пользователя, необходимо указать полное доменное имя.

Свойства параметров

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Китай, Имя сервера

Наборы параметров

(All)

Position:	1
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Credential

Указывает учетную запись пользователя, которая имеет разрешение на выполнение этого действия. Если учетные данные не указаны, используется текущая учетная запись пользователя.

Укажите значение для учетных данных , используя один из следующих форматов:

• Имя пользователя: User01
• Доменное имя и имя пользователя: Domain01\User01
• Основное имя пользователя: "User@Domain.com"
• Объект PSCredential, например, возвращаемый командлетом Get-Credential.

При вводе имени пользователя вам будет предложено ввести пароль.

Свойства параметров

Тип:	PSCredential
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

CredentialParameterSet

Position:	2
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Name

Указывает дружественное имя для сеанса CIM.

Имя можно использовать для ссылки на сеанс CIM при использовании других командлетов, таких как командлет Get-CimSession. Имя не обязательно должно быть уникальным для компьютера или текущего сеанса.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-OperationTimeoutSec

Длительность, в течение которой командлет ожидает ответа от сервера.

По умолчанию значение этого параметра равно 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера.

Если параметр OperationTimeoutSec имеет значение меньше времени ожидания надежного повтора подключения в 3 минуты, сетевые сбои, длящиеся дольше, чем значение параметра OperationTimeoutSec, не подлежат восстановлению, так как время операции на сервере истекает до того, как клиент успевает переподключиться.

Свойства параметров

Тип:	UInt32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	OT

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Port

Указывает сетевой порт на удаленном компьютере, используемом для этого подключения. Чтобы подключиться к удаленному компьютеру, удаленный компьютер должен прослушивать порт, используемый подключением. Порты по умолчанию : 5985 (порт WinRM для HTTP) и 5986 (порт WinRM для HTTPS).

Перед использованием альтернативного порта необходимо настроить прослушиватель WinRM на удаленном компьютере, чтобы прослушивать этот порт. Чтобы настроить прослушиватель, используйте следующие команды:

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

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

Не используйте параметр порта , если вы не должны. Параметр порта в команде применяется ко всем компьютерам или сеансам, на которых выполняется команда. Альтернативный параметр порта может предотвратить выполнение команды на всех компьютерах.

Свойства параметров

Тип:	UInt32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-SessionOption

Задает дополнительные параметры для нового сеанса CIM. Введите имя объекта CimSessionOption, созданного с помощью командлета New-CimSessionOption.

Свойства параметров

Тип:	CimSessionOptions
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-SkipTestConnection

По умолчанию командлет New-CimSession устанавливает подключение к удаленной конечной точке WS-Management по двум причинам: чтобы убедиться, что удаленный сервер прослушивает номер порта, указанный с помощью параметра порта, и проверить указанные учетные данные учетной записи. Проверка выполняется с помощью стандартной операции WS-Identity. Можно добавить параметр переключателя SkipTestConnection, если удаленная конечная точка WS-Management не может использовать WS-Identify или сократить время передачи данных.

Свойства параметров

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

None

Невозможно передать объекты в этот командлет.

Выходные данные

CimSession

Этот командлет возвращает объект сеанса CIM.

Связанные ссылки

• Get-ChildItem
• Get-Credential
• Get-Item
• Get-CimSession
• Удалить-CimSession
• New-CimSessionOption
• Сведения о CimSession