Get-CsApplicationEndpoint
Tópico modificado em: 2012-03-23
Recupera pontos de extremidade do Serviço de aplicativos.
Sintaxe
Get-CsApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-PoolFqdn <String>] [-ResultSize <Unlimited>]
Descrição Detalhada
Este cmdlet recupera um ou mais contatos de aplicativo do Serviços de Domínio Active Directory (AD DS). Esses objetos são armazenados no Active Directory no contêiner Contatos de aplicativo do serviço RTC.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsApplicationEndpoint localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsApplicationEndpoint"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
UserIdParameter |
A identidade, o endereço SIP ou o nome para exibição do ponto de extremidade do aplicativo a ser recuperado. A identidade consiste no nome diferenciado do ponto de extremidade. Normalmente, ele conterá um identificador global exclusivo (GUID) como parte do CN. Por exemplo: CN={8811fefe-e0bb-4fab-ae39-7aaeddd423dc},CN=Application Contacts,CN=RTC Service,CN=Services,CN=Configuration,DC=Vdomain,DC=com. |
ApplicationId |
Opcional |
Cadeia de caracteres |
O ID do aplicativo do ponto de extremidade do aplicativo que se deseja recuperar. O ID do aplicativo é o valor da propriedade OwnerUrn do ponto de extremidade. Por exemplo, se a propriedade OwnerUrn tiver um valor urn:application:Caa, o ID do aplicativo será urn:application:Caa. Entretanto, é possível digitar apenas o sufixo (Caa, neste caso) para recuperar o ponto de extremidade. Por exemplo: -ApplicationId Caa |
Credential |
Opcional |
PSCredential |
Credenciais alternativas com as quais se dará prosseguimento à operação Get. É possível recuperar um objeto PSCredential chamando-se o cmdlet Get-Credential do Windows PowerShell. |
DomainController |
Opcional |
Fqdn |
Permite especificar um controlador de domínio. Se nenhum controlador de domínio for especificado, será utilizado o primeiro disponível. |
Filter |
Opcional |
Cadeia de caracteres |
Permite limitar os dados retornados pela filtragem de atributos específicos a Microsoft Lync Server 2010. Por exemplo, é possível limitar os dados retornados aos contatos cujos nomes para exibição ou endereços SIP corresponderem a um determinado padrão de caracteres curinga. O parâmetro Filter usa a mesma sintaxe de filtragem do Windows PowerShell utilizada pelo cmdlet Where-Object. Por exemplo: um filtro que retorna apenas contatos que tiverem sido habilitados para o Enterprise Voice poderia ter a seguinte aparência: {EnterpriseVoiceEnabled-eq $True}, onde EnterpriseVoiceEnabled representa o atributo do Active Directory; -eq, o operador de comparação (igual a) e $True (uma variável interna do Windows PowerShell), o valor do filtro. |
OU |
Opcional |
OUIdParameter |
A unidade organizacional (OU) em que reside o ponto de extremidade. |
PoolFqdn |
Opcional |
Cadeia de caracteres |
O domínio totalmente qualificado (FQDN) do pool no qual reside o ponto de extremidade do aplicativo. |
ResultSize |
Opcional |
Ilimitado |
O número máximo de registros de ponto de extremidade a recuperar. |
Tipos de Entrada
Cadeia de caracteres. Aceita um valor canalizado de cadeia de caracteres, que representa a Identidade do ponto de extremidade do aplicativo.
Tipos de Retorno
Recupera um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsApplicationEndpoint
Este exemplo recupera informações sobre todos os pontos de extremidade de aplicativo dentro da implantação Lync Server 2010.
-------------------------- Exemplo 2 --------------------------
Get-CsApplicationEndpoint -Identity "Call Park Service Contact"
O exemplo 2 recupera informações sobre o contato de ponto de extremidade de aplicativo com o nome de exibição “Call Park Service Contact”.
-------------------------- Exemplo 3 --------------------------
Get-CsApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}
O Exemplo 3 recupera todos os pontos de extremidade do aplicativo que tiverem a cadeia de caracteres "ponto de extremidade" em qualquer posição do seu nome para exibição. Para tal, o comando utiliza o parâmetro Filter. O valor dos filtros de parâmetro para localizar os objetos de ponto de extremidade que tiverem um nome de exibição (DisplayName) que contenha (-like) a cadeia de caracteres de ponto de extremidade (*ponto de extremidade* - os caracteres curinga indicam que quaisquer caracteres podem vir antes ou após o ponto de extremidade da cadeia de caracteres, ou seja, o ponto de extremidade pode estar em qualquer posição do nome para exibição).
-------------------------- Exemplo 4 --------------------------
Get-CsApplicationEndpoint -ApplicationId tapp2 | Select-Object Identity, SipAddress, DisplayName, OwnerUrn
O Exemplo 4 retornará todos os pontos de extremidade de aplicativo associados ao aplicativo urn:application:tapp2. Isto é obtido passando-se o ID tapp2 ao parâmetro ApplicationId. Observe que não foi fornecido um pool FQDN; isto significa que se um aplicativo com o ID tapp2 existir em mais de um pool, serão recuperados os pontos de extremidade correspondentes a todos os aplicativos. A próxima parte desse comando canalizará o objeto ou objetos retornados ao cmdlet Select-Object, que exibirá apenas as propriedades Identity, SipAddress, DisplayName e OwnerUrn destes objetos.