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

Синтаксис

Test-ComputerSecureChannel [-Repair] [-Server <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

Описание

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

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

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

Параметры

-Repair

Удаляет и затем снова создает безопасный канал, установленный службой NetLogon. С помощью этого параметра можно попытаться восстановить соединение, которое не прошло проверку (возвратило значение "False".)

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

Обязательно?	false
Позиция?	named
Значение по умолчанию	нет
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Server <string>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию	нет
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Confirm

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-WhatIf

Описывает, что произойдет при выполнении команды, без ее фактического выполнения.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

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

Нет

Передать входные данные этому командлету по конвейеру невозможно.

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

System.Boolean

Командлет возвращает значение "True", если соединение функционирует правильно, и "False" в противном случае.

Примечания

Чтобы использовать командлет Test-ComputerSecureChannel в Windows Vista и более поздних версиях Windows, необходимо запускать Windows PowerShell командой "Запуск от имени администратора".

Командлет Test-ComputerSecureChannel реализован с использованием функции I_NetLogonControl2, управляющей различными аспектами службы Netlogon.

Пример 1

C:\PS>test-computersecurechannel

True

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

Пример 2

C:\PS>test-computersecurechannel -server DCName.fabrikam.com

True

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

Пример 3

C:\PS>Test-ComputerSecureChannel -repair

True

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

Пример 4

C:\PS>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 для запроса подробных сообщений о выполняемой операции. Дополнительные сведения о параметре Verbose см. в разделе about_CommonParameters.

Пример 5

C:\PS>set-alias tcsc test-computersecurechannel 

if (!(tcsc)) 
	 {write-host "Connection failed. Reconnect and retry."}
else { &(.\get-servers.ps1) }

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

Первая команда с помощью командлета Set-Alias создает псевдоним для имени командлета. Это экономит место и позволяет избежать опечаток.

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

Test-ComputerSecureChannel