Compartilhar via

Get-CMSiteRole

  • Referência
Módulo:
ConfigurationManager

Obtenha 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

Retorna as funções instaladas em um servidor do sistema de site Configuration Manager. Por exemplo, um ponto de gerenciamento ou ponto de distribuição.

Observação

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

Exemplos

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

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

Get-CMSiteRole -AllSite

Exemplo 2: Obter todas as funções para 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 gerenciamento

Este exemplo obtém todos os pontos de gerenciamento na hierarquia e exibe 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ção para todos os sites na hierarquia.

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

Parâmetros

-AllSite

Inclua esse 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

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 a ser obtido. O valor é a cadeia de caracteres 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

Essa 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 de sistema de site específico 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