Find-SCComputer

Ссылка

Модуль:: VirtualMachineManager

Выполняет поиск компьютеров, запрашивая Active Directory, и возвращает объекты компьютера.

Синтаксис

Find-SCComputer
    [-VMMServer <ServerConnection>]
    [-ComputerNameFilter <String>]
    -Domain <String>
    -Credential <VMMCredential>
    [-ExcludeVMMHost]
    [-ExcludeVMMLibrary]
    [-ExcludeVMs]
    [-FindHyperVHost]
    [-DiscoveryID <Guid>]
    [-RunAsynchronously]
    [-JobVariable <String>]
    [<CommonParameters>]

Find-SCComputer
    [-VMMServer <ServerConnection>]
    [-ComputerName] <String>
    [-Credential <VMMCredential>]
    [-ExcludeVMMHost]
    [-ExcludeVMMLibrary]
    [-DiscoveryID <Guid>]
    [-RunAsynchronously]
    [<CommonParameters>]

Find-SCComputer
    [-VMMServer <ServerConnection>]
    -Domain <String>
    -ADSearchFilter <String>
    -Credential <VMMCredential>
    [-ExcludeVMMHost]
    [-ExcludeVMMLibrary]
    [-ExcludeVMs]
    [-FindHyperVHost]
    [-DiscoveryID <Guid>]
    [-RunAsynchronously]
    [-JobVariable <String>]
    [<CommonParameters>]

Find-SCComputer
    [-VMMServer <ServerConnection>]
    -IPAddressRangeStart <String>
    -IPAddressRangeEnd <String>
    -BMCProtocol <OutOfBandManagementType>
    [-BMCCustomConfigurationProvider <ConfigurationProvider>]
    [-BMCPort <Int32>]
    -BMCRunAsAccount <RunAsAccount>
    [-All]
    [-DiscoveryID <Guid>]
    [-RunAsynchronously]
    [-JobVariable <String>]
    [<CommonParameters>]

Find-SCComputer
    [-VMMServer <ServerConnection>]
    -Subnet <String>
    -BMCProtocol <OutOfBandManagementType>
    [-BMCCustomConfigurationProvider <ConfigurationProvider>]
    [-BMCPort <Int32>]
    -BMCRunAsAccount <RunAsAccount>
    [-All]
    [-DiscoveryID <Guid>]
    [-RunAsynchronously]
    [-JobVariable <String>]
    [<CommonParameters>]

Find-SCComputer
    [-VMMServer <ServerConnection>]
    -BMCAddress <String>
    -BMCProtocol <OutOfBandManagementType>
    [-BMCCustomConfigurationProvider <ConfigurationProvider>]
    [-BMCPort <Int32>]
    -BMCRunAsAccount <RunAsAccount>
    [-SMBiosGuid <Guid>]
    [-DeepDiscovery]
    [-DiscoveryID <Guid>]
    [-RunAsynchronously]
    [-JobVariable <String>]
    [<CommonParameters>]

Описание

Командлет Find-SCComputer ищет один или несколько компьютеров, запрашивая Active Directory, и возвращает объекты компьютера.

Этот командлет можно использовать для запроса Active Directory для компьютеров на основе указанных критериев или сочетания критериев, включая:

Полное доменное имя компьютера.
Все или часть имени компьютера.
Имя домена.
Все компьютеры, кроме узлов, управляемых Virtual Machine Manager (VMM).
Все компьютеры, кроме серверов библиотек, управляемых VMM.
Только Hyper-V узлах.
Компьютеры без операционной системы, имеющие контроллеры вне полосы.

Примечание. Если добавить новый компьютер, например узел или сервер библиотеки, расположенный в домене Active Directory в VMM, а затем немедленно запустить командлет Discover-Computer, командлет может не сразу обнаружить новый компьютер при поиске в Active Directory. Эта задержка может произойти, так как данные о новом компьютере, возможно, еще не реплицировались в домене Active Directory. Если вы являетесь администратором домена, вы можете использовать консоль сайтов и служб Active Directory, чтобы принудительно реплицировать данные немедленно.

Примеры

Пример 1. Поиск компьютеров в определенном домене, удовлетворяющих указанным критериям

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "Host Computer Account 01"
PS C:\> Find-SCComputer -ComputerNameFilter "host" -Domain "Contoso.com" -FindHyperVHosts -ExcludeVMMHost -RunAsAccount $RunAsAccount

Первая команда получает объект учетной записи запуска от имени 01 и сохраняет объект в переменной $RunAsAccount.

Вторая команда запрашивает Active Directory и возвращает список Hyper-V компьютерных объектов для компьютеров, расположенных в домене Contoso.com, имя которых начинается с "узла" и не управляется VMM. По мере обработки этой команды $RunAsAccount предоставляет учетные данные для Find-SCComputer.

Примечание. При использовании Find-SCComputer с параметром домена необходимо указать полное доменное имя.

Пример 2. Поиск определенного компьютера по имени и проверка его свойств в Active Directory

PS C:\> Find-SCComputer -ComputerName "VMHost01.Contoso.com"

Эта команда использует полное доменное имя компьютера с именем VMHost01 для поиска этого компьютера в Active Directory, возвращает объект компьютера и отображает свойства объекта компьютера пользователю.

Пример 3. Поиск всех компьютеров в указанном домене, которые не являются сервером библиотекИ VMM

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "Host Computer Account 01"
PS C:\> Find-SCComputer -ComputerNameFilter "vmm" -Domain "Contoso.com" -ExcludeVMMLibrary -RunAsAccount $RunAsAccount

Первая команда получает объект учетной записи запуска от имени 01 и сохраняет объект в переменной $RunAsAccount.

Вторая команда запрашивает Active Directory для всех компьютеров в домене Contoso.com, включающих "vmm" в имя компьютера, за исключением серверов библиотек VMM. По мере обработки этой команды $RunAsAccount предоставляет учетные данные для Find-SCComputer.

Пример 4. Поиск всех неуправляемых компьютеров в указанном домене с помощью запроса Active Directory

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "Host Computer Account 01"
PS C:\> Find-SCComputer -ADSearchFilter "(&(sAMAccountType=805306369)(name=Test0*)(objectCategory=computer)(objectClass=computer)(operatingSystem=Windows\20Server\202008\20R2*))" -Domain "Contoso.com" -ExcludeVMMLibrary -ExcludeVMMHost -RunAsAccount $RunAsAccount

Первая команда получает объект учетной записи запуска от имени 01 и сохраняет объект в переменной $RunAsAccount.

Вторая команда запрашивает Active Directory для всех компьютеров в домене Contoso.com, удовлетворяющих критериям запроса: любой компьютер Windows Server 2008 R2 с именем, начинающимся с Test0, но не серверами библиотек VMM или узлами VMM. По мере обработки этой команды $RunAsAccount предоставляет учетные данные для Find-SCComputer.

Пример 5. Поиск компьютеров без операционной системы с встроенными контроллерами, которые находятся в определенном диапазоне сети

PS C:\> $BMCRunAsAccount = Get-SCRunAsAccount "BMC Account 01"
PS C:\> Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRunAsAccount -BMCProtocol "IPMI"

Первая команда получает объект учетной записи запуска от имени BMC Account 01 и сохраняет объект в переменной $BMCRunAsAccount.

Вторая команда сканирует сеть для физического компьютера с указанным BMCAddress. По мере обработки этой команды $BMCRunAsAccount предоставляет учетные данные для Find-SCComputer.

Пример 6. Выполнение глубокого обнаружения на физическом компьютере с поддержкой компьютера без операционной системы

PS C:\> $BMCRunAsAccount = Get-SCRunAsAccount "BMC Account 01"
PS C:\> $MyComputer01 = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRunAsAccount -BMCProtocol "IPMI" 
PS C:\> $MyComputer01 = Find-SCComputer -DeepDiscovery -BMCAddress $MyComputer01.BMCAddress -BMCRunAsAccount $BMCRunAsAccount -BMCProtocol "IPMI" -SMBIOSGUID $MyComputer01.SMBIOSGUID
PS C:\> $MyComputer01

Третья команда выполняет глубокое обнаружение на объекте компьютера и возвращает объект физического компьютера в $MyComputer 01 переменную.

Последняя команда отображает свойства объекта компьютера, хранящегося в переменной $MyComputer 01.

Параметры

-ADSearchFilter

Определяет запрос Active Directory для обнаружения. Используйте этот параметр, чтобы указать запрос, содержащий сведения о домене Active Directory и фильтры поиска.

Пример формата: -ADSearchFilter``"(&(sAMAccountType=805306369)(name=katarina*)(objectCategory=computer)(objectClass =computer)(operatingSystem=Windows\20Server*))"

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-All

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BMCAddress

Указывает или обновляет адрес контроллера управления базовой платой (BMC) для конкретного физического компьютера. Это может быть IP-адрес, полное доменное имя (FQDN) или префикс DNS (которое обычно совпадает с именем NetBIOS).

Как правило, адрес BMC и его подключение к сети отделены от IP-адреса, связанного со стандартным сетевым адаптером. Кроме того, некоторые компьютеры используют стандартный сетевой адаптер для предоставления одного адреса для BMC и сетевого адаптера. Однако адрес BMC имеет уникальный порт и, таким образом, однозначно идентифицируется в сети.

Пример формата IPv4: -BMCAddress "10.0.0.21"

Пример формата Ipv6: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"

Пример полного доменного имени: -BMCAddress "Computer01.Contoso.com"

Пример формата NetBIOS: -BMCAddress "Computer01"

Примечание. По умолчанию VMM использует IP-адрес или полное доменное имя для адреса BMC. Однако также можно создать модуль PowerShell, позволяющий указать другие типы адресов в качестве адреса BMC.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BMCCustomConfigurationProvider

Указывает или обновляет объект поставщика конфигурации для контроллера управления базовой платой (BMC). Поставщик конфигурации — это подключаемый модуль к VMM, который преобразует команды PowerShell VMM в вызовы API, относящиеся к типу контроллера управления базовой доской. Этот параметр следует использовать с пользовательским BMCProtocol.

Тип:	ConfigurationProvider
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BMCPort

Указывает или обновляет порт контроллера управления базовой платой (BMC) для конкретного физического компьютера. Порт BMC также называется портом обработчика служб. Примеры портов по умолчанию: 623 для IPMI и 443 для SMASH через WS-Man.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BMCProtocol

Указывает или обновляет протокол, используемый VMM для взаимодействия с контроллером управления базовой доской (BMC). Допустимые значения:

IPMI
РАЗБИВАТЬ
Обычай

BMC (также известный как обработчик служб или контроллер управления) — это специализированный контроллер на материнской плате сервера, который действует в интерфейсе между аппаратным и системным программным обеспечением управления. Если системная плата физического компьютера включает BMC, когда компьютер подключен (независимо от того, включена ли она или включена, и независимо от того, установлена ли операционная система), доступна информация о системном оборудовании и состоянии работоспособности этого оборудования системы.

Пример формата: -BMCProtocol "Custom"

Примечание. Для пользовательского протокола требуется использовать параметр BMCCustomConfigurationProvider.

Тип:	OutOfBandManagementType
Допустимые значения:	IPMI, SMASH, Custom
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BMCRunAsAccount

Указывает учетную запись запуска от имени, используемую с устройством контроллера управления базовой платой (BMC).

Тип:	RunAsAccount
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ComputerName

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

Полное доменное имя
IPv4 или IPv6-адрес
Имя NetBIOS

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ComputerNameFilter

Указывает частичное или полное имя компьютера, который командлет попытается обнаружить в Active Directory.

Пример формата: -ComputerNameFilter "host"

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

Указывает объект учетных данных или для некоторых командлетов объект учетной записи запуска от имени, содержащий имя пользователя и пароль учетной записи с разрешением на выполнение этого действия. Или, в случае перезапуск-SCJob, имеет разрешение на завершение перезапуска задачи.

Дополнительные сведения об объекте PSCredential введите Get-Help Get-Credential.

Дополнительные сведения о учетных записях запуска от имени введите Get-Help New-SCRunAsAccount.

Тип:	VMMCredential
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DeepDiscovery

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DiscoveryID

Только для внутреннего использования (не для использования в коде).

Тип:	Guid
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Domain

Указывает полное доменное имя (FQDN) для домена Active Directory.

Пример формата: -Domain "Domain01.Corp.Contoso.com"

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ExcludeVMMHost

Исключает узлы виртуальных машин, которые в настоящее время управляются VMM.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ExcludeVMMLibrary

Исключает серверы библиотеки, управляемые в настоящее время VMM.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ExcludeVMs

Исключает виртуальные машины.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FindHyperVHost

Выполняет поиск компьютеров под управлением Windows Server 2008 или более поздней версии, на которых включена роль сервера Hyper-V.

Тип:	SwitchParameter
Aliases:	FindHyperVHosts
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IPAddressRangeEnd

Указывает последний IP-адрес в диапазоне IP-адресов. Используйте параметр IPAddressRangeStart.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IPAddressRangeStart

Задает первый IP-адрес в диапазоне IP-адресов. Используйте параметр IPAddressRangeEnd.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-JobVariable

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RunAsynchronously

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SMBiosGuid

Указывает глобальный уникальный идентификатор BIOS управления системой (GUID SMBIOS) для физического компьютера, связанного с записью для этого физического компьютера в VMM.

SMBIOS определяет структуры данных и методы доступа, позволяющие пользователю или приложению хранить и извлекать сведения об оборудовании на этом компьютере, например имя системы, производителя или версии системного BIOS. Операционные системы Windows извлекают данные SMBIOS при запуске системы и делают эти данные доступными для программ.

Тип:	Guid
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Subnet

Указывает подсеть IP -адресов (IPv4 или IPv6) в нотации без классификации Inter-Domain маршрутизации (CIDR).

Пример формата для подсети IPv4: 192.168.0.1/24

Пример формата подсети IPv6: FD4A:29CD:184F:3A2C::/64

Примечание. Подсеть IP-адресов не может перекрываться с любой другой подсетью в группе узлов или дочерних группах узлов.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VMMServer

Указывает объект сервера VMM.

Тип:	ServerConnection
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

Computer

Этот командлет возвращает объект Computer.

Get-SCRunAsAccount

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

Find-SCComputer

Синтаксис

Описание

Примеры

Пример 1. Поиск компьютеров в определенном домене, удовлетворяющих указанным критериям

Пример 2. Поиск определенного компьютера по имени и проверка его свойств в Active Directory

Пример 3. Поиск всех компьютеров в указанном домене, которые не являются сервером библиотекИ VMM

Пример 4. Поиск всех неуправляемых компьютеров в указанном домене с помощью запроса Active Directory

Пример 5. Поиск компьютеров без операционной системы с встроенными контроллерами, которые находятся в определенном диапазоне сети

Пример 6. Выполнение глубокого обнаружения на физическом компьютере с поддержкой компьютера без операционной системы

Параметры

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

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

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

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

Find-SCComputer

Синтаксис

Описание

Примеры

Пример 1. Поиск компьютеров в определенном домене, удовлетворяющих указанным критериям

Пример 2. Поиск определенного компьютера по имени и проверка его свойств в Active Directory

Пример 3. Поиск всех компьютеров в указанном домене, которые не являются сервером библиотекИ VMM

Пример 4. Поиск всех неуправляемых компьютеров в указанном домене с помощью запроса Active Directory

Пример 5. Поиск компьютеров без операционной системы с встроенными контроллерами, которые находятся в определенном диапазоне сети

Пример 6. Выполнение глубокого обнаружения на физическом компьютере с поддержкой компьютера без операционной системы

Параметры

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

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

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

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