Partager via

Get-CMSiteRole

  • Référence
Module:
ConfigurationManager

Obtenir un objet de rôle de site.

Syntaxe

Get-CMSiteRole
   [-AllSite]
   [-RoleName <String>]
   [-SiteCode <String>]
   [[-SiteSystemServerName] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSiteRole
   [-AllSite]
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Retourne les rôles installés sur un serveur de système de site Configuration Manager. Par exemple, un point de gestion ou un point de distribution.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir tous les rôles de tous les sites

Cet exemple obtient tous les rôles pour tous les sites de la hiérarchie.

Get-CMSiteRole -AllSite

Exemple 2 : Obtenir tous les rôles pour un site spécifique

Cet exemple obtient tous les rôles du site P01.

Get-CMSiteRole -SiteCode P01

Exemple 3 : Obtenir des rôles pour un serveur spécifique

Cet exemple obtient tous les rôles installés sur le système de site cm01.contoso.local.

Get-CMSiteRole -SiteSystemServerName "cm01.contoso.local"

Exemple 4 : Compter tous les points de gestion

Cet exemple obtient tous les points de gestion de la hiérarchie et affiche le nombre.

$mp = Get-CMSiteRole -RoleName "SMS Management Point" -AllSite
$mp.Count

Exemple 5 : Répertorier tous les rôles par nom

Cet exemple répertorie les noms de rôles de tous les sites de la hiérarchie.

$allRoles = Get-CMSiteRole -AllSite
$allRoles.RoleName

Paramètres

-AllSite

Incluez ce paramètre pour obtenir tous les rôles du site.

Type:SwitchParameter
Alias:AllSites
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-RoleName

Spécifiez un nom de rôle spécifique à obtenir. La valeur est la chaîne de la propriété RoleName sur la classe SMS_SCI_SysResUse . Par exemple :

  • SMS Site System
  • SMS Component Server
  • SMS Distribution Point
  • SMS Management Point
  • SMS Device Management Point
  • SMS Software Update Point
  • SMS Enrollment Server
  • SMS Enrollment Web Site
  • SMS Notification Server
  • SMS Certificate Registration Point
  • SMS DM Enrollment Service
  • SMS Site Server
  • SMS State Migration Point
  • SMS Provider
  • SMS Cloud Proxy Connector
  • SMS SQL Server
  • SMS Fallback Status Point
  • AI Update Service Point
  • SMS SRS Reporting Point
  • SMS Endpoint Protection Point
  • Data Warehouse Service Point
  • SMS Dmp Connector

Remarque

Cette liste peut ne pas inclure tous les rôles de site possibles.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-SiteCode

Spécifiez le code de site pour le rôle de site spécifique.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SiteSystemServerName

Spécifiez le nom d’un serveur de système de site spécifique à partir duquel obtenir le rôle.

Type:String
Alias:Name, ServerName
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject[]

IResultObject