Get-CMSiteRole

  • Referência
Módulo:
ConfigurationManager

Obter um objeto de função de site.

Sintaxe

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

Description

Devolve as funções instaladas num servidor do sistema de sites do Configuration Manager. Por exemplo, um ponto de gestão ou um ponto de distribuição.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Obter todas as funções de todos os sites

Este exemplo obtém todas as funções de todos os sites na hierarquia.

Get-CMSiteRole -AllSite

Exemplo 2: Obter todas as funções de um site específico

Este exemplo obtém todas as funções do site P01.

Get-CMSiteRole -SiteCode P01

Exemplo 3: Obter funções para um servidor específico

Este exemplo obtém todas as funções instaladas no sistema de sites cm01.contoso.local.

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

Exemplo 4: Contar todos os pontos de gestão

Este exemplo obtém todos os pontos de gestão na hierarquia e apresenta a contagem.

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

Exemplo 5: Listar todas as funções por nome

Este exemplo lista os nomes de funções de todos os sites na hierarquia.

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

Parâmetros

-AllSite

Inclua este parâmetro para obter todas as funções do site.

Tipo:SwitchParameter
Aliases:AllSites
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RoleName

Especifique um nome de função específico para obter. O valor é a cadeia da propriedade RoleName na classe SMS_SCI_SysResUse . Por exemplo:

  • 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

Observação

Esta lista pode não incluir todas as funções de site possíveis.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-SiteCode

Especifique o código do site para a função de site específica.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SiteSystemServerName

Especifique o nome de um servidor específico do sistema de sites a partir do qual obter a função.

Tipo:String
Aliases:Name, ServerName
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject