Set-CsLisServiceProvider
Tópico modificado em: 2012-03-27
Cria ou modifica informações sobre o serviço Web fornecido pelo provedor de roteamento de rede do Enhanced 9-1-1 (E9-1-1) para verificar locais.
Sintaxe
Set-CsLisServiceProvider -CertFileName <String> -Password <SecureString> -ServiceProviderName <String> -ValidationServiceUrl <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Em uma implementação do Enterprise Voice com E9-1-1, as chamadas de emergência precisam ser roteadas primeiramente por um provedor de roteamento de rede E9-1-1 para garantir que as chamadas sejam roteadas para o PSAP (ponto de atendimento de segurança pública) apropriado. (Um PSAP é uma agência dos Estados Unidos que direciona chamadas para os serviços de emergência mais próximos, como polícia, corpo de bombeiros e ambulâncias.) Para fazer isso, o provedor precisa ter uma lista de locais da organização que possa relacionar ao MSAG (guia-mestre de endereços) para garantir que todos os locais sejam válidos. Este cmdlet cria ou modifica informações sobre um provedor, inclusive o nome do provedor, uma URL para o serviço Web que a organização vai usar para enviar os locais e um certificado e senha para o serviço Web seguro.
Você não pode definir mais do que um fornecedor de serviço para uma determinada implementação de E9-1-1. Este cmdlet não vai ter sucesso a menos que possa resolver a URL e informação de segurança para o serviço da web.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsLisServiceProvider localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisServiceProvider"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
CertFileName |
Obrigatório |
Cadeia de caracteres |
O nome (e caminho completo) do arquivo de certificado. Este arquivo deve ter uma extensão de arquivo PFX. |
Password |
Obrigatório |
SecureString |
Uma cadeia de caracteres segura contendo a senha necessária para acessar o certificado no arquivo protegido com senha. Cadeias de caracteres seguras podem ser criadas usando o cmdlet ConvertTo-SecureString ou o cmdlet Read-Host com o parâmetro AsSecureString. |
ServiceProviderName |
Obrigatório |
Cadeia de caracteres |
O nome do E9-1-1 Network Routing Provider. |
ValidationServiceUrl |
Obrigatório |
Cadeia de caracteres |
A URL do serviço da web. Deve ser uma URL segura, começando com o prefixo https://. |
WhatIf |
Opcional |
SwitchParameter |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
SwitchParameter |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Aceita entrada em pipeline dos objetos do provedor de serviços LIS (servidor de informações de local).
Tipos de Retorno
Este cmdlet cria ou modifica um objeto do tipo System.Management.Automation.PSCustomObject.
Exemplo
-------------------------- Exemplo 1 --------------------------
$p = Read-Host -AsSecureString
Set-CsLisServiceProvider -ServiceProviderName E911Provider -ValidationServiceUrl https://www.911contoso.com/validation/ -CertFileName C:\MS-Contoso-Cert.pfx -Password $p
Um dos parâmetros necessários para criar uma entrada para um serviço da web E9-1-1 Network Routing Provider é uma cadeia de caracteres segura contendo uma senha para acessar o arquivo de certificado. Por esta razão, a primeira linha neste exemplo é uma chamada ao cmdlet do Windows PowerShellRead-Host. Read-Host vai solicitar entrada ao usuário. Especificamos o parâmetro AsSecureString, que vai exibir essa entrada como asteriscos (*) à medida em que ela for inserida. Nós atribuímos o resultado deste comando à variável $p. O resultado vai ser uma cadeia de caracteres segura, que é uma versão criptografada da entrada do usuário. Em outras palavras, executar este comando vai solicitar a senha do serviço da web e vai armazenar esta senha na variável $p.
Agora que nós temos a senha, nós podemos criar um objeto que vai acessar o serviço da web. Fazemos isso chamando o cmdlet Set-CsLisServiceProvider. Nós passamos vários parâmetros a este cmdlet. O primeiro é o nome do provedor, neste caso, E911Provider. Em seguida, nós fornecemos um valor para ValidationServiceUrl, https://www.911contoso.com/validation/. Observe que este deve ser um “site seguro”, com o prefixo https, e não http. Em seguida, digitamos o nome do arquivo contendo o certificado usado para acessar este serviço da Web, C:\MS-Contoso-Cert.pfx. Finalmente, passamos a variável $p (que contém a cadeia de caracteres de segurança com a senha do serviço Web) ao parâmetro Password.