次の方法で共有


Set-CMCollectionCloudSync

デバイスまたはユーザー コレクションのグループをMicrosoft Entraするようにコレクション メンバーシップの同期を構成します。 詳細については、「コレクション メンバーを Microsoft Entra グループに同期する方法」を参照してください。

構文

SetByValue (既定)

Set-CMCollectionCloudSync
    -InputObject <IResultObject#SMS_Collection>
    [-AddGroupName <string[]>]
    [-EnableAssignEndpointSecurityPolicy <bool>]
    [-RemoveGroupName <string[]>]
    [-TenantId <string>]
    [-TenantName <string>]
    [-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetById

Set-CMCollectionCloudSync
    -Id <string>
    [-AddGroupName <string[]>]
    [-EnableAssignEndpointSecurityPolicy <bool>]
    [-RemoveGroupName <string[]>]
    [-TenantId <string>]
    [-TenantName <string>]
    [-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByName

Set-CMCollectionCloudSync
    -Name <string>
    [-AddGroupName <string[]>]
    [-EnableAssignEndpointSecurityPolicy <bool>]
    [-RemoveGroupName <string[]>]
    [-TenantId <string>]
    [-TenantName <string>]
    [-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

このコマンドレットを使用して、デバイスまたはユーザー コレクションのグループをMicrosoft Entraするようにコレクション メンバーシップの同期を構成します。

注:

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

例 1: コレクションがメンバーをグループに同期Microsoft Entra有効にする

最初のコマンドは 、testUserCollection という名前のコレクション オブジェクトを取得し、 $userCollection 変数に格納します。 2 番目のコマンドは、contoso という名前のMicrosoft Entra テナントを取得し、$AADTenant変数に格納します。 3 番目のコマンドでは、テナント名 "contoso" に属する testUserGroup という名前のMicrosoft Entra グループとのコレクションの同期を有効にします。

$userCollection = Get-CMCollection -Name "testUserCollection"
$AADTenant = Get-CMAADTenant -Name "contoso"
Set-CMCollectionCloudSync -InputObject $userCollection -AddGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantObject $AADTenant

例 2: Microsoft Entra グループとのコレクション同期を削除する

最初のコマンドは 、testUserCollection という名前のコレクション オブジェクトを取得し、 $userCollection 変数に格納します。 2 番目のコマンドは、テナント名 "contoso" に属する testUserGroup という名前のMicrosoft Entra グループとのコレクションの同期を削除します。これは、-TenantName パラメーターの値として渡されます。 または、-TenantId パラメーターを使用することもできます。

$userCollection = Get-CMCollection -Name "testUserCollection"
Set-CMCollectionCloudSync -InputObject $userCollection -RemoveGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantName "contoso"

パラメーター

-AddGroupName

コレクションのメンバーを同期する必要があるターゲット Microsoft Entraグループ名を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DisableWildcardHandling

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EnableAssignEndpointSecurityPolicy

このパラメーターを使用して、テナント接続シナリオでエンドポイント セキュリティ ポリシー Intune割り当てるために、コレクションを有効または無効にしてポータルに表示します。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Id

構成するコレクションの ID を指定します。 この値は CollectionID プロパティです (たとえば、 XYZ00012)。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetById
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-InputObject

構成するコレクション オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollectionGet-CMDeviceCollection、または Get-CMUserCollection コマンドレットを 使用します。

パラメーターのプロパティ

型:IResultObject
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:コレクション

パラメーター セット

SetByValue
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

構成するコレクションの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetByName
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RemoveGroupName

指定したMicrosoft Entra グループとの同期を削除するには、このパラメーターを使用します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TenantId

Microsoft Entra テナントの ID を指定します。 この値は TenantId プロパティです (たとえば、 aaaabbbb-0000-cccc-1111-dddd2222eeee)。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TenantName

contosoなど、Microsoft Entra テナントの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TenantObject

Microsoft Entra テナントのオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMAADTenant コマンドレットを 使用します。

パラメーターのプロパティ

型:IResultObject
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object