Test-DscConfiguration

  • Ссылка
Модуль:
PSDesiredStateConfiguration

Проверяет, соответствует ли фактическая конфигурация на узлах требуемой.

Синтаксис

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Описание

Командлет Test-DscConfiguration проверяет, соответствует ли фактическая конфигурация на узлах требуемой конфигурации. Укажите компьютеры, для которых требуется тестировать конфигурации с помощью имен компьютеров или сеансов CIM. Если целевой компьютер не указан, командлет проверяет конфигурацию локального компьютера.

Если требуемые и фактические конфигурации совпадают, командлет возвращает строковое значение True. В противном случае возвращается строковое значение False.

Примеры

Пример 1. Тестовая конфигурация для локального компьютера

Test-DscConfiguration

Эта команда проверяет конфигурацию для локального компьютера.

Пример 2. Тестовая конфигурация для указанного компьютера

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

В этом примере проверяется конфигурация компьютера, указанного сеансом CIM. Пример создает сеанс CIM для компьютера с именем Server01, чтобы использовать с командлетом. Кроме того, можно создать массив сеансов CIM для применения командлета к нескольким указанным компьютерам.

Первая команда создает сеанс CIM с помощью командлета New-CimSession , а затем сохраняет объект CimSession в переменной $Session . Команда запрашивает пароль. Для получения дополнительных сведений введите Get-Help New-CimSession.

Вторая команда проверяет конфигурацию компьютеров, определенных объектами CimSession , хранящимися в $Session переменной , в данном случае это компьютер с именем Server01.

Пример 3. Тестирование конфигураций с подробными результатами

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

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

Пример 4. Тестирование конфигураций, указанных в папке

Test-DscConfiguration -Path "C:\Dsc\Configurations"

Эта команда проверяет конфигурации, определенные в папке, указанной параметром Path . Конфигурации проверяются на наборе компьютеров, каждый из которых определяется именем файла конфигурации.

Пример 5. Конфигурации тестирования, указанные в файле

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

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

Параметры

-AsJob

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

Если указать параметр AsJob, команда возвращает объект, представляющий задание, а затем появляется командная строка. Вы можете продолжить работу в рамках данного сеанса, пока задание не будет завершено. Задание создается на локальном компьютере, а результаты с удаленных компьютеров автоматически возвращаются на локальный компьютер. Для управления заданием используйте командлеты Job. Чтобы получить результаты задания, используйте Receive-Job командлет .

Чтобы использовать этот параметр, локальный и удаленный компьютеры должны быть настроены для удаленного взаимодействия, а в Windows Vista и более поздних версиях операционной системы Windows необходимо также запустить Windows PowerShell от имени администратора. Дополнительные сведения см. в разделе about_Remote_Requirements.

Дополнительные сведения о фоновых заданиях Windows PowerShell см. в разделах about_Jobs и about_Remote_Jobs.

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

-CimSession

Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета New-CimSession или Get-CimSession . Сеанс по умолчанию — текущий сеанс на локальном компьютере.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Задает массив имен компьютеров, на котором этот командлет проверяет конфигурацию. Командлет проверяет для этих компьютеров документ конфигурации в расположении, указанном параметром Path .

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Указывает имя пользователя и пароль как объект PSCredential для целевого компьютера. Чтобы получить объект PSCredential , используйте Get-Credential командлет . Для получения дополнительных сведений введите Get-Help Get-Credential.

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

-Detailed

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

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

-Path

Указывает путь к папке, содержащей файлы документов конфигурации. Командлет проверяет конфигурацию на соответствие требуемому состоянию компьютеров, заданному параметром ComputerName или CimSession .

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

-ReferenceConfiguration

Указывает путь к файлу документа конфигурации. Этот командлет проверяет конфигурацию на соответствие фактическому состоянию компьютеров, заданному параметром ComputerName или CimSession .

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

-ThrottleLimit

Указание максимального количества одновременных операций, которые можно выполнять для запуска командлета. Если этот параметр опущен или введено значение 0 , то Windows PowerShell вычисляет оптимальное ограничение регулирования для командлета на основе количества командлетов CIM, запущенных на компьютере. Предел регулирования применим только к текущему командлету, а не к сеансу или компьютеру.

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