Dela via

New-SCADConnector

  • Referens
Modul:
System.Center.Service.Manager

Skapar en ny Service Manager Active Directory-anslutning.

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-anslutning.

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

  • 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 frågar efter 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 att synkronisera 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ödeskonto och lagrar det sedan i variabeln $RunAsAccount.

Det andra kommandot frågar efter 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 den här cmdleten ansluter till domänkontrollanten.

Typ:System.Management.Automation.PSCredential
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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*)

Typ:System.String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ComputerName

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

Typ:System.String[]
Position:Named
Standardvärde:Localhost
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

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

Typ:System.Management.Automation.SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger de autentiseringsuppgifter som den här cmdleten 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.

Typ:System.Management.Automation.PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Anger en beskrivning av anslutningsappen.

Typ:System.String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Anger visningsnamnegenskapen för anslutningsappen.

Typ:System.String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Enable

Anger om den här cmdleten aktiverar eller inaktiverar anslutningsappen.

Typ:System.Boolean
Position:Named
Standardvärde:True
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExpandGroups

Anger att den här cmdleten rekursivt innehåller medlemmar i de grupper som anges av parametern UserFilter.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Anger att den här cmdleten returnerar den Active Directory-anslutningsapp som den skapar. Du kan skicka det här objektet till andra cmdletar.

Typ:System.Management.Automation.SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PrinterFilter

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

Typ:System.String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-QueryRoot

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

Typ:System.String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RunAsAccount

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

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference
Position:3
Standardvärde:Operational System Account
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ScheduleDay

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

  • Daglig
  • Söndag
  • Måndag
  • Tisdag
  • Onsdag
  • Torsdag
  • Fredag
  • Lördag
Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule
Godkända värden:Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Standardvärde:Daily
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ScheduleHour

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

Typ:System.Int32
Position:Named
Standardvärde:2
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SCSession

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

Typ:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SyncNow

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

Typ:System.Management.Automation.SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 synkroniseringsanvändare vars givenName- börjar med a:

(givenname=a*)

Typ:System.String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:System.Management.Automation.SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None.

Du kan inte skicka indata till den här cmdleten.

Utdata

None.

Den här cmdleten genererar inga utdata.