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.

$option = @{
    ProxyAuthentication = 'Kerberos'
    ProxyCredential = $cred
    SkipCACheck = $true
    SkipCNCheck = $true
    UseSsl = $true
}
New-CimSessionOption @option

Пример 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. Допустимые значения для этого параметра: по умолчанию, 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, по умолчаниюили Wsman.

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

-ProxyAuthentication

Указывает метод проверки подлинности, используемый для разрешения прокси-сервера. Допустимыми значениями этого параметра являются: по умолчанию, дайджест, согласование, базовый, 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, автоили 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

Имя языка и региональных параметров в формате <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:

Виндоус:
- ncso

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

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

New-CimSessionOption

Синтаксис

Описание

Примеры

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

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

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

Параметры

-Culture

-EncodePortInServicePrincipalName

-Encoding

-HttpPrefix

-Impersonation

-MaxEnvelopeSizeKB

-NoEncryption

-PacketIntegrity

-PacketPrivacy

-Protocol

-ProxyAuthentication

-ProxyCertificateThumbprint

-ProxyCredential

-ProxyType

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseSsl

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

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

Примечания

Дополнительные ресурсы

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

New-CimSessionOption

Синтаксис

Описание

Примеры

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

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

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

Параметры

-Culture

-EncodePortInServicePrincipalName

-Encoding

-HttpPrefix

-Impersonation

-MaxEnvelopeSizeKB

-NoEncryption

-PacketIntegrity

-PacketPrivacy

-Protocol

-ProxyAuthentication

-ProxyCertificateThumbprint

-ProxyCredential

-ProxyType

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseSsl

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

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

Примечания

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

Дополнительные ресурсы