Set-CMCollectionCloudSync
構文
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 |
構成するコレクション オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection、 Get-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