Compartir a través de

Get-CMSiteRole

  • Referencia
Módulo:
ConfigurationManager

Obtener un objeto de rol de sitio.

Sintaxis

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

Description

Devuelve los roles instalados en un servidor de sistema de sitio de Configuration Manager. Por ejemplo, un punto de administración o un punto de distribución.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Obtener todos los roles de todos los sitios

En este ejemplo se obtienen todos los roles de todos los sitios de la jerarquía.

Get-CMSiteRole -AllSite

Ejemplo 2: Obtención de todos los roles de un sitio específico

En este ejemplo se obtienen todos los roles del sitio P01.

Get-CMSiteRole -SiteCode P01

Ejemplo 3: Obtención de roles para un servidor específico

En este ejemplo se obtienen todos los roles instalados en el sistema de sitio cm01.contoso.local.

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

Ejemplo 4: Contar todos los puntos de administración

En este ejemplo se obtienen todos los puntos de administración de la jerarquía y se muestra el recuento.

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

Ejemplo 5: Enumerar todos los roles por nombre

En este ejemplo se enumeran los nombres de rol de todos los sitios de la jerarquía.

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

Parámetros

-AllSite

Incluya este parámetro para obtener todos los roles del sitio.

Tipo:SwitchParameter
Alias:AllSites
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-RoleName

Especifique un nombre de rol específico que se va a obtener. El valor es la cadena de la propiedad RoleName de la clase SMS_SCI_SysResUse . Por ejemplo:

  • 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

Nota:

Es posible que esta lista no incluya todos los roles de sitio posibles.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-SiteCode

Especifique el código de sitio para el rol de sitio específico.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SiteSystemServerName

Especifique el nombre de un servidor de sistema de sitio específico del que se va a obtener el rol.

Tipo:String
Alias:Name, ServerName
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject[]

IResultObject