New-CimSession

  • Ссылка
Модуль:
CimCmdlets

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

Синтаксис

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

Описание

Этот командлет доступен только на платформе Windows.

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

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

Примеры

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

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

New-CimSession

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

В этом примере создается сеанс CIM на компьютере, указанном в computerName. По умолчанию создается сеанс WSMan при указании New-CimSession 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

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

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

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

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) предназначена для команд, требующих проверки подлинности на нескольких ресурсах, таких как доступ к удаленному сетевому ресурсу. Этот механизм повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, учетные данные, передаваемые ему, могут использоваться для управления сетевым сеансом.

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

-CertificateThumbprint

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

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

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

Дополнительные сведения см. в about_Certificate_Provider.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

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

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

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

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

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

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

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

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

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

Type:PSCredential
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

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

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

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

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Port

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

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

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

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

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

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SessionOption

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

Type:CimSessionOptions
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SkipTestConnection

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

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

None

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

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

CimSession

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

Примечания

PowerShell включает следующие псевдонимы для New-CimSession:

  • Windows:
    • ncms

Этот командлет доступен только на платформах Windows.