Share via

Get-CMSiteRole

  • Referência
Módulo:
ConfigurationManager

Obtenha um objeto de função de site.

Syntax

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.

Type:SwitchParameter
Aliases:AllSites
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-SiteCode

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteSystemServerName

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

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject