Condividi tramite

Get-CMSiteRole

  • Riferimento
Modulo:
ConfigurationManager

Ottenere un oggetto ruolo del sito.

Sintassi

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

Descrizione

Restituisce i ruoli installati in un server di sistema del sito di Configuration Manager. Ad esempio, un punto di gestione o un punto di distribuzione.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Ottenere tutti i ruoli da tutti i siti

In questo esempio vengono ottenuti tutti i ruoli per tutti i siti nella gerarchia.

Get-CMSiteRole -AllSite

Esempio 2: Ottenere tutti i ruoli per un sito specifico

In questo esempio vengono ottenuti tutti i ruoli dal sito P01.

Get-CMSiteRole -SiteCode P01

Esempio 3: Ottenere ruoli per un server specifico

Questo esempio ottiene tutti i ruoli installati nel sistema del sito cm01.contoso.local.

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

Esempio 4: Contare tutti i punti di gestione

In questo esempio vengono ottenuti tutti i punti di gestione nella gerarchia e viene visualizzato il conteggio.

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

Esempio 5: Elencare tutti i ruoli per nome

In questo esempio vengono elencati i nomi dei ruoli per tutti i siti nella gerarchia.

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

Parametri

-AllSite

Includere questo parametro per ottenere tutti i ruoli per il sito.

Tipo:SwitchParameter
Alias:AllSites
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RoleName

Specificare un nome di ruolo specifico da ottenere. Il valore è la stringa della proprietà RoleName nella classe SMS_SCI_SysResUse . Ad esempio:

  • 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

Questo elenco potrebbe non includere tutti i possibili ruoli del sito.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-SiteCode

Specificare il codice del sito per il ruolo del sito specifico.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SiteSystemServerName

Specificare il nome di un server del sistema del sito specifico da cui ottenere il ruolo.

Tipo:String
Alias:Name, ServerName
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject[]

IResultObject