Get-CsComputer
Dernière rubrique modifiée : 2012-03-23
Retourne les informations relatives aux ordinateurs de votre infrastructure Microsoft Lync Server 2010 dont le rôle est de fournir des services.
Syntaxe
Get-CsComputer [-Identity <XdsGlobalRelativeIdentity>] [-Pool <String>]
Get-CsComputer [-Filter <String>] [-Pool <String>]
Description détaillée
Get-CsComputer fournit un moyen d’identifier rapidement les ordinateurs qui exploitent les services Lync Server 2010 ou des rôles serveur. Appelé sans aucun paramètre, Get-CsComputerretourne une collection de tous les ordinateurs qui exploitent les services Lync Server 2010 ou des rôles serveur. Cette collection inclut l’identité, le nom de pool et le nom du domaine complet de chaque ordinateur. Vous pouvez également utiliser des paramètres facultatifs tels que Identity, Filter ou Pool, pour limiter le renvoi des données à un seul ordinateur ou un groupe d’ordinateurs.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsComputer : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Chaîne |
Nom de domaine complet à retourner. Par exemple : -Identity "atl-cs-001.litwareinc.com". Si ce paramètre n’est pas spécifié, tous les ordinateurs exécutant Lync Server 2010 seront retournés. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques pour spécifier l’identité de l’ordinateur (ou des ordinateurs) dont les informations doivent être renvoyées. Par exemple, cette commande retourne des informations sur les ordinateurs dont l’identité commence par la valeur de chaîne « atl- » : -Filter "atl-*". |
Pool |
Facultatif |
Chaîne |
Nom de domaine complet d’un pool Lync Server 2010. Si vous utilisez ce paramètre, ce sont les informations de tous les ordinateurs dans le pool spécifié qui seront renvoyées. |
Types d’entrées
Aucun. Get-CsComputer n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsComputer retourne les instances de l’objet Microsoft.Rtc.Management.Deploy.Internal.Machine.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsComputer
Dans l’exemple 1, la cmdlet Get-CsComputer est utilisée pour retourner les informations des ordinateurs dont le rôle est de fournir des services dans votre infrastructure Lync Server 2010.
-------------------------- Exemple 2 --------------------------
Get-CsComputer -Filter "*.litwareinc.com"
La commande indiquée à l’exemple 2 utilise le paramètre Filter pour retourner les informations des ordinateurs dont le rôle est de fournir des services et qui font partie du domaine litwareinc.com. La chaîne générique *.litwareinc.com restreint le renvoi d’informations aux ordinateurs dont le nom de domaine complet (FQDN) se termine par la valeur de chaîne .litwareinc.com.
-------------------------- Exemple 3 --------------------------
Get-CsComputer -Identity "atl-cs-001.litwareinc.com"
Dans l’exemple précédent, le paramètre Identity est utilisé pour restreindre le renvoi des données à un ordinateur dont le nom de domaine complet est atl-cs-001.litwareinc.com.
-------------------------- Exemple 4 --------------------------
Get-CsComputer -Pool "atl-cs-001.litwareinc.com"
Dans l’exemple 4, le paramètre Pool est utilisé pour retourner des informations sur tous les ordinateurs du pool atl-cs-001.litwareinc.com.