Поделиться через

New-CimSessionOption

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

Задает дополнительные параметры для командлета New-CimSession.

Синтаксис

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

Описание

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

Командлет New-CimSessionOption создает экземпляр объекта параметров сеанса CIM. Объект параметров сеанса CIM используется в качестве входных данных командлета New-CimSession для указания параметров сеанса CIM.

Этот командлет имеет два набора параметров, один для параметров WsMan и один для параметров распределенной объектной модели компонентов (DCOM). В зависимости от используемых параметров командлет возвращает либо экземпляр параметров сеанса DCOM, либо возвращает параметры сеанса WsMan.

Примеры

Пример 1. Создание объекта параметров сеанса CIM для DCOM

В этом примере создается объект параметров сеанса CIM для протокола DCOM и сохраняет его в переменной с именем $so. Затем содержимое переменной передается командлету New-CimSession . New-CimSession затем создает новый сеанс CIM с удаленным сервером с именем Server01, используя параметры, определенные в переменной.

$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so

Пример 2. Создание объекта параметров сеанса CIM для WsMan

В этом примере создается объект параметров сеанса CIM для протокола WsMan. Объект содержит конфигурацию для режима проверки подлинности Kerberos, указанного параметром ProxyAuthentication, учетными данными, указанными параметром ProxyCredential, и указывает, что команда требует пропуска проверки ЦС, пропускания проверки CN и использования SSL.

New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

Пример 3. Создание объекта параметров сеанса CIM с указанным языком и региональными параметрами

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

В этом примере указывается язык и региональные параметры, используемые для сеанса CIM. По умолчанию язык и региональные параметры клиента используются при выполнении операций. Однако язык и региональные параметры по умолчанию можно переопределить с помощью параметра Culture .

Параметры

-Culture

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

  • Имя языка и региональных параметров в <languagecode2>-<country/regioncode2> формате, например "EN-US".
  • Переменная, содержащая объект CultureInfo .
  • Команда, которая получает объект CultureInfo , например Get-Culture
Тип:CultureInfo
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-EncodePortInServicePrincipalName

Указывает, что подключение Kerberos подключается к службе, имя субъекта-службы (SPN) которого включает номер порта службы. Этот тип подключения не распространен.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Encoding

Задает кодировку, используемую для протокола WsMan. Допустимые значения для этого параметра: default, Utf8 или Utf16.

Тип:PacketEncoding
Допустимые значения:Default, Utf8, Utf16
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-HttpPrefix

Указывает часть URL-адреса HTTP после имени компьютера и номера порта. Изменение этого не распространено. По умолчанию значение этого параметра равно /wsman.

Тип:Uri
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Impersonation

Создает сеанс DCOM в инструментарии управления Windows (WMI) с помощью олицетворения.

Допустимые значения для этого параметра:

  • По умолчанию: DCOM может выбрать уровень олицетворения с помощью обычного алгоритма согласования безопасности.
  • Нет: клиент является анонимным на сервере. Серверный процесс может олицетворить клиента, но маркер олицетворения не содержит никакой информации и не может использоваться.
  • Определение: позволяет объектам запрашивать учетные данные вызывающего объекта.
  • Олицетворения: позволяет объектам использовать учетные данные вызывающего объекта.
  • Делегат. Позволяет объектам разрешать другим объектам использовать учетные данные вызывающего объекта.

Если олицетворение не указано, New-CimSession командлет использует значение олицетворения.

Тип:ImpersonationType
Допустимые значения:Default, None, Identify, Impersonate, Delegate
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MaxEnvelopeSizeKB

Задает ограничение размера XML-сообщений WsMan для любого направления.

Тип:UInt32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-NoEncryption

Указывает, что шифрование данных отключено.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PacketIntegrity

Указывает, что сеанс DCOM, созданный для WMI, использует функцию packetIntegrity для объектной модели компонента (COM). По умолчанию все сеансы CIM, созданные с помощью DCOM, имеют параметр PacketIntegrity значение True.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PacketPrivacy

Создает сеанс DCOM для WMI с помощью COM PacketPrivacy. По умолчанию все сеансы CIM, созданные с помощью DCOM, имеют для параметра PacketPrivacy значение true.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Protocol

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

Тип:ProtocolType
Допустимые значения:Dcom, Default, Wsman
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ProxyAuthentication

Указывает метод проверки подлинности, используемый для разрешения прокси-сервера. Допустимые значения этого параметра: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain или CredSsp.

Тип:PasswordAuthenticationMechanism
Допустимые значения:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ProxyCertificateThumbprint

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

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ProxyCredential

Задает учетные данные, используемые для аутентификации прокси-сервера. Введите одно из следующих значений.

  • Переменная, содержащая объект PSCredential.
  • Команда, которая получает объект PSCredential, например Get-Credential

Если этот параметр не задан, нельзя указать учетные данные.

Тип:PSCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ProxyType

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

Значением по умолчанию этого параметра является InternetExplorer.

Тип:ProxyType
Допустимые значения:None, WinHttp, Auto, InternetExplorer
Position:Named
Default value:InternetExplorer
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SkipCACheck

Указывает, что при подключении по протоколу HTTPS клиент не проверяет, подписан ли сертификат сервера доверенным центром сертификации (ЦС).

Используйте этот параметр, только если удаленный компьютер является доверенным с помощью другого механизма, например, когда удаленный компьютер является частью сети, которая физически безопасна и изолирована, или когда удаленный компьютер указан в качестве доверенного узла в конфигурации WinRM.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SkipCNCheck

Указывает, что общее имя сертификата (CN) сервера не требуется совпадать с именем узла сервера. Используйте этот параметр для удаленных операций только с доверенными компьютерами, используюющими протокол HTTPS.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-SkipRevocationCheck

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-UICulture

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

  • Имя языка и региональных параметров в <languagecode2>-<country/regioncode2> формате, например "EN-US".
  • Переменная, содержащая объект CultureInfo.
  • Команда, которая получает объект CultureInfo, например Get-Culture.
Тип:CultureInfo
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-UseSsl

Указывает, что ssl следует использовать для установления подключения к удаленному компьютеру. По умолчанию SSL не используется. WsMan шифрует все содержимое, передаваемое по сети, даже при использовании ПРОТОКОЛА HTTP.

Этот параметр позволяет указать дополнительную защиту HTTPS вместо HTTP. Если SSL недоступен на порту, используемом для подключения, и этот параметр указан, команда завершается ошибкой.

Этот параметр рекомендуется использовать только в том случае, если параметр PacketPrivacy не указан.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

None

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

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

CimSessionOptions

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

Примечания

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

  • Windows:
    • ncso

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