Get-WSManInstance

Синтаксис

GetInstance (по умолчанию)

Get-WSManInstance
    [-ResourceURI] <Uri>
    [-ApplicationName <String>]
    [-ComputerName <String>]
    [-ConnectionURI <Uri>]
    [-Dialect <Uri>]
    [-Fragment <String>]
    [-OptionSet <Hashtable>]
    [-Port <Int32>]
    [-SelectorSet <Hashtable>]
    [-SessionOption <SessionOption>]
    [-UseSSL]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Enumerate

Get-WSManInstance
    [-ResourceURI] <Uri>
    [-ApplicationName <String>]
    [-BasePropertiesOnly]
    [-ComputerName <String>]
    [-ConnectionURI <Uri>]
    [-Dialect <Uri>]
    [-Enumerate]
    [-Filter <String>]
    [-OptionSet <Hashtable>]
    [-Port <Int32>]
    [-Associations]
    [-ReturnType <String>]
    [-SessionOption <SessionOption>]
    [-Shallow]
    [-UseSSL]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Описание

Примеры

Пример 1. Получение всех сведений из WMI

Get-WSManInstance -ResourceURI wmicimv2/Win32_Service -SelectorSet @{name="winrm"} -ComputerName "Server01"

Пример 2. Получение состояния службы spooler

Get-WSManInstance -ResourceURI wmicimv2/Win32_Service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"

Пример 3. Получение ссылок на конечные точки для всех служб

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/Win32_Service -ReturnType EPR

Пример 4. Получение служб, удовлетворяющих указанным критериям

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from Win32_Service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"

Пример 5. Получение конфигурации прослушивателя, которая соответствует критериям на локальном компьютере

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}

Пример 6. Получение конфигурации прослушивателя, которая соответствует критериям на удаленном компьютере

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"

Пример 7. Получение связанных экземпляров, связанных с указанным экземпляром

Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=Win32_Service?name=winrm}" -ResourceURI wmicimv2/*

Пример 8. Получение экземпляров связи, связанных с указанным экземпляром

Get-WSManInstance -Enumerate -Dialect Association -Associations -Filter "{Object=Win32_Service?name=winrm}" -ResourceURI wmicimv2/*

Параметры

-ApplicationName

Указывает имя приложения в соединении. Значением по умолчанию параметра ApplicationName является WSMAN. Полный идентификатор удаленной конечной точки имеет следующий формат:

<транспорт>://<server>:<порт>/<ApplicationName>

Например: http://server01:8080/WSMAN

Службы IIS, на которых размещен сеанс, пересылает запросы с этой конечной точкой в указанное приложение. Этот параметр по умолчанию WSMAN подходит для большинства используемых. Этот параметр предназначен для использования, если многие компьютеры устанавливают удаленные подключения к одному компьютеру под управлением PowerShell. В этом случае узлы IIS WS-Management для повышения эффективности.

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

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

-Associations

Указывает, что этот командлет получает экземпляры ассоциации, а не связанные экземпляры. Этот параметр можно использовать только в том случае, если параметр Диалект имеет значение Association.

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

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

-Authentication

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

• Basic — базовая схема, в которой имя пользователя и пароль отправляются на сервер или прокси-сервер.
• Default. Используйте метод проверки подлинности, реализованный протоколом WS-Management. Это значение по умолчанию.
• Digest . Дайджест — это схема ответа на вызов, которая использует строку данных, указанную сервером для задачи.
• Kerberos — клиентский компьютер и сервер взаимно проходят проверку подлинности с помощью сертификатов Kerberos.
• Negotiate. Согласование — это схема ответа на вызовы, которая согласовывается с сервером или прокси-сервером, чтобы определить схему, используемую для проверки подлинности. Например, это значение параметра позволяет определить, используется ли протокол Kerberos или NTLM.
• CredSSP — используйте проверку подлинности поставщика поддержки безопасности учетных данных (CredSSP), которая позволяет пользователю делегировать учетные данные. Этот параметр предназначен для команд, которые выполняются на одном удаленном компьютере, но собирают данные из других удаленных компьютеров или выполняют дополнительные команды.

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

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

-BasePropertiesOnly

Указывает, что этот командлет перечисляет только свойства, которые являются частью базового класса, указанного параметром resourceURI . Этот параметр не действует, если указан параметр Shallow.

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

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

-CertificateThumbprint

Указывает сертификат цифрового открытого ключа (X509) учетной записи пользователя, которая имеет разрешение на выполнение этого действия. Введите отпечаток пальца сертификата.

Сертификаты используются в аутентификации, основанной на клиентских сертификатах. Их можно сопоставить только с локальными учетными записями пользователей; Они не работают с учетными записями домена.

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

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

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

-ComputerName

Указывает компьютер, на котором выполняется операция управления. Это значение может быть полным доменным именем, именем NetBIOS или IP-адресом. Используйте имя локального компьютера, используйте localhost или используйте точку (.) для указания локального компьютера. Локальный компьютер по умолчанию. Если удаленный компьютер находится в другом домене от пользователя, необходимо использовать полное доменное имя. Можно передать значение для этого параметра командлету.

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

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

-ConnectionURI

Указывает конечную точку подключения. Формат этой строки выглядит следующим образом:

<транспорт>://<Server>:<порт>/<> Имя приложения

Следующая строка является правильно отформатированным значением для этого параметра:

http://Server01:8080/WSMAN

Универсальный код ресурса (URI) должен быть полностью определённым.

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

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

-Credential

Указывает учетную запись пользователя, которая имеет разрешение на выполнение этого действия. По умолчанию используется текущий пользователь. Введите имя пользователя, например User01, Domain01\User01 или [email protected]. Или введите объект PSCredential, например объект, возвращаемый командлетом Get-Credential. При вводе имени пользователя этот командлет запрашивает пароль.

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

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

-Dialect

Задает диалект, используемый в предикате фильтра. Это может быть любой диалект, поддерживаемый удаленной службой. Для URI диалекта можно использовать следующие псевдонимы:

• WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
• Селектор — http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• Ассоциация — http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

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

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

-Enumerate

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

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

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

-Filter

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

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

"Select * from Win32_Service where State != Running"

Если диалект является ассоциацией, фильтра должны содержать строку, а строка должна содержать допустимый фильтр, например следующий фильтр:

-filter:Object=EPR\[;AssociationClassName=AssocClassName\]\[;ResultClassName=ClassName\]\[;Role=RefPropertyName\]\[;ResultRole=RefPropertyName\]}

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

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

-Fragment

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

-Fragment Status

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

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

-OptionSet

Задает набор коммутаторов в службу для изменения или уточнения характера запроса. Эти параметры похожи на параметры, используемые в оболочках командной строки, так как они относятся к службе. Можно указать любое количество параметров.

В следующем примере показан синтаксис, который передает значения 1, 2 и 3 для параметров a, b и c:

-OptionSet @{a=1;b=2;c=3}

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

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

-Port

Указывает порт, используемый при подключении клиента к службе WinRM. Если транспорт имеет значение HTTP, порт по умолчанию — 80. Если транспорт имеет значение HTTPS, порт по умолчанию — 443.

При использовании HTTPS в качестве транспорта значение параметра ComputerName должно соответствовать общему имени сертификата сервера (CN). Однако если параметр SkipCNCheck указан как часть параметра SessionOption, общее имя сертификата сервера не обязательно совпадает с именем узла сервера. Параметр skipCNCheck должен использоваться только для доверенных компьютеров.

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

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

-ResourceURI

Задает URI класса ресурса или экземпляра. Универсальный код ресурса (URI) определяет определенный тип ресурса, например диски или процессы, на компьютере.

Универсальный код ресурса (URI) состоит из префикса и пути к ресурсу. Рассмотрим пример.

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

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

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

-ReturnType

Указывает тип возвращаемых данных. Допустимые значения для этого параметра:

• Object
• EPR
• ObjectAndEPR

Значение по умолчанию — Object.

Если указать Object или не указать этот параметр, этот командлет возвращает только объекты. Если указать ссылку на конечную точку (EPR) этот командлет возвращает только ссылки на конечные точки объектов. Ссылки на конечные точки содержат сведения о URI ресурсах и селекторах для экземпляра. Если указать ObjectAndEPR, этот командлет возвращает ссылки как на объект, так и на связанные с ней конечные точки.

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

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

-SelectorSet

Задает набор пар значений, которые используются для выбора конкретных экземпляров ресурсов управления. Параметр selectorSet используется при наличии нескольких экземпляров ресурса. Значение параметра SelectorSet должно быть хэш-таблицей.

В следующем примере показано, как ввести значение для этого параметра:

-SelectorSet @{Name="WinRM";ID="yyy"}

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

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

-SessionOption

Задает расширенные параметры сеанса WS-Management. Введите объект SessionOption, создаваемый с помощью командлета New-WSManSessionOption. Дополнительные сведения о доступных параметрах введите Get-Help New-WSManSessionOption.

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

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

-Shallow

Указывает, что этот командлет возвращает только экземпляры базового класса, указанного в URI ресурса. Если этот параметр не указан, этот командлет возвращает экземпляры базового класса, указанного в URI и во всех производных классах.

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

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

-UseSSL

Указывает, что протокол SSL используется для установления подключения к удаленному компьютеру. По умолчанию SSL не используется.

WS-Management шифрует все содержимое Windows PowerShell, передаваемое по сети. Параметр UseSSL позволяет указать дополнительную защиту HTTPS вместо HTTP. Если ssl недоступен на порту, используемом для подключения, и укажите этот параметр, команда завершается ошибкой.

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

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

CommonParameters

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

None

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

XmlElement

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

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption (новая опция сеанса WSMan)
• Remove-WSManInstance
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan