Get-CsCallParkOrbit
Ultima modifica dell'argomento: 2012-03-23
Consente di recuperare le impostazioni di intervallo orbit del parcheggio di chiamata per l'organizzazione.
Sintassi
Get-CsCallParkOrbit [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsCallParkOrbit [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
Questo cmdlet consente di recuperare le impostazioni per gli orbit del parcheggio di chiamata definiti per un'organizzazione. È possibile recuperare un singolo intervallo orbit del parcheggio di chiamata (specificato dal parametro Identity) oppure è possibile utilizzare il cmdlet Get-CsCallParkOrbit senza parametri per recuperare tutti gli intervalli orbit del parcheggio di chiamata definiti per un'organizzazione. Gli orbit del parcheggio di chiamata sono composti da impostazioni che specificano un intervallo di numeri presso cui un utente può parcheggiare una chiamata e i server associati a questi intervalli di numeri.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsCallParkOrbit può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsCallParkOrbit"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Stringa |
Il nome univoco dell'intervallo orbit del parcheggio di chiamata. Questo nome viene assegnato dall'amministratore durante la definizione dell'intervallo orbit del parcheggio di chiamata. |
Filter |
Facoltativo |
Stringa |
Questo parametro accetta una stringa di caratteri jolly e restituisce tutti gli intervalli orbit del parcheggio di chiamata con identità corrispondenti a tale stringa. Ad esempio, il valore Redmond* specificato per il filtro consente di ottenere tutti gli orbit del parcheggio di chiamata i cui nomi iniziano con la stringa Redmond, ad esempio Redmond 1, Redmond 2 e RedmondCPO. |
LocalStore |
Facoltativo |
Guid |
Consente di recuperare i dati di orbit del parcheggio di chiamata dalla copia locale di archivio di gestione centrale invece che da archivio di gestione centrale. |
Tipi di input
Nessuno.
Tipi restituiti
Questo cmdlet restituisce un oggetto di tipo Microsoft.Rtc.Management.Voice.Helpers.DisplayCallParkOrbits.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsCallParkOrbit
In questo esempio viene utilizzato il cmdlet Get-CsCallParkOrbit senza specificare parametri aggiuntivi. Se utilizzato in questo modo, il cmdlet Get-CsCallParkOrbit restituisce una raccolta di tutti gli intervalli di orbit del parcheggio di chiamata configurati per l'utilizzo nella propria organizzazione.
-------------------------- Esempio 2 --------------------------
Get-CsCallParkOrbit -Identity "Redmond CPO 1"
Nell'esempio 2 viene utilizzato il cmdlet Get-CsCallParkOrbit per ottenere informazioni sull'intervallo di orbit del parcheggio di chiamata denominato "Redmond CPO 1".
-------------------------- Esempio 3 --------------------------
Get-CsCallParkOrbit -Filter *Redmond*
Con il comando riportato in questo esempio vengono restituiti tutti gli intervalli di orbit del parcheggio di chiamata che contengono la stringa "Redmond" nel relativo parametro Identity. Ad esempio, questo comando consente di ottenere gli orbit del parcheggio di chiamata con identità come "Redmond 501", "CP Redmond 1" e "ARedmond". Il comando utilizza il parametro Filter con il carattere jolly (*) per definire l'oggetto della ricerca. Per la ricerca non viene applicata la distinzione tra maiuscole e minuscole.
-------------------------- Esempio 4 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.CallParkServiceId.toString() -eq "ApplicationServer:pool0.litwareinc.com"}
Questo comando restituisce tutti gli intervalli di orbit del parcheggio di chiamata assegnati al servizio di parcheggio di chiamata con ID ApplicationServer:pool0.litwareinc.com. Il cmdlet Get-CsCallParkOrbit consente di recuperare una raccolta di tutti gli intervalli di orbit del parcheggio di chiamata e quindi la invia tramite pipe al cmdlet Where-Object. L'utilizzo del cmdlet Where-Object consente di trovare tutti gli orbit del parcheggio di chiamata inclusi nella raccolta i cui rispettivi parametri CallParkServiceId contengono il valore ApplicationServer:pool0.litwareinc.com. Si noti che è stata aggiunta la metodologia toString alla fine del nome del parametro CallParkServiceId. CallParkServiceId è di tipo WritableServiceId. Per poter comparare questo valore alla stringa fornita è necessario prima convertirlo in una stringa utilizzando la metodologia toString.
-------------------------- Esempio 5 --------------------------
Get-CsCallParkOrbit | Where-Object {$_.NumberRangeStart.StartsWith("*")}
Il comando riportato in questo esempio restituisce tutti gli intervalli di orbit del parcheggio di chiamata in cui l'intervallo di numeri inizia con il prefisso *. Dopo che Get-CsCallParkOrbit ha recuperato una raccolta di tutti gli intervalli di orbit del parcheggio di chiamata, la raccolta viene inviata tramite pipe al cmdlet Where-Object. Where-Object circoscrive la raccolta agli intervalli di orbit del parcheggio di chiamata la cui località inizia con *. Ciò avviene attraverso la verifica della proprietà StartsWith dell'oggetto NumberRangeStart per la stringa "*".
-------------------------- Esempio 6 --------------------------
Get-CsCallParkOrbit | Where-Object {[Char]::IsDigit($_.NumberRangeStart[0])}
Il comando riportato in questo esempio restituisce tutti gli intervalli di orbit del parcheggio di chiamata in cui ai numeri dell'intervallo non è stato assegnato alcun prefisso. Il prefisso corrisponde al valore * o # posto all'inizio del numero. Tutti gli orbit del parcheggio di chiamata restituiti da questo comando avranno intervalli costituiti esclusivamente da numeri, senza caratteri. Get-CsCallParkOrbit recupera una raccolta di tutti gli intervalli di orbit del parcheggio di chiamata, che viene poi inviata tramite pipe al cmdlet Where-Object. I criteri della chiamata a Where-Object sono i seguenti: $_.NumberRangeStart[0]). Questo criterio restituisce il primo carattere del numero iniziale dell'intervallo. Si noti che deve essere controllato solo l'inizio dell'intervallo: se il prefisso non è presente all'inizio è chiaramente assente. Questo carattere viene fornito alla funzione IsDigit per stabilire se si tratta di un carattere numerico. In questo caso, vengono restituite le informazioni sull'orbit del parcheggio di chiamata per il corrispondente elemento della raccolta.