Test-CsMcxP2PIM

 

Tópico modificado em: 2013-05-28

Testa a capacidade de dois usuários trocarem mensagens instantâneas usando o Microsoft Lync Server 2010 Mobility Service. O Mobility Service permite que os usuários de telefones móveis (como iPhones e Windows Phones) façam operações com trocar mensagens instantâneas e informações de presença; armazenem e recuperam a caixa postal internamente e não com o provedor sem fio; e aproveitem as vantagens dos recursos do Microsoft Lync Server 2010, como a Chamada via Trabalho ou a conferência discada.

Sintaxe

Test-CsMcxP2PIM -TargetFqdn <String> -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]

Descrição Detalhada

O Microsoft Lync Server 2010 Mobility Service estende muitos dos recursos do Microsoft Lync 2010 para dispositivos móveis, como Apple iPhones, Windows Phone, telefones Android e Nokia. Entre outras coisas, os usuários podem usar esses telefones para trocar mensagens instantâneas e informações de presença, e para receber notificações de novas caixas postais. Graças ao serviço de notificação de envio por push (Apple Push Notification Service e Microsoft Lync Server 2010 Push Notification Service), os usuários com iPhones ou Windows Phones podem receber essas notificações, mesmo quando o Lync 2010 está sendo executado em segundo plano. O Mobility Service também fornece a oportunidade para as organizações habilitarem a Chamada via Trabalho. Com a Chamada via Trabalho, os usuários podem fazer uma chamada de seu celular e fazer com que ela pareça ter sido originada do telefone comercial; por exemplo, os sistemas de ID de Chamadas exibirão o número comercial do usuário, em vez do número do celular dele(a).

O cmdlet Test-CsMcxP2PIM é usado para determinar se dois usuários são capazes de trocar mensagens instantâneas usando o Mobility Service. Observe que executar esse cmdlet não exige o uso de telefones celulares nem envia mensagens instantâneas. Em vez disso, o cmdlet verifica se dois usuários são capazes de fazer logon no Lync Server 2010 e se o Mobility Service é capaz de fazer as conexões necessárias para trocar mensagens instantâneas entre os dois usuários.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Test-CsMcxP2PIM localmente: RTCUniversalServerAdmins.

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
TargetFqdn	Obrigatório	Cadeia de caracteres	Nome do domínio totalmente qualificado (FQDN) do pool a ser testado.
ReceiverCredential	Obrigatório	PSCredential	Objeto de credenciais de usuário para a primeira das duas contas de usuário a serem testadas. O valor passado para ReceiverCredential deve ser uma referência de objeto obtida com o cmdlet Get-Credential. Por exemplo, este código retorna um objeto de credencial para o usuário litwareinc\pilar e armazena esse objeto em uma variável chamada $y: $y = Get-Credential "litwareinc\pilar" É necessário fornecer ao usuário uma senha ao executar esse comando.
ReceiverSipAddress	Obrigatório	Cadeia de caracteres	Endereço SIP para a primeira das duas contas de usuário a serem testadas. Por exemplo: -ReceiverSipAddress "sip:pilar@litwareinc.com" O parâmetro ReceiverSIPAddress deve referenciar a mesma conta de usuário de ReceiverCredential.
SenderCredential	Obrigatório	PSCredential	Objeto de credenciais de usuário para a segunda das duas contas de usuário a serem testadas. O valor passado para SenderCredential deve ser uma referência de objeto obtida com o cmdlet Get-Credential. Por exemplo, este código retorna um objeto de credencial para o usuário litwareinc\kenmyer e armazena esse objeto em uma variável chamada $x: $x = Get-Credential "litwareinc\kenmyer" É necessário fornecer ao usuário uma senha ao executar esse comando.
SenderSipAddress	Obrigatório	Cadeia de caracteres	Endereço SIP para a segunda das duas contas de usuário a serem testadas. Por exemplo: -SenderSipAddress "sip:kenmyer@litwareinc.com" O parâmetro SenderSipAddress deve referenciar a mesma conta de usuário do parâmetro SenderCredential.
OutVerboseVariable	Opcional	Cadeia de caracteres	Quando presente, a saída detalhada da execução do cmdlet será armazenada na variável especificada. Por exemplo, para armazenar a saída em uma variável denominada $TestOutput, use a seguinte sintaxe: -OutVerboseVariable TestOutput Não use um caractere $ como prefixo ao especificar o nome da variável.
RegistrarPort	Opcional	Inteiro	Porta SIP usada pelo serviço Registrador. Esse parâmetro não é necessário se o Registrador usar a porta padrão 5061.
Verbose	Opcional	SwitchParameter	Relata na tela a atividade detalhada, à medida que o cmdlet for executado.

Tipos de Entrada

Nenhuma. Test-CsMcxP2PIM não aceita a entrada canalizada.

Tipos de Retorno

Test-CsMcxP2PIM retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.

Exemplo

-------------------------- Exemplo 1 --------------------------

$credential1 = Get-Credential "litwareinc\kenmyer"
$credential2 = Get-Credential "litwareinc\pilar"

Test-CsMcxP2PIM -TargetFqdn "atl-cs-001.litwareinc.com" -Authentication Negotiate -SenderSipAddres "sip:kenmyer@litwareinc.com" -SenderCredential $credential1 -ReceiverSipAddress "sip:packerman@litwareinc.com" -ReceiverCredential $credential2

Os comandos mostrados no Exemplo 1 testam para visualizar se dois usuários – Ken Myer e Pilar Ackerman – são capazes de trocar mensagens instantâneas usando o Mobility Service. Para fazer isso, os primeiros dois comandos no exemplo usam o cmdlet Get-Credential para criar objetos de credenciais para os dois usuários; as credenciais de Ken Myer são armazenadas em uma variável denominada $credential1 e as credenciais de Pilar Ackerman são armazenadas em uma variável denominada $credential2.

Depois de criar os objetos de credenciais, o comando chama o cmdlet Test-CsMcxP2PIM, certificando-se de especificar o pool do Registrador de destino (atl-cs-001.litwareinc.com), o tipo de autenticação (Negotiate) e os endereços SIP e as credenciais dos dois usuários.