Get-CMSiteRole

  • リファレンス
モジュール:
ConfigurationManager

サイト ロール オブジェクトを取得します。

構文

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

説明

Configuration Manager サイト システム サーバーにインストールされているロールを返します。 たとえば、管理ポイントや配布ポイントなどです。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 1: すべてのサイトからすべてのロールを取得する

この例では、階層内のすべてのサイトのすべてのロールを取得します。

Get-CMSiteRole -AllSite

例 2: 特定のサイトのすべてのロールを取得する

この例では、サイト P01 からすべてのロールを取得します。

Get-CMSiteRole -SiteCode P01

例 3: 特定のサーバーのロールを取得する

この例では、サイト システム cm01.contoso.local にインストールされているすべてのロールを取得します。

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

例 4: すべての管理ポイントをカウントする

この例では、階層内のすべての管理ポイントを取得し、カウントを表示します。

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

例 5: すべてのロールを名前で一覧表示する

この例では、階層内のすべてのサイトのロール名を一覧表示します。

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

パラメーター

-AllSite

サイトのすべてのロールを取得するには、このパラメーターを含めます。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 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

取得する特定のロール名を指定します。 値は、SMS_SCI_SysResUse クラスの RoleName プロパティの文字列です。 以下に例を示します。

  • 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

注:

この一覧には、考えられるすべてのサイト ロールが含まれているわけではありません。

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

-SiteCode

特定のサイト ロールのサイト コードを指定します。

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

-SiteSystemServerName

ロールを取得する特定のサイト システム サーバーの名前を指定します。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject[]

IResultObject