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

Test-ComputerSecureChannel

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

Тестирует и восстанавливает безопасный канал между локальным компьютером и его доменом.

Синтаксис

Test-ComputerSecureChannel
    [-Repair]
    [-Server <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Test-ComputerSecureChannel проверяет правильность работы канала между локальным компьютером и его доменом, проверяя состояние отношений доверия. В случае сбоя подключения можно использовать параметр Repair, чтобы попытаться восстановить его.

Test-ComputerSecureChannel возвращает $True, если канал работает правильно и $False, если это не так. Это позволяет использовать его в условных операторах в функциях и сценариях. Чтобы получить более подробные результаты проверки, используйте параметр Verbose.

Этот командлет работает так же, как NetDom.exe. NetDom и Test-ComputerSecureChannel используйте службу NetLogon для выполнения действий.

Примеры

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

Test-ComputerSecureChannel

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

Пример 2. Тестирование канала между локальным компьютером и контроллером домена

Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

Эта команда задает предпочтительный контроллер домена для проверки.

Пример 3. Тестирование канала между локальным компьютером и его доменом

Test-ComputerSecureChannel -Repair

Эта команда переустанавливает канал между локальным компьютером и его доменом.

Пример 4. Отображение подробных сведений о тесте

Test-ComputerSecureChannel -Verbose

VERBOSE: Performing operation "Test-ComputerSecureChannel" on Target "SERVER01".
True
VERBOSE: "The secure channel between 'SERVER01' and 'net.fabrikam.com' is alive and working correctly."

В этой команде используется параметр Verbose для запроса подробных сообщений об операции. Дополнительные сведения о подробных сведениях см. в about_CommonParameters.

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

if (!(Test-ComputerSecureChannel)) {
    Write-Host "Connection failed. Reconnect and retry."
}
else {
    &(.\Get-Servers.ps1)
}

В этом примере показано, как протестировать Test-ComputerSecureChannel подключение перед запуском скрипта, требующего подключения.

Инструкция if проверяет значение, возвращаемое Test-ComputerSecureChannel перед запуском скрипта.

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

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

-Credential

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

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

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

-Repair

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

Для использования этого параметра текущий пользователь должен быть участником группы "Администраторы" на локальном компьютере.

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

-Server

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

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

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

None

В этот командлет нельзя передать входные данные.

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

Boolean

Этот командлет возвращает значение $True , если подключение работает правильно и $False если оно не работает.

Примечания

  • Чтобы выполнить Test-ComputerSecureChannel команду в Windows Vista и более поздних версиях операционной системы Windows, откройте Windows PowerShell с помощью параметра "Запуск от имени администратора".
  • Test-ComputerSecureChannel реализуется с помощью функции I_NetLogonControl2 , которая управляет различными аспектами службы Netlogon.