Get-CsCallParkOrbit
Tópico modificado em: 2012-03-23
Obtém as configurações de intervalo de órbita do estacionamento de chamada da organização.
Sintaxe
Get-CsCallParkOrbit [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsCallParkOrbit [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
Este cmdlet recupera as configurações das órbitas do estacionamento de chamada definidas para uma organização. É possível recuperar um único intervalo de órbita do estacionamento de chamada (especificado pelo parâmetro Identity) ou chamar Get-CsCallParkOrbit sem nenhum parâmetro para recuperar todos os intervalos de órbitas do estacionamento de chamada definidos para uma organização. As órbitas do estacionamento de chamada são compostas de configurações que especificam um intervalo de números nos quais um usuário pode estacionar uma chamada e os servidores associados a esses intervalos de números.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsCallParkOrbit localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. 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 "Get-CsCallParkOrbit"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Cadeia de caracteres |
O nome exclusivo do intervalo de órbitas do estacionamento de chamada. Esse nome foi atribuído pelo administrador quando o intervalo de órbitas do estacionamento de chamada foi definida. |
Filter |
Opcional |
Cadeia de caracteres |
Este parâmetro aceita uma cadeia de caracteres curinga e retorna todos os intervalos de órbitas do estacionamento de chamada com identidades correspondentes a essa cadeia de caracteres. Por exemplo, um valor Filter de Redmond* retornará todos os intervalos de órbitas do estacionamento de chamada com nomes que comecem com a cadeia de caracteres Redmond, como Redmond 1, Redmond 2, RedmondCPO etc. |
LocalStore |
Opcional |
Guid |
Recupera as informações de órbita de estacionamento de chamada a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Nenhuma.
Tipos de Retorno
Este cmdlet retorna um objeto do tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbits.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsCallParkOrbit
Neste exemplo, Get-CsCallParkOrbit é chamado sem especificar nenhum parâmetro adicional. Quando chamado assim, Get-CsCallParkOrbit retorna uma coleção de todos os intervalos de órbitas do estacionamento de chamada configurados para uso na organização.
-------------------------- Exemplo 2 --------------------------
Get-CsCallParkOrbit -Identity "Redmond CPO 1"
No exemplo anterior, Get-CsCallParkOrbit é usado para retornar informações sobre o intervalo de órbitas do estacionamento de chamada com o nome "Redmond CPO 1".
-------------------------- Exemplo 3 --------------------------
Get-CsCallParkOrbit -Filter *Redmond*
O comando neste exemplo retorna todos os intervalos de órbitas do estacionamento de chamada com a cadeia de caracteres "Redmond" no parâmetro Identity. Por exemplo, este comando retornará órbitas do estacionamento de chamada como "Redmond 501", "CP Redmond 1" e "ARedmond". O comando usa o parâmetro Filter com o caractere curinga (*) para designar o que procurar. (a pesquisa não diferencia maiúsculas de minúsculas).
-------------------------- Exemplo 4 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.CallParkServiceId.toString() -eq "ApplicationServer:pool0.litwareinc.com"}
Este comando retorna todos os intervalos de órbitas do estacionamento de chamada atribuídos ao serviço de estacionamento de chamada com o ID ApplicationServer:pool0.litwareinc.com. O cmdlet Get-CsCallParkOrbit recupera uma coleção de todos os intervalos de órbitas do estacionamento de chamada e, em seguida, redireciona essa coleção para o cmdlet Where-Object. Essa chamada para Where-Object encontra todas as órbitas do estacionamento de chamada na coleção com um valor de ApplicationServer:pool0.litwareinc.com nas propriedades CallParkServiceId. Observe que adicionamos o método toString ao fim do nome de parâmetro CallParkServiceId. O CallParkServiceId é do tipo WritableServiceId. Para comparar esse valor à cadeia de caracteres fornecida, primeiro devemos transformá-lo em uma cadeia de caracteres chamando o método toString.
-------------------------- Exemplo 5 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.NumberRangeStart.StartsWith("*")}
O comando neste exemplo retorna todos os intervalos de órbitas do estacionamento de chamada nos quais o intervalo de números comece com um prefixo *. Depois que Get-CsCallParkOrbit recupera uma coleção de todos os intervalos de órbitas do estacionamento de chamada, a coleção é redirecionada para Where-Object. Where-Object restringe a coleção apenas aos intervalos de órbitas do estacionamento de chamada que tenham um local de estacionamento de chamada começando com um *. Ele faz isso verificando a propriedade StartsWith do objeto NumberRangeStart da cadeia de caracteres "*".
-------------------------- Exemplo 6 --------------------------
Get-CsCallParkOrbit | Where-Object {[Char]::IsDigit($_.NumberRangeStart[0])}
O comando neste exemplo retorna todos os intervalos de órbitas de estacionamento de chamada nos quais nenhum prefixo tenha sido atribuído aos números no intervalo. (Prefixo é o valor * ou # colocado no início do número.) Todas as órbitas do estacionamento de chamada retornadas pelo comando terão intervalos consistindo apenas em números sem outros caracteres incluídos. Get-CsCallParkOrbit recupera uma coleção de todos os intervalos de órbitas do estacionamento de chamada e, em seguida, essa coleção é redirecionada para Where-Object. Observando os critérios na chamada para Where-Object, vemos isto: $_.NumberRangeStart[0]). Ele retorna o primeiro caractere no número no início do intervalo. (observe que precisamos verificar somente o início do intervalo — se o número de início no intervalo não tiver um prefixo, o final também não terá). Esse caractere é passado para a função IsDigit a fim de determinar se ele é um caractere numérico. Se for, as informações da órbita do estacionamento de chamada para item de coleção correspondente serão retornadas.