CSP SurfaceHub

O CSP (provedor de serviços de configuração) do SurfaceHub é usado para definir Microsoft Surface Hub configurações. Esse CSP foi adicionado Windows 10, versão 1511 e posterior.

O exemplo a seguir mostra os objetos de gerenciamento do CSP do SurfaceHub no formato de árvore.

./Vendor/MSFT
SurfaceHub
----DeviceAccount
--------DomainName
--------UserName
--------UserPrincipalName
--------Password
--------ValidateAndCommit
--------ExchangeServer
--------SipAddress
--------Email
--------CalendarSyncEnabled
--------ErrorContext
--------PasswordRotationEnabled
----MaintenanceHoursSimple
--------Hours
------------StartTime
------------Duration
----InBoxApps
--------SkypeForBusiness
------------DomainName
--------Welcome
------------AutoWakeScreen
------------CurrentBackgroundPath
------------MeetingInfoOption
--------Whiteboard
------------SharingDisabled
------------SigninDisabled
------------TelemeteryDisabled
--------WirelessProjection
------------PINRequired
------------Enabled
------------Channel
--------Connect
------------AutoLaunch
----Properties
--------FriendlyName
--------DefaultVolume
--------DefaultAutomaticFraming
--------ScreenTimeout
--------SessionTimeout
--------SleepTimeout
--------AllowSessionResume
--------AllowAutoProxyAuth
--------ProxyServers
--------DisableSigninSuggestions
--------DoNotShowMyMeetingsAndFiles
----Management
--------GroupName
--------GroupSid
----MOMAgent
--------WorkspaceID
--------WorkspaceKey

./Vendor/MSFT/SurfaceHub
O nó raiz do provedor de serviços de configuração do Surface Hub.

DeviceAccount Nó para definir informações da conta do dispositivo. Uma conta de dispositivo é uma conta do Microsoft Exchange conectada com o Skype for Business, que permite que as pessoas participem de reuniões agendadas, faça chamadas do Skype for Business e compartilhem conteúdo do dispositivo. Consulte o guia do administrador do Surface Hub para obter mais informações sobre como configurar uma conta de dispositivo.

Para usar uma conta de dispositivo do Azure Active Directory

  1. Defina UserPrincipalName (para Azure AD).
  2. Defina uma senha válida.
  3. Execute ValidateAndCommit para validar a combinação de nome de usuário e senha especificada em relação Azure AD.
  4. Obtenha o ErrorContext caso algo saia errado durante a validação.

Observação

Se o dispositivo não puder descobrir automaticamente o servidor Exchange e o endereço SIP (Session Initiation Protocol) com base nessa informação, você deverá especificar o ExchangeServer e SipAddress.

Aqui'um exemplo de SyncML.

<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Replace>
            <CmdID>1</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/SurfaceHub/DeviceAccount/UserPrincipalName</LocURI>
                </Target>
                <Meta>
                    <Format xmlns="syncml:metinf">chr</Format>
                </Meta>
                <Data>user@contoso.com</Data>
            </Item>
        </Replace>
        <Replace>
            <CmdID>2</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/SurfaceHub/DeviceAccount/Password</LocURI>
                </Target>
                <Meta>
                    <Format xmlns="syncml:metinf">chr</Format>
                </Meta>
                <Data>password</Data>
            </Item>
        </Replace>
        <Exec>
            <CmdID>3</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/SurfaceHub/DeviceAccount/ValidateAndCommit</LocURI>
                </Target>
            </Item>
        </Exec>
        <Get>
            <CmdID>4</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/SurfaceHub/DeviceAccount/ErrorContext</LocURI>
                </Target>
            </Item>
        </Get>
        <Final/>
    </SyncBody>
</SyncML>

Para usar uma conta de dispositivo do Active Directory:

  1. Defina o DomainName.
  2. Defina o UserName.
  3. Defina uma senha válida.
  4. Execute o nó ValidateAndCommit.

DeviceAccount/DomainName

Domínio da conta de dispositivo quando você estiver usando o Active Directory. Para usar uma conta de dispositivo do Active Directory, você deve especificar DomainName e UserName para a conta do dispositivo.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

DeviceAccount/UserName

Nome de usuário da conta do dispositivo quando você estiver usando o Active Directory. Para usar uma conta de dispositivo do Active Directory, você deve especificar DomainName e UserName para a conta do dispositivo.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

DeviceAccount/UserPrincipalName

NOME UPN da conta do dispositivo. Para usar uma conta de dispositivo do Azure Active Directory ou uma implantação híbrida, você deve especificar o UPN da conta de dispositivo.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

DeviceAccount/SipAddress

Endereço SIP da conta do dispositivo. Normalmente, o dispositivo tentará descobrir automaticamente o SIP. Esse campo só será necessário se a descoberta automática falhar.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

DeviceAccount/Password

Senha da conta de dispositivo.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace. A operação Get é permitida, mas sempre retornará um espaço em branco.

DeviceAccount/ValidateAndCommit

Esse método valida os dados fornecidos e confirma as alterações.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Execute.

DeviceAccount/Email

O endereço de email da conta de dispositivo. O tipo de dados é cadeia de caracteres.

DeviceAccount/PasswordRotationEnabled

Especifica se o rodízio de senha automática está habilitado. Se você aplicar uma política de expiração de senha na conta de dispositivo, use esta configuração para permitir que o dispositivo gerencie sua própria senha alterando-a com frequência, sem que você precise atualizar manualmente as informações da conta quando a senha expirar. Você pode redefinir a senha a qualquer momento usando o Active Directory (ou Azure AD).

Valores válidos:

  • 0 – rotação de senha habilitada
  • 1 - desabilitado

Ele executa o seguinte:

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

DeviceAccount/ExchangeServer

Exchange Server da conta do dispositivo. Normalmente, o dispositivo tentará descobrir automaticamente o servidor Exchange. Esse campo só será necessário se a descoberta automática falhar.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

DeviceAccount/ExchangeModernAuthEnabled

Adicionado na KB4598291 para Windows 10, versão 20H2. Especifica se a sincronização de calendário da Conta de Dispositivo tentará usar a Autenticação Moderna baseada em token para se conectar ao Exchange Server. O valor padrão é True.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

DeviceAccount/CalendarSyncEnabled

Especifica se a sincronização de calendário e outros serviços do Exchange Server está habilitada.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

DeviceAccount/ErrorContext

Se houver um erro chamando ValidateAndCommit, haverá outro contexto para esse erro neste nó. Estes são os valores de erro possíveis:

Valor errorContext Estágio em que ocorreu o erro Descrição e sugestões
1 Desconhecido
2 Preenchendo conta Não é possível recuperar detalhes da conta usando o nome de usuário e a senha fornecidos.

Para Azure AD contas, verifique se UserPrincipalName e Password são válidos.
Para contas do AD, verifique se DomainName, UserName e Password são válidos.
Verifique se a conta especificada tem uma caixa de correio do servidor Exchange.
3 Preenchendo o endereço do servidor Exchange Não é possível descobrir automaticamente o endereço do servidor Exchange. Tente especificar manualmente o endereço do servidor Exchange usando o campo ExchangeServer.
4 Validando o endereço do servidor Exchange Não é possível validar o endereço do servidor Exchange. Verifique se o campo ExchangeServer é válido.
5 Salvando informações da conta Não é possível salvar os detalhes da conta no sistema.
6 Validando políticas de EAS A conta do dispositivo usa uma política de EAS sem suporte. Verifique se a política de EAS está configurada corretamente de acordo com o guia do administrador.

Ele executa o seguinte:

  • O tipo de dados é inteiro.
  • A operação com suporte é Get.

MaintenanceHoursSimple/Hours Nó para agendamento de manutenção.

MaintenanceHoursSimple/Hours/StartTime

Especifica a hora de início para as horas de manutenção em minutos a partir da meia-noite. Por exemplo, para definir uma hora de início de 2h, defina esse valor como 120.

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

MaintenanceHoursSimple/Hours/Duration

Especifica a duração da janela de manutenção em minutos. Por exemplo, para definir uma duração de três horas, defina o valor como 180.

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

InBoxApps

Nó para as configurações do aplicativo in-box.

InBoxApps/SkypeForBusiness

Adicionado ao Windows 10, versão 1703. Nó para as Skype for Business configurações.

InBoxApps/SkypeForBusiness/DomainName

Adicionado ao Windows 10, versão 1703. Especifica o domínio da conta Skype for Business quando você está usando o Active Directory. Para obter mais informações, consulte Configurar o Skype for Business Online.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

InBoxApps/Bem-vindo Nó para a tela de boas-vindas.

InBoxApps/Welcome/AutoWakeScreen

Ativar automaticamente a tela usando sensores de movimento.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

InBoxApps/Welcome/CurrentBackgroundPath

Local de download da imagem, a ser usado como tela de fundo durante as sessões do usuário e na tela de boas-vindas. Para definir esse local, especifique uma URL https para um arquivo PNG de 32 bits (somente PNGs têm suporte por motivos de segurança). Se alguma autoridade de certificação precisar ser confiável para acessar a URL, verifique se elas são válidas e instaladas no Hub. Caso contrário, talvez não seja possível carregar a imagem.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

InBoxApps/Welcome/MeetingInfoOption

Informações da reunião exibidas na tela de boas-vindas.

Valores válidos:

  • 0 - Organizador e somente hora
  • 1 - Organizador, hora e assunto. O assunto está oculto em reuniões particulares.

Ele executa o seguinte:

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

InBoxApps/Whiteboard

Nó para as configurações do aplicativo Whiteboard.

InBoxApps/Whiteboard/SharingDisabled

Não são permitidos convites para colaborar por meio do aplicativo Whiteboard.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

InBoxApps/Whiteboard/SigninDisabled

As entradas do aplicativo Whiteboard não são permitidas.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

InBoxApps/Whiteboard/TelemeteryDisabled

A coleta de telemetria do aplicativo Whiteboard não é permitida.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

InBoxApps/WirelessProjection

Nó para as configurações do aplicativo projetor sem fio.

InBoxApps/WirelessProjection/PINRequired

Os usuários devem inserir um PIN para o projeto sem fio no dispositivo.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

InBoxApps/WirelessProjection/Enabled

Permite a projeção sem fio no dispositivo.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

InBoxApps/WirelessProjection/Channel

Canal sem fio a ser usado na operação do Miracast. Os canais com suporte são definidos pela especificação Wi-Fi Alliance Wi-Fi Direct.

Compatibilidade Valores
Funciona com todos os remetentes Miracast em todas as regiões 1, 3, 4, 5, 6, 7, 8, 9, 10, 11
Funciona com todos os remetentes miracast da banda de 5ghz em todas as regiões 36, 40, 44, 48
Funciona com todos os remetentes miracast da banda de 5ghz em todas as regiões, exceto no Japão 149, 153, 157, 161, 165

O valor padrão é 255. Fora das preocupações regulatórias, se o canal estiver configurado incorretamente, o driver não será inicializado ou será transmitido no canal errado (que os remetentes'não estão procurando).

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

InBoxApps/Connect

Adicionado ao Windows 10, versão 1703. Nó para o aplicativo Connect.

InBoxApps/Connect/AutoLaunch

Adicionado ao Windows 10, versão 1703. Especifica se o aplicativo Connect deve ser iniciado automaticamente sempre que uma projeção é iniciada.

Se essa configuração for verdadeira, o aplicativo Connect será iniciado automaticamente. Se for false, o usuário precisará iniciar o aplicativo Connect manualmente nas configurações do Hub.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

Propriedades

Nó para as propriedades do dispositivo.

Properties/FriendlyName

Nome amigável do dispositivo. Especifica o nome que os usuários veem quando querem um projeto sem fio para o dispositivo.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

Properties/DefaultVolume

Adicionado ao Windows 10, versão 1703. Especifica o valor de volume padrão para uma nova sessão. Os valores permitidos são 0-100. O padrão é 45.

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

Properties/DefaultAutomaticFraming

Adicionado no KB5010415 para Windows 10, versão 20H2. Especifica se o recurso de Câmera Inteligente do Surface Hub 2 para aplicar zoom e manter os usuários centralizados no vídeo está habilitado. O valor padrão é True.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

Properties/ScreenTimeout

Adicionado ao Windows 10, versão 1703. Especifica o número de minutos até que a tela do Hub seja desativada.

A tabela a seguir mostra os valores permitidos.

Valor Descrição
0 Nunca expirar
1 1 minuto
2 2 minutos
3 3 minutos
5 5 minutos (padrão)
10 10 minutos
15 15 minutos
30 30 minutos
60 1 hora
120 2 horas
240 4 horas

Ele executa o seguinte:

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

Properties/SessionTimeout

Adicionado ao Windows 10, versão 1703. Especifica o número de minutos até a sessão expirar.

A tabela a seguir mostra os valores permitidos.

Valor Descrição
0 Nunca expirar
1 1 minuto (padrão)
2 2 minutos
3 3 minutos
5 5 minutos
10 10 minutos
15 15 minutos
30 30 minutos
60 1 hora
120 2 horas
240 4 horas

Ele executa o seguinte:

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

Properties/SleepTimeout

Adicionado ao Windows 10, versão 1703. Especifica o número de minutos até que o Hub entre no modo de atividade.

A tabela a seguir mostra os valores permitidos.

Valor Descrição
0 Nunca expirar
1 1 minuto
2 2 minutos
3 3 minutos
5 5 minutos (padrão)
10 10 minutos
15 15 minutos
30 30 minutos
60 1 hora
120 2 horas
240 4 horas

Ele executa o seguinte:

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

Properties/SleepMode

Adicionado no Windows 10, versão 20H2. Especifica o tipo de modo de compatibilidade para o Surface Hub.

Valores válidos:

  • 0 – Espera Conectada (padrão)
  • 1 - Hibernar

Ele executa o seguinte:

  • O tipo de dados é inteiro.
  • A operação com suporte é Get e Replace.

Properties/AllowSessionResume

Adicionado ao Windows 10, versão 1703. Especifica se a capacidade de retomar uma sessão quando a sessão expirar.

Se essa configuração for verdadeira, o recurso "Retomar Sessão" estará disponível na tela de boas-vindas quando a tela estiver ociosa. Se for false, depois que a tela ficar ociosa, a sessão será limpa automaticamente como se o "recurso Encerrar Sessão" tivesse sido iniciado.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

Properties/AllowAutoProxyAuth

Adicionado ao Windows 10, versão 1703. Especifica se a conta de dispositivo deve ser usada para autenticação de proxy.

Se essa configuração for verdadeira, a conta do dispositivo será usada para autenticação de proxy. Se for false, uma conta separada será usada.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

Propriedades/ProxyServers

Adicionado na KB4499162 para Windows 10, versão 1703. Especifica nomes de host de servidores proxy para fornecer automaticamente credenciais de conta de dispositivo antes de qualquer interação do usuário (se AllowAutoProxyAuth estiver habilitado). Esta é uma lista separada por ponto e vírgula de nomes de servidor (FQDN), sem nenhum prefixo extra (por exemplo, https://).

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

Properties/DisableSigninSuggestions

Adicionado ao Windows 10, versão 1703. Especifica se o preenchimento automático da caixa de diálogo de entrada deve ser desabilitado com convidados de reuniões agendadas.

Se essa configuração for verdadeira, a caixa de diálogo de entrada não será preenchida. Se for false, a caixa de diálogo será preenchida automaticamente.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

Properties/DoNotShowMyMeetingsAndFiles

Adicionado ao Windows 10, versão 1703. Especifica se o recurso "" Minhas reuniões e arquivos deve ser desabilitado no menu Iniciar, que mostra o usuário conectado'reuniões e arquivos do Office 365.

Se essa configuração for verdadeira, o recurso "Minhas reuniões e arquivos" não será mostrado. Quando false, o recurso "Minhas reuniões e arquivos" será mostrado.

  • O tipo de dados é booliano.
  • A operação com suporte é Get e Replace.

MOMAgent

Nó para o Microsoft Operations Management Suite.

MOMAgent/WorkspaceID

GUID identificando a ID do workspace do Microsoft Operations Management Suite para coletar os dados. Defina esse GUID como uma cadeia de caracteres vazia para desabilitar o agente MOM.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace.

MOMAgent/WorkspaceKey

Chave primária para autenticação do espaço de trabalho.

  • O tipo de dados é cadeia de caracteres.
  • A operação com suporte é Get e Replace. A operação Get é permitida, mas sempre retornará uma cadeia de caracteres vazia.

Tópicos relacionados

Referência de provedor de serviços de configuração