Dela via


New-SCADConnector

Skapar en ny Service Manager Active Directory-anslutningsapp.

Syntax

New-SCADConnector
   [[-Description] <String>]
   [-Enable <Boolean>]
   [-DisplayName] <String>
   [[-QueryRoot] <String>]
   [-PassThru]
   [-ComputerFilter <String>]
   [-UserFilter <String>]
   [-PrinterFilter <String>]
   -ADCredential <PSCredential>
   [[-RunAsAccount] <ManagementPackSecureReference>]
   [-ScheduleDay <DaySchedule>]
   [-ScheduleHour <Int32>]
   [-SyncNow]
   [-ExpandGroups]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten New-SCADConnector skapar en Service Manager Active Directory-anslutningsapp.

Följande parametrar är endast tillgängliga om du har tillämpat Service Manager 2012 R2 Samlad uppdatering 6 eller senare versioner.

  • ScheduleDay
  • ScheduleHour

Exempel

Exempel 1: Skapa en anslutningsapp till den lokala domänen

PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -DisplayName "Workflow Account"
PS C:\> $Credential = Get-Credential
PS C:\> New-SCADConnector -DisplayName "Contoso AD Connector" -Description "Contoso AD Connector" -QueryRoot "LDAP://DC=Contoso,DC=com" -RunAsAccount $RunAsAccount -ADCredential $Credential -Enable $False -ScheduleDay Sunday -ScheduleHour 3

Det första kommandot hämtar ett Kör som-konto för arbetsflödeskontot med hjälp av cmdleten Get-SCSMRunAsAccount. Kommandot lagrar resultatet i variabeln $RunAsAccount.

Det andra kommandot uppmanar dig att ange autentiseringsuppgifter med hjälp av cmdleten Get-Credential och lagrar sedan autentiseringsuppgifterna i variabeln $Credential.

Det sista kommandot skapar en Active Directory-anslutning till den lokala domänen, som hämtar alla datorer, skrivare, användare och användargrupper. Anslutningsappen är konfigurerad för att synkroniseras varje söndag kl. 03:00

Exempel 2: Skapa en anslutningsapp till den lokala domänen som innehåller ett användarfilter

PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -DisplayName "Workflow Account"
PS C:\> $Credential = Get-Credential
PS C:\> New-SCADConnector -DisplayName "Contoso AD Connector" -Description "Contoso users starting with E" -QueryRoot "LDAP://DC=Contoso,DC=com" -RunAsAccount $RunAsAccount -ADCredential $Credential -Enable $False -UserFilter "(givenname=E*)"

Det första kommandot hämtar ett Kör som-konto för arbetsflödeskontot och lagrar det sedan i variabeln $RunAsAccount.

Det andra kommandot uppmanar dig att ange autentiseringsuppgifter med hjälp av cmdleten Get-Credential och lagrar sedan autentiseringsuppgifterna i variabeln $Credential.

Det sista kommandot skapar en Active Directory-anslutning till den lokala domänen som endast hämtar de användarkonton som börjar med bokstaven E.

Parametrar

-ADCredential

Anger vilka autentiseringsuppgifter som ska användas när denna cmdlet ansluter till domänkontrollanten.

Type:System.Management.Automation.PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ComputerFilter

Anger ett filter som väljer de datorer som anslutningsappen synkroniserar. Filtret måste anges som ett Active Directory-filter. Följande filter innehåller till exempel alla datorer som börjar med win i synkroniseringen:

(name=win*)

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

-ComputerName

Anger namnet på den dator där System Center Data Access-tjänsten körs. Det användarkonto som anges i parametern Autentiseringsuppgifter måste ha åtkomstbehörighet till den angivna datorn.

Type:System.String[]
Position:Named
Default value:Localhost
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Anger de autentiseringsuppgifter som denna cmdlet använder för att ansluta till servern där System Center Data Access-tjänsten körs. Det angivna användarkontot måste ha åtkomstbehörighet till den servern.

Type:System.Management.Automation.PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Anger en beskrivning av anslutningsappen.

Type:System.String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Anger egenskapen visningsnamn för anslutningsappen.

Type:System.String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Enable

Anger om denna cmdlet aktiverar eller inaktiverar anslutningsappen.

Type:System.Boolean
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpandGroups

Anger att denna cmdlet rekursivt innehåller medlemmar i de grupper som anges av parametern UserFilter .

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Anger att denna cmdlet returnerar active directory-anslutningsappen som den skapar. Du kan skicka det här objektet till andra cmdletar.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrinterFilter

Anger ett filter som den här cmdleten använder för att välja de skrivare som anslutningsappen synkroniserar.

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

-QueryRoot

Anger den Active Directory-mapp som denna cmdlet frågar efter objekt från, till exempel LDAP://DC=scsm,DC=stbtest,DC=microsoft,DC=com.

Type:System.String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsAccount

Anger det RunAs-konto som ska användas när du använder den här anslutningsappen.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference
Position:3
Default value:Operational System Account
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleDay

Anger den veckodag då anslutningsappen synkroniseras. Giltiga värden är:

  • Varje dag
  • Söndag
  • Måndag
  • Tisdag
  • Onsdag
  • Torsdag
  • Fredag
  • Lördag
Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule
Accepted values:Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Default value:Daily
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleHour

Anger den timme då anslutningsappen startar synkroniseringen. Värdet måste vara ett tal från noll (0) till 23.

Type:System.Int32
Position:Named
Default value:2
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Anger ett objekt som representerar sessionen till en Service Manager hanteringsserver.

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SyncNow

Gör att Active Directory-anslutningsappen startar en synkroniseringscykel.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserFilter

Anger det filter som används för att välja användare till genom att synkroniseras med anslutningsappen. Du måste ange värdet i form av ett Active Directory-filter. Följande värde för den här parametern inkluderar till exempel i de synkroniseringsanvändare vars givenName börjar med a:

(givenname=a*)

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

None.

Du kan inte skicka indata till denna cmdlet.

Utdata

None.

Denna cmdlet genererar inga utdata.