New-CimSessionOption

Синтаксис

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

New-CimSessionOption
    [-Protocol] <ProtocolType>
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

WSManParameterSet

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

DcomParameterSet

New-CimSessionOption
    [-Impersonation <ImpersonationType>]
    [-PacketIntegrity]
    [-PacketPrivacy]
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

Описание

Примеры

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

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

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

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

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

New-CimSessionOption -Culture fr-FR -Protocol Wsman

Параметры

-Culture

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

• Имя языка и региональных параметров в формате <languagecode2>-<country/regioncode2>, например "en-US".
• Переменная, содержащая объект CultureInfo.
• Команда, которая получает объект CultureInfo, например Get-Culture

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

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

-EncodePortInServicePrincipalName

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

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

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

-Encoding

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

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

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

-HttpPrefix

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

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

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

-Impersonation

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

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

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

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

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

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

-MaxEnvelopeSizeKB

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

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

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

-NoEncryption

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

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

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

-PacketIntegrity

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

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

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

-PacketPrivacy

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

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

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

-Protocol

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

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

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

-ProxyAuthentication

Указывает метод аутентификации, используемый для определения прокси-сервера. Допустимыми значениями этого параметра являются: по умолчанию, дайджест, согласование, базовый, Kerberos, NtlmDomainили CredSsp.

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

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

-ProxyCertificateThumbprint

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

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

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

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

-ProxyCredential

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

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

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

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

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

-ProxyType

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

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

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

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

-SkipCACheck

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

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

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

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

-SkipCNCheck

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

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

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

-SkipRevocationCheck

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

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

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

-UICulture

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

• Имя языка и региональных параметров в формате <languagecode2>-<country/regioncode2>, например "en-US".
• Переменная, содержащая объект CultureInfo.
• Команда, которая получает объект CultureInfo, например Get-Culture.

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

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

-UseSsl

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

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

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

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

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

CommonParameters

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

None

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

CimSessionOptions

Примечания

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

• Get-ChildItem
• Get-Credential
• Get-Culture
• Get-Item
• New-CimSession