New-SCADConnector
Cria um novo conector do Ative Directory do Service Manager.
Sintaxe
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
O cmdlet New-SCADConnector cria um conector do Ative Directory do Service Manager.
Os parâmetros a seguir só estarão disponíveis se você tiver aplicado o Service Manager 2012 R2 Update Rollup 6 ou versões posteriores.
- ScheduleDay
- HorárioHorário
Exemplos
Exemplo 1: Criar um conector para o domínio local
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 3O primeiro comando obtém uma conta Run As para Conta de Fluxo de Trabalho usando o cmdlet Get-SCSMRunAsAccount. O comando armazena o resultado na variável $RunAsAccount.
O segundo comando solicita credenciais usando o cmdlet Get-Credential e, em seguida, armazena as credenciais na variável $Credential.
O comando final cria um conector do Ative Directory para o domínio local, que recupera todos os computadores, impressoras, usuários e grupos de usuários. O conector está configurado para sincronizar todos os domingos às 3:00 da manhã.
Exemplo 2: Criar um conector para o domínio local que inclua um filtro de usuário
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*)"O primeiro comando obtém uma conta Run As para Conta de Fluxo de Trabalho e, em seguida, armazena-a na variável $RunAsAccount.
O segundo comando solicita credenciais usando o cmdlet Get-Credential e, em seguida, armazena as credenciais na variável $Credential.
O comando final cria um conector do Ative Directory para o domínio local que recupera apenas as contas de usuário que começam com a letra E.
Parâmetros
-ADCredential
Especifica a credencial a ser usada quando esse cmdlet se conecta ao controlador de domínio.
| Tipo: | System.Management.Automation.PSCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ComputerFilter
Especifica um filtro que seleciona os computadores que o conector sincroniza.
O filtro deve ser especificado como um filtro do Ative Directory.
Por exemplo, o filtro a seguir inclui todos os computadores que começam com win na sincronização:
(name=win*)
| Tipo: | System.String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ComputerName
Especifica o nome do computador no qual o serviço de Acesso a Dados do System Center é executado. A conta de usuário especificada no parâmetro Credential deve ter direitos de acesso ao computador especificado.
| Tipo: | System.String[] |
| Position: | Named |
| Default value: | Localhost |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
| Tipo: | System.Management.Automation.SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Credential
Especifica as credenciais que esse cmdlet usa para se conectar ao servidor no qual o serviço de Acesso a Dados do System Center é executado. A conta de usuário especificada deve ter direitos de acesso a esse servidor.
| Tipo: | System.Management.Automation.PSCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Description
Especifica uma descrição para o conector.
| Tipo: | System.String |
| Position: | 1 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DisplayName
Especifica a propriedade de nome para exibição do conector.
| Tipo: | System.String |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Enable
Indica se esse cmdlet habilita ou desabilita o conector.
| Tipo: | System.Boolean |
| Position: | Named |
| Default value: | True |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ExpandGroups
Especifica que esse cmdlet inclui recursivamente membros dos grupos especificados pelo parâmetro UserFilter.
| Tipo: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-PassThru
Indica que esse cmdlet retorna o conector do Ative Directory que ele cria. Você pode passar esse objeto para outros cmdlets.
| Tipo: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-PrinterFilter
Especifica um filtro que esse cmdlet usa para selecionar as impressoras sincronizadas pelo conector.
| Tipo: | System.String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-QueryRoot
Especifica a pasta do Ative Directory a partir da qual este cmdlet consulta objetos, como LDAP://DC=scsm,DC=stbtest,DC=microsoft,DC=com.
| Tipo: | System.String |
| Position: | 2 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RunAsAccount
Especifica a conta RunAs a ser usada ao usar esse conector.
| Tipo: | Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference |
| Position: | 3 |
| Default value: | Operational System Account |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ScheduleDay
Especifica o dia da semana em que o conector é sincronizado. Os valores válidos são:
- Diariamente
- Domingo
- Segunda-feira
- Terça-feira
- Quarta-feira
- Quinta-feira
- Sexta-feira
- Sábado
| Tipo: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule |
| Valores aceites: | Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Default value: | Daily |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ScheduleHour
Especifica a hora em que o conector inicia a sincronização. O valor deve ser um número de zero (0) a 23.
| Tipo: | System.Int32 |
| Position: | Named |
| Default value: | 2 |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-SCSession
Especifica um objeto que representa a sessão para um servidor de gerenciamento do Service Manager.
| Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-SyncNow
Faz com que o conector do Ative Directory inicie um ciclo de sincronização.
| Tipo: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UserFilter
Especifica o filtro usado para selecionar os usuários sincronizados pelo conector.
Você deve especificar o valor na forma de um filtro do Ative Directory.
Por exemplo, o seguinte valor para esse parâmetro inclui na sincronização usuários cuja givenName começa com a:
(givenname=a*)
| Tipo: | System.String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | System.Management.Automation.SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
Entradas
None.
Não é possível canalizar a entrada para este cmdlet.
Saídas
None.
Este cmdlet não gera nenhuma saída.