New-CimSessionOption

Модуль:

CimCmdlets Module

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

Синтаксис

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

Описание

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

Этот командлет имеет два набора параметров, один для параметров 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

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

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

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

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

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

(All)

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

-EncodePortInServicePrincipalName

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

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

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

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

WSManParameterSet

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

-Encoding

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

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

Тип:	PacketEncoding
Default value:	None
Допустимые значения:	Default, Utf8, Utf16
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

WSManParameterSet

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

-HttpPrefix

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

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

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

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

WSManParameterSet

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

-Impersonation

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

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

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

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

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

Тип:	ImpersonationType
Default value:	None
Допустимые значения:	Default, None, Identify, Impersonate, Delegate
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

DcomParameterSet

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

-MaxEnvelopeSizeKB

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

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

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

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

WSManParameterSet

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

-NoEncryption

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

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

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

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

WSManParameterSet

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

-PacketIntegrity

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

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

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

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

DcomParameterSet

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

-PacketPrivacy

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

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

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

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

DcomParameterSet

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

-Protocol

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

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

Тип:	ProtocolType
Default value:	None
Допустимые значения:	Dcom, Default, Wsman
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

ProtocolTypeSet

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

-ProxyAuthentication

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

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

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

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

WSManParameterSet

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

-ProxyCertificateThumbprint

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

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

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

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

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

WSManParameterSet

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

-ProxyCredential

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

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

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

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

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

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

WSManParameterSet

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

-ProxyType

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

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

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

Тип:	ProxyType
Default value:	InternetExplorer
Допустимые значения:	None, WinHttp, Auto, InternetExplorer
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

WSManParameterSet

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

-SkipCACheck

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

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

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

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

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

WSManParameterSet

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

-SkipCNCheck

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

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

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

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

WSManParameterSet

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

-SkipRevocationCheck

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

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

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

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

WSManParameterSet

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

-UICulture

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

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

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

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

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

(All)

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

-UseSsl

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

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

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

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

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

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

WSManParameterSet

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

CommonParameters

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

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

None

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

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

CimSessionOptions

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

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

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