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


New-CimSessionOption

Задает дополнительные параметры для командлета 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. Create объекта параметров сеанса CIM для DCOM

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

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

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

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

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

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

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

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

Параметры

-Culture

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

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

-EncodePortInServicePrincipalName

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

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

-Encoding

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

Type:PacketEncoding
Accepted values:Default, Utf8, Utf16
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-HttpPrefix

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

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

-Impersonation

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

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

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

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

Type:ImpersonationType
Accepted values:Default, None, Identify, Impersonate, Delegate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxEnvelopeSizeKB

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

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

-NoEncryption

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

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

-PacketIntegrity

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

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

-PacketPrivacy

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

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

-Protocol

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

Type:ProtocolType
Accepted values:Dcom, Default, Wsman
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProxyAuthentication

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

-ProxyCertificateThumbprint

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

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

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

-ProxyCredential

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

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

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

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

-ProxyType

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

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

Type:ProxyType
Accepted values:None, WinHttp, Auto, InternetExplorer
Position:Named
Default value:InternetExplorer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SkipCACheck

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

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

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

-SkipCNCheck

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

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

-SkipRevocationCheck

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

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

-UICulture

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

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

-UseSsl

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

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

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

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

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

None

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

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

CimSessionOptions

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

Примечания

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

  • Windows:
    • ncso

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