Freigeben über


New-CMCloudManagementAzureService

Erstellen Sie den Azure-Dienst für die Cloudverwaltung in Configuration Manager.

Syntax

New-CMCloudManagementAzureService
   [-AddGroupName <String[]>]
   [-AzureEnvironmentOption <AzureEnvironment>]
   -ClientApp <IResultObject>
   [-Description <String>]
   [-EnableGroupDeltaDiscovery <Boolean>]
   [-EnableGroupDiscovery <Boolean>]
   [-EnableUserDeltaDiscovery <Boolean>]
   [-EnableUserDiscovery <Boolean>]
   [-GroupDeltaDiscoveryMins <Int32>]
   [-GroupDiscoverySchedule <IResultObject>]
   -Name <String>
   -ServerApp <IResultObject>
   [-UserDeltaDiscoveryMins <Int32>]
   [-UserDiscoverySchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um den Azure-Dienst in Configuration Manager for Cloud Management zu erstellen.

Weitere Informationen zur Verwendung dieses Cmdlets zum Erstellen eines Cloudverwaltungsgateways (CMG) finden Sie in den Versionshinweisen 2010: Cloudverwaltungsgateway.

Weitere Informationen zum Cloud Management-Dienst finden Sie unter CMG Overview.

Beispiele

Beispiel 1

In diesem Beispiel werden zunächst die zuvor importierten Server- und Client-Apps mithilfe des Cmdlets Get-CMAADApplication abgerufen. Anschließend wird der Dienst am Standort für die globale Azure-Cloud erstellt.

$serverApp = Get-CMAADApplication -TenantName "Contoso" -AppType ServerApplication -AppName "CmgServerApp"

$clientApp = Get-CMAADApplication -TenantName "Contoso" -AppType ClientApplication -AppName "CmgClientApp"

New-CMCloudManagementAzureService -Name "Contoso" -Description "Azure Service" -ServerApp $serverApp -ClientApp $clientApp -AzureEnvironmentOption AzurePublicCloud

Parameter

-AddGroupName

Geben Sie einen Microsoft Entra-Gruppennamen an, der ermittelt werden soll. Verwenden Sie diesen Parameter mit dem Parameter EnableGroupDiscovery .

Typ:String[]
Aliase:AddGroupNames
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AzureEnvironmentOption

Geben Sie an, ob sich dieser Dienst in der globalen Azure-Cloud (AzurePublicCloud) oder in der Azure Government-Cloud (AzureUSGovernmentCloud) befindet.

Typ:AzureEnvironment
Zulässige Werte:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClientApp

Geben Sie ein Objekt für die Client-App-Registrierung an. Verwenden Sie zum Abrufen dieser App das Cmdlet Get-CMAADApplication .

Typ:IResultObject
Aliase:ClientApplication, NativeClientApplication
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Geben Sie eine optionale Beschreibung für den Dienst an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableGroupDeltaDiscovery

Legen Sie diesen Parameter auf fest true , um die Deltaermittlung für die Microsoft Entra-Gruppenermittlung zu aktivieren. Verwenden Sie diesen Parameter mit dem Parameter EnableGroupDiscovery . Verwenden Sie den Parameter GroupDeltaDiscoveryMins , um das Deltaermittlungsintervall zu konfigurieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableGroupDiscovery

Legen Sie diesen Parameter auf fest true , um die Microsoft Entra-Gruppenermittlung zu aktivieren. Wenn Sie diese Ermittlungsmethode aktivieren, konfigurieren Sie auch die folgenden Parameter:

  • AddGroupName: Hinzufügen von Microsoft Entra-Gruppen zur Ermittlung
  • EnableGroupDeltaDiscovery: Konfigurieren der Deltaermittlung
  • GroupDeltaDiscoveryMins: Delta-Ermittlungsintervall
  • GroupDiscoverySchedule: Vollständiger Abrufzeitplan

Weitere Informationen zu dieser Ermittlungsmethode finden Sie unter Microsoft Entra-Benutzergruppenermittlung.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableUserDeltaDiscovery

Legen Sie diesen Parameter auf fest true , um die Deltaermittlung für die Microsoft Entra-Benutzerermittlung zu aktivieren. Verwenden Sie diesen Parameter mit dem Parameter EnableUserDiscovery .

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableUserDiscovery

Legen Sie diesen Parameter auf fest true , um die Microsoft Entra-Benutzerermittlung zu aktivieren. Wenn Sie diese Ermittlungsmethode aktivieren, konfigurieren Sie auch die folgenden Parameter:

  • EnableUserDeltaDiscovery: Konfigurieren der Deltaermittlung
  • UserDeltaDiscoveryMins: Delta-Ermittlungsintervall
  • UserDiscoverySchedule: Vollständiger Abrufzeitplan

Weitere Informationen zu dieser Ermittlungsmethode finden Sie unter Microsoft Entra-Benutzerermittlung.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GroupDeltaDiscoveryMins

Wenn Sie die Deltaermittlung für die Microsoft Entra-Gruppenermittlung mit dem Parameter EnableGroupDeltaDiscovery aktivieren, verwenden Sie diesen Parameter, um das Deltaermittlungsintervall zu konfigurieren. Der von Ihnen angegebene ganzzahlige Wert ist das Abrufintervall in Minuten.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GroupDiscoverySchedule

Geben Sie ein Zeitplanobjekt für den vollständigen Abrufzeitplan der Microsoft Entra-Gruppenermittlung an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet New-CMSchedule .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie einen Namen an, um den Cloudverwaltungsdienst in Configuration Manager zu unterscheiden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServerApp

Geben Sie ein Objekt für die Server-App-Registrierung an. Verwenden Sie zum Abrufen dieser App das Cmdlet Get-CMAADApplication .

Typ:IResultObject
Aliase:WebApp, WebApplication, ServerApplication
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserDeltaDiscoveryMins

Wenn Sie die Deltaermittlung für die Microsoft Entra-Benutzerermittlung mit dem Parameter EnableUserDeltaDiscovery aktivieren, verwenden Sie diesen Parameter, um das Deltaermittlungsintervall zu konfigurieren. Der von Ihnen angegebene ganzzahlige Wert ist das Abrufintervall in Minuten.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserDiscoverySchedule

Geben Sie ein Zeitplanobjekt für den vollständigen Abrufzeitplan für die Microsoft Entra-Benutzerermittlung an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet New-CMSchedule .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject

Hinweise

Sie können die Microsoft Entra-Gruppensynchronisierung nicht aktivieren, wenn Sie den Dienst erstellen. Verwenden Sie zum Aktivieren der Gruppensynchronisierung das Cmdlet Set-CMCloudManagementAzureService mit dem Parameter EnableAADGroupSync .